Командлет Get-User используется для получения всех пользователей в лесу, которые соответствуют указанным условиям.

Синтаксис

get-User [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-User [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-User [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Параметры

Параметр Обязательный Тип Описание

Anr

Необязательный

System.String

Параметр Anr указывает, что аргумент будет разрешен с помощью процедуры разрешения неоднозначных имен.

Credential

Необязательный

System.Management.Automation.PSCredential

Параметр Credential задает учетную запись, которая используется для чтения службы каталогов Active Directory.

DomainController

Необязательный

Microsoft.Exchange.Data.Fqdn

Чтобы указать полное доменное имя контроллера домена, который извлекает данные из службы каталогов Active Directory, включите в команду параметр DomainController.

Filter

Необязательный

System.String

Параметр Filter задает набор атрибутов, которые ограничивают получателей, возвращаемых по запросу.

Дополнительные сведения о фильтруемых свойствах см. в разделе Фильтруемые свойства для параметра -Filter.

Identity

Необязательный

Microsoft.Exchange.Configuration.Tasks.UserIdParameter

Параметр Identity принимает одно из следующих значений:

  • GUID

  • Различающееся имя (DN)

  • Домен\Учетная запись

  • Имя участника-пользователя

  • Различающееся имя в прежнем формате Exchange

  • SMTP-адрес

  • Псевдоним

IgnoreDefaultScope

Необязательный

System.Management.Automation.SwitchParameter

Параметр IgnoreDefaultScope указывает, что при выполнении команды параметр, определяющий для командной консоли Exchange область получателя по умолчанию, должен быть проигнорирован, и задает в качестве области действия весь лес. Это обеспечивает команде доступ к объектам Active Directory, которые в текущий момент не относятся к области по умолчанию. При использовании параметра IgnoreDefaultScope действуют ограничения, описанные ниже.

  • Использовать параметр DomainController нельзя. Команда автоматически будет использовать подходящий сервер глобального каталога.

  • В качестве значения параметра Identity можно использовать только различающееся имя. Другие формы идентификации, например с помощью псевдонима или идентификатора GUID, не допускаются.

  • Параметры OrganizationalUnit и Identity нельзя использовать вместе.

  • Параметр Credential использовать нельзя.

OrganizationalUnit

Необязательный

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Параметр OrganizationalUnit возвращает объекты только из указанного подразделения.

ReadFromDomainController

Необязательный

System.Management.Automation.SwitchParameter

Параметр ReadFromDomainController указывает, что данные пользователя считываются из контроллера домена в домене пользователя. Если для области получателя заданы все получатели в лесу, и если этот параметр не используется, данные пользователя могут считываться из глобального каталога с устаревшей информацией. При использовании этого параметра для получения данных может потребоваться несколько операций чтения.

Примечание.
По умолчанию область получателей устанавливается равной домену, в котором размещаются серверы Exchange.

RecipientTypeDetails

Необязательный

Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[]

Параметр RecipientTypeDetails определяет тип возвращаемых получателей. Типы получателей в Microsoft Exchange Server 2007 разделены на типы и подтипы. Каждый тип получателей содержит все общие свойства всех подтипов. Например, тип UserMailbox представляет учетную запись пользователя в Active Directory со связанным почтовым ящиком. Поскольку имеется несколько типов почтовых ящиков, каждый тип определяется параметром RecipientTypeDetails. Например, для почтового ящика конференц-зала для параметра RecipientTypeDetails установлено значение ConferenceRoomMailbox, в то время как для почтового ящика пользователя для параметра RecipientTypeDetails установлено значение UserMailbox.

Сведения о доступных типах получателей для этого параметра:

  • ConferenceRoomMailbox

  • DisabledUser

  • EquipmentMailbox

  • LegacyMailbox

  • LinkedMailbox

  • UserMailbox

  • MailUser

  • User

ResultSize

Необязательный

Microsoft.Exchange.Data.Unlimited

Параметр ResultSize задает максимальное число возвращаемых результатов.

Sortby

Необязательный

System.String

Параметр SortBy используется для сортировки по одному атрибуту в порядке возрастания.

Подробное описание

Никакие параметры не являются обязательными. Однако в команде Get-User может использоваться не более одного из следующих параметров: Identity, Filter или Anr.

Для выполнения командлета Get-User используемой учетной записи необходимо делегировать следующую роль:

  • роль администратора Exchange с правами на просмотр.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.

Типы входных данных

Типы возвращаемых данных

Ошибки

Ошибка Описание

 

 

Исключения

Исключения Описание

 

 

Пример

В первом примере загружаются сведения о пользователях в подразделении «Marketing» (Маркетинг).

Во втором примере используется параметр Filter для получения сведений обо всех пользователях, в конце должности которых указано слово «Manager» (Менеджер).

Копировать код 
Get-User -OrganizationalUnit "Marketing"
Get-User -Filter {Title -like '*Manager'}

Можно использовать любой атрибут пользователя Active Directory для создания строки фильтра для параметра Filter в командлете Get-User. Дополнительные сведения об операторах сравнения, которые можно использовать в строке фильтра, см. в разделе Операторы сравнения.