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

Get-Contact

  • Статья

 

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

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

Используйте командлет Get-Contact, чтобы извлечь сведения для указанного контакта или контактов.

Синтаксис

Get-Contact [-Identity <ContactIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Get-Contact [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Get-Contact [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

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

Командлет Get-Contact запрашивает свойства определенных контактов или объектов получателей контактов в службе каталогов Active Directory.

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

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

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

Параметры

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

Anr

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

System.String

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

Credential

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

System.Management.Automation.PSCredential

Параметр Credential указывает учетную запись, используемую для запроса учетных данных контакта в Active Directory.

DomainController

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

Microsoft.Exchange.Data.Fqdn

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

Filter

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

System.String

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

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

Identity

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

Microsoft.Exchange.Configuration.Tasks.ContactIdParameter

У параметра Identity могут быть следующие значения:

  • идентификатор GUID

  • Различающееся имя (DN)

  • домен\имя_учетной_записи

  • имя участника-пользователя (UPN)

  • имя LegacyExchangeDN

  • SMTP-адрес;

  • Псевдоним

IgnoreDefaultScope

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

System.Management.Automation.SwitchParameter

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

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

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

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

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

OrganizationalUnit

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

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Параметр OrganizationalUnit возвращает объекты только из указанного подразделения (OU).

ReadFromDomainController

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

System.Management.Automation.SwitchParameter

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

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

RecipientTypeDetails

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

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

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

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

  • Contact

  • MailEnabledContact

  • MailEnabledForestContact

ResultSize

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

Microsoft.Exchange.Data.Unlimited

Параметр ResultSize указывает максимальное число возвращаемых результатов.

SortBy

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

System.String

Параметр SortBy указывает сортировку по одному атрибуту в порядке возрастания.

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

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

Ошибки

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

 

 

Исключения

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

 

Пример

В этом примере команда Get-Contact извлекает контакт для пользователя по имени Тед Бремер (Ted Bremer) и передает этот объект по конвейеру команде Format-List для отображения сведений об этом контакте.

Get-Contact -Identity TedBremer | Format-List