Применимо к: Exchange Server 2010 SP1

Последнее изменение раздела: 2011-03-19

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

Синтаксис

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

Параметры

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

Anr

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

System.String

Параметр Anr определяет строку, по которой будет выполнен поиск с разрешением неоднозначных имен (ANR). Можно задать частичное строковое значение и выполнить поиск объектов с атрибутом, который совпадает с этой строкой. По умолчанию искомыми атрибутами являются:

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • Alias

Credential

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

System.Management.Automation.PSCredential

Этот параметр Credential указывает имя пользователя и пароль для получения доступа к Служба каталогов Active Directory.

DomainController

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

Microsoft.Exchange.Data.Fqdn

Filter

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

System.String

Параметр Filter указывает фильтр OPath, используемый для фильтрации получателей.

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

Identity

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

Microsoft.Exchange.Configuration.Tasks.ContactIdParameter

Параметр Identity указывает контакт. Ниже приведены значения, которые можно использовать.

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

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

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

  • Основное имя пользователя

  • имя LegacyExchangeDN

  • SMTP-адрес

  • псевдоним

IgnoreDefaultScope

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

System.Management.Automation.SwitchParameter

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

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

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

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

Organization

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

Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter

OrganizationalUnit

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

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

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

ReadFromDomainController

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

System.Management.Automation.SwitchParameter

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

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

RecipientTypeDetails

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

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

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

Ниже перечислены доступные значения.

  • ArbitrationMailbox

  • ConferenceRoomMailbox

  • Contact

  • DiscoveryMailbox

  • DynamicDistributionGroup

  • EquipmentMailbox

  • ExternalManagedContact

  • ExternalManagedDistributionGroup

  • LegacyMailbox

  • LinkedMailbox

  • MailboxPlan

  • MailContact

  • MailForestContact

  • MailNonUniversalGroup

  • MailUniversalDistributionGroup

  • MailUniversalSecurityGroup

  • MailUser

  • PublicFolder

  • RoleGroup

  • RoomList

  • RoomMailbox

  • SharedMailbox

  • SystemAttendantMailbox

  • SystemMailbox

  • User

  • UserMailbox

ResultSize

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

Microsoft.Exchange.Data.Unlimited

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

SortBy

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

System.String

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

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

Тема «Разрешения подготовки получателей» в разделе Разрешения для почтового ящика.

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

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

Ошибки

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

  

  

Исключения

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

  

 

Примеры

ПРИМЕР 1

В этом примере показано получение сведений о контакте Валерии Ушакове с помощью параметра Identity и передача объекта по конвейеру для команды Format-List, чтобы отобразить сведения о контакте.

Скопировать код
Get-Contact -Identity MarkusBreyer | Format-List

ПРИМЕР 2

В этом примере используется параметр Anr для получения всех контактов с включенной поддержкой почты, чьи имена начинаются с «Валерий».

Скопировать код
Get-Contact -Anr Markus* -RecipientTypeDetails MailContact