Командлет Get-MailContact используется для получения всех атрибутов указанного контакта из Active Directory.
Синтаксис
Get-MailContact [-Identity <MailContactIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>] |
Get-MailContact [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>] |
Get-MailContact [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>] |
Параметры
Параметр | Обязательный | Тип | Описание | ||
---|---|---|---|---|---|
ANR |
Необязательный |
System.String |
Указанный параметр разрешается методом разрешения неоднозначных имен (ANR). По умолчанию искомыми атрибутами являются:
|
||
Credential |
Необязательный |
System.Management.Automation.PSCredential |
Этот параметр определяет учетную запись, используемую для получения доступа к Active Directory. Если используется параметр Credential, для продолжения команда предлагает ввести пароль учетной записи. |
||
DomainController |
Необязательный |
Microsoft.Exchange.Data.Fqdn |
Чтобы указать полное доменное имя контроллера домена, который извлекает данные из службы каталогов Active Directory, включите в команду параметр DomainController. |
||
Filter |
Необязательный |
System.String |
Этот параметр используется для фильтрации возвращенного списка получателей. Можно указать атрибуты фильтрации. Дополнительные сведения о фильтруемых свойствах см. в разделе Фильтруемые свойства для параметра -Filter. |
||
Identity |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.MailContactIdParameter |
Этот параметр определяет контакт. Для контакта можно указать идентификатор ADObjectID, различающееся имя, различающееся имя прежней версии LegacyExchangeDN, идентификатор GUID, домен\SamAccountName, имя участника-пользователя (UPN), адрес электронной почты или псевдоним. |
||
OrganizationalUnit |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
Этот параметр определяет контейнер, чтобы ограничить получаемые результаты. Можно указать либо подразделение, либо домен. Кроме того, должно быть указано каноническое имя. Например:
|
||
ReadFromDomainController |
Необязательный |
System.Management.Automation.SwitchParameter |
Этот параметр указывает, что сведения о пользователе будут считываться из контроллера домена в домене пользователя. Если установлена область получателей для включения всех получателей в лесе, и этот параметр не используется, сведения о пользователе могут быть считаны с сервера глобального каталога с устаревшими сведениями. Если этот параметр используется, возможно, понадобится выполнить считывание несколько раз, чтобы получить сведения.
|
||
RecipientTypeDetails |
Необязательный |
Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[] |
Параметр RecipientTypeDetails указывает тип возвращаемых получателей. Типы получателей в Exchange 2007 разделены на типы и подтипы. Каждый тип получателя содержит все общие свойства всех подтипов. Например, тип UserMailbox представляет учетную запись пользователя в Active Directory со связанным почтовым ящиком. Так как имеется несколько типов почтовых ящиков, каждый тип идентифицирован с помощью параметра RecipientTypeDetails. Например, для почтового ящика конференц-зал для параметра RecipientTypeDetails установлено значение ConferenceRoomMailbox, в то время как для почтового ящика пользователя для параметра RecipientTypeDetails установлено значение UserMailbox. Для этого командлета доступны следующие детали типов получателей:
|
||
ResultSize |
Необязательный |
Microsoft.Exchange.Data.Unlimited |
Этот параметр определяет общее число возвращаемых объектов получателей. Если параметр не указан, возвращаются все результаты, соответствующие фильтру. |
||
SortBy |
Необязательный |
System.String |
Этот параметр указывает атрибут, используемый для сортировки результатов. Сортировка одновременно выполняется только по одному атрибуту и всегда в возрастающем порядке. |
||
IgnoreDefaultScope |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр IgnoreDefaultScope указывает, что при выполнении команды параметр, определяющий для командной консоли Exchange область получателя по умолчанию, должен быть проигнорирован, и задает в качестве области действия весь лес. Это обеспечивает команде доступ к объектам Active Directory, которые в текущий момент не относятся к области по умолчанию. При использовании параметра IgnoreDefaultScope действуют ограничения, описанные ниже.
|
Подробное описание
Этот командлет возвращает все атрибуты указанного контакта. Никакие параметры не являются обязательными. Если командлет выполняется без параметра, возвращается полный список контактов для организации Exchange.
Для выполнения командлета Get-MailContact используемой учетной записи необходимо делегировать следующую роль:
- роль администратора Exchange с правами на просмотр.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.
Типы входных данных
Типы возвращаемых данных
Ошибки
Ошибка | Описание |
---|---|
Исключения
Исключения | Описание |
---|---|
Пример
С этом примере команда Get-MailContact используется для возвращения контакта с именем Ted и включенной поддержкой почты.
Копировать код | |
---|---|
Get-MailContact -Identity Ted | Format-List |