Командлет 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 задает строковое значение, по которому выполняется поиск с целью разрешения неоднозначного имени. Можно указать частичное строковое значение и выполнить поиск объектов, имеющих атрибут, соответствующий этой строке. Атрибуты по умолчанию, по которым выполняется поиск:
|
||
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 действуют ограничения, описанные ниже.
|
||
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 получает все атрибуты почты для указанного пользователя.
Для выполнения командлета Get-MailUser используемой учетной записи необходимо делегировать следующую роль:
- роль администратора Exchange с правами на просмотр.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.
Примечание. |
---|
Командлетом Get-MailUser извлекаются не все атрибуты пользователя. Дополнительные атрибуты пользователя можно получить с помощью командлета Get-User. |
Типы входных данных
Типы возвращаемых данных
Ошибки
Ошибка | Описание |
---|---|
|
Исключения
Исключения | Описание |
---|---|
|
Пример
В первом примере команда Get-MailUser используется без параметров для извлечения полного списка пользователей с включенной почтой во всей организации Exchange.
Во втором примере параметры почты пользователя Ted извлекаются и затем направляются в командлет Format-List для отображения на экране.
Копировать код | |
---|---|
Get-MailUser Get-MailUser -Identity Ted | Format-List |