Используйте командлет 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>] |
Параметры
Параметр | Обязательный | Тип | Описание | ||
---|---|---|---|---|---|
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 могут быть следующие значения:
|
||
IgnoreDefaultScope |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр IgnoreDefaultScope указывает, что при выполнении команды параметр, определяющий область получателя по умолчанию для командной консоли Exchange, должен пропускаться, и задает в качестве области весь лес. Это обеспечивает команде доступ к объектам Active Directory, которые в текущий момент не относятся к области по умолчанию. При использовании параметра IgnoreDefaultScope действуют ограничения, описанные ниже.
|
||
OrganizationalUnit |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
Параметр OrganizationalUnit возвращает объекты только из указанного подразделения (OU). |
||
ReadFromDomainController |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр ReadFromDomainController определяет, что сведения о пользователе будут считываться из контроллера домена в домен пользователя. Если задана область получателя, включающая в себя всех получателей в лесу и если этот параметр не используется, сведения о пользователе могут быть считаны из глобального каталога, данные которого устарели. При использовании этого параметра для получения данных может потребоваться несколько сеансов считывания.
|
||
RecipientTypeDetails |
Необязательный |
Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[] |
Параметр RecipientTypeDetails указывает тип возвращаемых получателей. Типы получателей Microsoft Exchange Server 2007 подразделяются на типы и подтипы получателей. Каждый тип получателей содержит все общие свойства для всех подтипов. Например, тип UserMailbox представляет учетную запись пользователя в Active Directory со связанным почтовым ящиком. Поскольку существует несколько типов почтовых ящиков, каждый тип почтового ящика идентифицируется параметром RecipientTypeDetails. Например, для почтового ящика конференц-зал для параметра RecipientTypeDetails установлено значение ConferenceRoomMailbox, в то время как для почтового ящика пользователя для параметра RecipientTypeDetails установлено значение UserMailbox. Для этой команды возможны следующие значения типа получателей:
|
||
ResultSize |
Необязательный |
Microsoft.Exchange.Data.Unlimited |
Параметр ResultSize указывает максимальное число возвращаемых результатов. |
||
SortBy |
Необязательный |
System.String |
Параметр SortBy указывает сортировку по одному атрибуту в порядке возрастания. |
Подробное описание
Командлет Get-Contact запрашивает свойства определенных контактов или объектов получателей контактов в службе каталогов Active Directory.
Для выполнения командлета Get-Contact используемой учетной записи необходимо делегировать следующую роль:
- роль администратора Exchange с правами на просмотр.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.
Типы входных данных
Типы возвращаемых данных
Ошибки
Ошибка | Описание |
---|---|
|
|
Исключения
Исключения | Описание |
---|---|
|
Пример
В этом примере команда Get-Contact извлекает контакт для пользователя по имени Тед Бремер (Ted Bremer) и передает этот объект по конвейеру команде Format-List для отображения сведений об этом контакте.
Копировать код | |
---|---|
Get-Contact -Identity TedBremer | Format-List |