Командлет Get-MailUser используется для получения атрибутов почты указанного пользователя из службы каталогов Active Directory.

Синтаксис

get-MailUser [-Identity <MailUserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]
get-MailUser [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]
get-MailUser [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

Параметры

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

ANR

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

System.String

Параметр Anr задает строковое значение, по которому выполняется поиск с целью разрешения неоднозначного имени. Можно указать частичное строковое значение и выполнить поиск объектов, имеющих атрибут, соответствующий этой строке. Атрибуты по умолчанию, по которым выполняется поиск:

  • CommonName (CN)

  • DisplayName (displayName)

  • FirstName (givenName)

  • LastName (sn)

  • Alias (mailNickname)

Credential

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

System.Management.Automation.PSCredential

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

Если используется параметр Credential, команда запрашивает пароль учетной записи, прежде чем продолжить выполнение.

DomainController

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

Microsoft.Exchange.Data.Fqdn

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

Filter

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

System.String

Параметр Filter используется для фильтрации возвращаемого списка получателей. Можно указать атрибуты фильтра.

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

Identity

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

Microsoft.Exchange.Configuration.Tasks.MailUserIdParameter

Параметр Identity идентифицирует пользователя. Можно включить следующие параметры пользователя: ADObjectID, различающееся имя (DN), имя LegacyExchangeDN, GUID, Domain\SamAccountName, имя участника-пользователя, адрес электронной почты или псевдоним.

IgnoreDefaultScope

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

System.Management.Automation.SwitchParameter

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

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

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

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

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

OrganizationalUnit

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

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Параметр OrganizationalUnit определяет контейнер, чтобы ограничить получаемые результаты. Можно указать или подразделение, или домен. Следует указывать каноническое имя. Например,

  • Подразделение: westcoast.contoso.com/users

  • Домен: westcoast.contoso.com

ReadFromDomainController

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

System.Management.Automation.SwitchParameter

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

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

ResultSize

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

Microsoft.Exchange.Data.Unlimited

Параметр ResultSize указывает максимальное число возвращаемых объектов получателя. Если параметр не указан, возвращаются все результаты, соответствующие фильтру.

SortBy

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

System.String

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

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

Командлет Get-MailUser получает все атрибуты почты для указанного пользователя.

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

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

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

Примечание.
Командлетом Get-MailUser извлекаются не все атрибуты пользователя. Дополнительные атрибуты пользователя можно получить с помощью командлета Get-User.

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

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

Ошибки

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

 

Исключения

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

 

Пример

В первом примере команда Get-MailUser используется без параметров для извлечения полного списка пользователей с включенной почтой во всей организации Exchange.

Во втором примере параметры почты пользователя Ted извлекаются и затем направляются в командлет Format-List для отображения на экране.

Копировать код
Get-MailUser
Get-MailUser -Identity Ted | Format-List