Поделиться через


Командлет Get-MailUser (окончательная первоначальная версия)

 

Применимо к: Exchange Server 2007

Последнее изменение раздела: 2007-06-05

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

Синтаксис

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

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

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

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

importantВажно!
В Microsoft Exchange Server 2007 параметры пользователя с включенной почтой можно получить только с помощью командной консоли Exchange.

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

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

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

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

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

Параметры

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

ANR

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

System.String

Параметр Anr указывает строку, в которой проводится поиск разрешения неоднозначных имен (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

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

Filter

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

System.String

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

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

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

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

Microsoft.Exchange.Configuration.Tasks.MailUserIdParameter

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

OrganizationalUnit

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

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

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

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

ReadFromDomainController

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

System.Management.Automation.SwitchParameter

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

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

ResultSize

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

Microsoft.Exchange.Data.Unlimited

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

SortBy

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

System.String

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

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

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

Ошибки

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

 

Исключения

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

 

Пример

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

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

Get-MailUser
Get-MailUser -Identity Ted | Format-List