Применимо к: Exchange Server 2010 SP1
Последнее изменение раздела: 2011-04-22
Командлет Get-MailUser используется для получения атрибутов почты указанного пользователя из службы каталогов Служба каталогов Active Directory.
Синтаксис
get-MailUser [-Identity <MailUserIdParameter>]
[-Credential <PSCredential>] [-DomainController <Fqdn>]
[-Filter <String>] [-IgnoreDefaultScope
<SwitchParameter>] [-Organization
<OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-ReadFromDomainController
<SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy
<String>]
|
get-MailUser [-ArchiveDatabase
<DatabaseIdParameter>] [-Credential <PSCredential>]
[-DomainController <Fqdn>] [-Filter <String>]
[-IgnoreDefaultScope <SwitchParameter>] [-Organization
<OrganizationIdParameter>] [-OrganizationalUnit
<OrganizationalUnitIdParameter>] [-ReadFromDomainController
<SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy
<String>]
|
get-MailUser [-Anr <String>] [-Credential
<PSCredential>] [-DomainController <Fqdn>] [-Filter
<String>] [-IgnoreDefaultScope <SwitchParameter>]
[-Organization <OrganizationIdParameter>]
[-OrganizationalUnit <OrganizationalUnitIdParameter>]
[-ReadFromDomainController <SwitchParameter>] [-ResultSize
<Unlimited>] [-SortBy <String>]
|
Параметры
Параметр | Обязательный | Тип | Описание | ||
---|---|---|---|---|---|
Anr |
Необязательный |
System.String |
Параметр Anr определяет строку, по которой будет выполнен поиск с разрешением неоднозначных имен (ANR). Можно задать частичное строковое значение и выполнить поиск объектов с атрибутом, который совпадает с этой строкой. По умолчанию искомыми атрибутами являются:
|
||
ArchiveDatabase |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter |
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт. |
||
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.MailUserIdParameter |
Параметр 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 указывает, что сведения о пользователе будут считываться из контроллера домена в домене пользователя. Если установлена область получателей для включения всех получателей в лесу и этот параметр не используется, сведения о пользователе могут быть прочитаны из глобального каталога с устаревшими сведениями. Если этот параметр используется, возможно, понадобится выполнить считывание несколько раз, чтобы получить сведения.
|
||
ResultSize |
Необязательный |
Microsoft.Exchange.Data.Unlimited |
Параметр ResultSize указывает максимальное число возвращаемых объектов получателя. Если параметр не указан, возвращаются все результаты, соответствующие фильтру. |
||
SortBy |
Необязательный |
System.String |
Параметр SortBy указывает атрибут, используемый для сортировки результатов. Сортировка одновременно выполняется только по одному атрибуту и всегда в возрастающем порядке. |
Подробное описание
Командлет Get-MailUser получает все атрибуты почты для указанного пользователя.
Для запуска этого командлета необходимы соответствующие разрешения. В этом разделе перечислены все параметры командлета, однако некоторые из них могут быть недоступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях см. в разделе Подраздел «Разрешения подготовки получателей» в разделе Разрешения для почтового ящика.
Типы входных данных
Типы возвращаемых данных
Ошибки
Ошибка | Описание |
---|---|
|
|
Исключения
Исключения | Описание |
---|---|
|
|
Примеры
ПРИМЕР 1
В данном примере показано получение полного списка пользователей для всей организации Exchange, для которых включена поддержка электронной почты.
Скопировать код | |
---|---|
Get-MailUser |
ПРИМЕР 2
В данном примере показано получение параметров для пользователя электронной почты с именем Олег. Команда передается конвейерным образом в командлет Format-List для отображения.
Скопировать код | |
---|---|
Get-MailUser -Identity Ed | Format-List |