Применимо к: Exchange Server 2010 SP1
Последнее изменение раздела: 2011-04-21
Командлет Get-User используется для получения всех пользователей в лесу, которые соответствуют указанным условиям.
Синтаксис
get-User [-Identity <UserIdParameter>]
[-Arbitration <SwitchParameter>] [-Credential
<PSCredential>] [-DomainController <Fqdn>] [-Filter
<String>] [-IgnoreDefaultScope <SwitchParameter>]
[-Organization <OrganizationIdParameter>]
[-OrganizationalUnit <OrganizationalUnitIdParameter>]
[-ReadFromDomainController <SwitchParameter>]
[-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize
<Unlimited>] [-SortBy <String>]
|
get-User [-Anr <String>] [-Arbitration
<SwitchParameter>] [-Credential <PSCredential>]
[-DomainController <Fqdn>] [-Filter <String>]
[-IgnoreDefaultScope <SwitchParameter>] [-Organization
<OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-ReadFromDomainController
<SwitchParameter>] [-RecipientTypeDetails
<RecipientTypeDetails[]>] [-ResultSize <Unlimited>]
[-SortBy <String>]
|
Параметры
Параметр | Обязательный | Тип | Описание | ||
---|---|---|---|---|---|
Anr |
Необязательный |
System.String |
Параметр Anr определяет строку, по которой будет выполнен поиск с разрешением неоднозначных имен (ANR). Можно задать частичное строковое значение и выполнить поиск объектов с атрибутом, который совпадает с этой строкой. По умолчанию искомыми атрибутами являются:
|
||
Arbitration |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр Arbitration указывает на то, что почтовый ящик, для которого выполняется команда, является арбитражным. Арбитражные почтовые ящики используются для управления рабочим процессом утверждения. Например, арбитражные почтовые ящики используются для обработки управляемых получателей и утверждения членства в группе рассылки. |
||
Credential |
Необязательный |
System.Management.Automation.PSCredential |
Параметр Credential указывает учетную запись, используемую для чтения Служба каталогов Active Directory. Для этого параметра требуется создание и передача объекта учетных данных. Этот объект учетных данных создается с помощью командлета Get-Credential. Дополнительные сведения см. в разделе Get-Credential. |
||
DomainController |
Необязательный |
Microsoft.Exchange.Data.Fqdn |
Параметр DomainController указывает имя FQDN контроллера домена, получающего данные из Служба каталогов Active Directory. |
||
Filter |
Необязательный |
System.String |
Параметр Filter указывает фильтр OPath, используемый для фильтрации получателей. Дополнительные сведения о фильтруемых свойствах см. в разделе Фильтруемые свойства для параметра -Filter. |
||
Identity |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.UserIdParameter |
Параметр Identity указывает одно из следующих значений:
|
||
IgnoreDefaultScope |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр IgnoreDefaultScope указывает, что при выполнении команды необходимо игнорировать параметр, определяющий для сеанса командной консоли Exchange область получателя по умолчанию, и задает в качестве области действия весь лес. Это обеспечивает команде доступ к объектам Служба каталогов Active Directory, которые на текущий момент не относятся к области действия по умолчанию. Для параметра IgnoreDefaultScope действуют следующие ограничения.
|
||
Organization |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter |
Этот параметр доступен для развертываний с несколькими клиентами В случае локального развертывания он недоступен. Дополнительные сведения о развертывании с несколькими клиентами см. в разделе Multi-Tenant Support. Параметр Organization указывает организацию, в которой будет выполняться это действие. Этот параметр не допускает ввода подстановочных знаков, поэтому необходимо использовать точное название организации. |
||
OrganizationalUnit |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
Параметр OrganizationalUnit возвращает объекты только из указанного подразделения. |
||
ReadFromDomainController |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр ReadFromDomainController указывает, что сведения о пользователе будут считываться из контроллера домена в домене пользователя. Если установлена область получателей для включения всех получателей в лесу и этот параметр не используется, сведения о пользователе могут считываться из глобального каталога с устаревшими сведениями. Если этот параметр используется, возможно, понадобится выполнить считывание несколько раз, чтобы получить сведения.
|
||
RecipientTypeDetails |
Необязательный |
Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[] |
Параметр RecipientTypeDetails указывает тип возвращаемых получателей. Типы получателей разделены на типы и подтипы. Каждый тип получателя содержит все общие свойства всех подтипов. Например, тип UserMailbox представляет учетную запись пользователя в службе каталогов Служба каталогов Active Directory со связанным почтовым ящиком. Так как существует несколько типов почтовых ящиков, каждый тип почтовых ящиков определяется параметром RecipientTypeDetails. Например, для параметра RecipientTypeDetails почтового ящика конференц-зала установлено значение ConferenceRoomMailbox, в то время как для параметра RecipientTypeDetails почтового ящика пользователя задано значение UserMailbox. Можно использовать следующие значения:
|
||
ResultSize |
Необязательный |
Microsoft.Exchange.Data.Unlimited |
Параметр ResultSize указывает максимальное число возвращаемых результатов. |
||
Sortby |
Необязательный |
System.String |
Параметр SortBy указывает используемый для сортировки атрибут. Этот параметр используется для сортировки по одному атрибуту в порядке возрастания. |
Подробное описание
Для запуска этого командлета необходимы соответствующие разрешения. В этом разделе перечислены все параметры командлета, однако некоторые из них могут быть недоступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях см. в разделе Подраздел «Разрешения подготовки получателей» в разделе Разрешения для почтового ящика.
Типы входных данных
Типы возвращаемых данных
Ошибки
Ошибка | Описание |
---|---|
|
|
Исключения
Исключения | Описание |
---|---|
|
|
Примеры
ПРИМЕР 1
В этом примере загружаются сведения о пользователях в подразделении «Маркетинг».
Скопировать код | |
---|---|
Get-User -OrganizationalUnit "Marketing" |
ПРИМЕР 2
В этом примере используется параметр Filter для получения сведений обо всех пользователях, в должности которых указано слово «менеджер».
Скопировать код | |
---|---|
Get-User -Filter "Title -like '*Manager'" |