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

Синтаксис

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

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

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

Параметры

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

Anr

Дополнительно

System.String

Параметр Anr указывает, что аргумент будет разрешен при помощи разрешения неоднозначных имен (ANR).

Credential

Дополнительно

System.Management.Automation.PSCredential

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

DomainController

Дополнительно

Microsoft.Exchange.Data.Fqdn

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

Filter

Дополнительно

System.String

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

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

Идентификатор

Дополнительно

Microsoft.Exchange.Configuration.Tasks.UserIdParameter

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

  • GUID;

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

  • Domain\Account

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

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

  • SMTP-адрес

  • псевдоним.

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. Для получения дополнительных сведений об операторах сравнения, которые можно использовать в строке фильтра, обратитесь к разделу Операторы сравнения.