Get-MailContact

  • Статья

 

Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Последнее изменение раздела: 2010-04-27

Командлет 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>]

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

Этот командлет возвращает все атрибуты указанного контакта. Никакие параметры не являются обязательными. Если командлет выполняется без параметра, возвращается полный список контактов для организации Exchange.

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

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

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

Параметры

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

ANR

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

System.String

Указанный параметр разрешается методом разрешения неоднозначных имен (ANR). По умолчанию искомыми атрибутами являются:

  • CommonName (CN)

  • DisplayName (displayName)

  • FirstName (givenName)

  • LastName (sn)

  • Alias (mailNickname)

  • LegacyExchangeDN (legacyExchangeDN)

  • Name (name) (instead of CommonName/CN)

  • EmailAddresses (proxyAddresses)

  • SamAccountName (samAccountName)

  • Office (physicalDeliveryOfficeName)

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

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

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

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

ReadFromDomainController

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

System.Management.Automation.SwitchParameter

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

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

RecipientTypeDetails

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

Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[]

Параметр RecipientTypeDetails указывает тип возвращаемых получателей. Типы получателей в Exchange 2007 разделены на типы и подтипы. Каждый тип получателя содержит все общие свойства всех подтипов. Например, тип UserMailbox представляет учетную запись пользователя в Active Directory со связанным почтовым ящиком. Так как имеется несколько типов почтовых ящиков, каждый тип идентифицирован с помощью параметра RecipientTypeDetails. Например, для почтового ящика конференц-зал для параметра RecipientTypeDetails установлено значение ConferenceRoomMailbox, в то время как для почтового ящика пользователя для параметра RecipientTypeDetails установлено значение UserMailbox.

Для этого командлета доступны следующие детали типов получателей:

  • MailEnabledContact

  • MailEnabledForestContact

ResultSize

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

Microsoft.Exchange.Data.Unlimited

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

SortBy

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

System.String

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

IgnoreDefaultScope

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

System.Management.Automation.SwitchParameter

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

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

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

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

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

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

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

Ошибки

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

Исключения

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

Пример

С этом примере команда Get-MailContact используется для возвращения контакта с именем Ted и включенной поддержкой почты.

Get-MailContact -Identity Ted | Format-List