Get-CsExUmContact

Skype for Business Server 2015
 

Дата изменения раздела:2017-05-22

Запрашивает один или несколько размещенных контактных объектов обмена сообщениями Exchange. Данный командлет впервые появился в Lync Server 2010.

Get-CsExUmContact [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-LdapFilter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]

В данном примере извлекаются все контакты единой системы обмена сообщениями Exchange, которые определены в развертывании Skype для бизнеса Server 2015.

Get-CsExUmContact

В этом примере извлекается контакт единой системы обмена сообщениями Exchange с адресом SIP sip:exum1@fabrikam.com

Get-CsExUmContact -Identity sip:exum1@fabrikam.com

В этом примере мы используем параметр Filter для запроса всех контактов единой системы обмена сообщениями Exchange, которые не поддерживаются Skype для бизнеса Server 2015. Для этого мы применяем фильтр по свойству Enabled, чтобы определить, равно ли (-eq) значение этого свойства False ($False). Контакты, возвращаемые этой командой, не будут функционировать.

Get-CsExUmContact -Filter {Enabled -eq $False}

Данная команда выполняет фильтрацию по свойству LineURI, чтобы извлечь все контакты единой системы обмена сообщениями Exchange с параметром LineURI, начинающимся с tel:555. Другими словами, команда запрашивает все контакты с телефонным номером, начинающимся с 555.

Get-CsExUmContact -Filter {LineURI -like "tel:555*"}

Команда в этом примере использует параметр OU для получения всех контактов единой системы обмена сообщениями Exchange, находящихся в подразделении Active Directory OU=ExUmContacts, DC=Vdomain, DC=com.

Get-CsExUmContact -OU "OU=ExUmContacts,DC=Vdomain,DC=com"

Skype для бизнеса Server 2015 работает с единой системы обмена сообщениями Exchange для обеспечения некоторых возможностей, связанных с голосовыми функциями, включая автосекретаря и абонентский доступ. Когда единая система обмена сообщениями Exchange предоставляется как размещаемая служба (а не локальная), объекты контактов должны создаваться с помощью Windows PowerShell, чтобы применить функциональность автосекретаря и абонентского доступа. Представленный командлет запрашивает один или несколько таких контактов.

 

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

Credential

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

System.Management.Automation.PSCredential

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

Для использования параметра Credential сначала требуется создать объект PSCredential, вызвав командлет Get-Credential .

DomainController

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

Microsoft.Rtc.Management.Deploy.Fqdn

Позволяет подключиться к определенному контроллеру домена для получения контактных данных. Для подключения к определенному контроллеру следует указать параметр DomainController со следующим за ним именем компьютера (например, atl-mcs-001) или полным доменным именем (например, atl-mcs-001.litwareinc.com).

Полный тип данных: Microsoft.Rtc.Management.Deploy.Fqdn

Filter

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

System.String

Позволяет ограничить возвращаемые данные, фильтруя их по атрибутам, которые доступны только в Skype для бизнеса Server 2015. Например, можно ограничить возвращаемые данные таким образом, чтобы контакты имели строки URI, начинающиеся с "tel:555".

Параметр Filter использует подмножество синтаксиса фильтрации Windows PowerShell, используемого командлетом Where-Object . Например, фильтр, возвращающий только контакты, которые были включены для корпоративной голосовой связи, будет выглядеть следующим образом: {EnterpriseVoiceEnabled -eq $True}, где EnterpriseVoiceEnabled представляет атрибут Active Directory; -eq представляет оператор сравнения ("равно"); и $True (встроенная переменная Windows PowerShell) представляет значение фильтрации.

Identity

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

Microsoft.Rtc.Management.AD.UserIdParameter

Уникальный идентификатор объекта контакта, который требуется извлечь. Идентификационные данные контакта могут быть заданы с помощью одного из четырех форматов: 1) SIP-адрес контакта; 2) имени участника-пользователя (UPN) контакта; 3) доменного имени контакта и имени входа в виде "домен\имя входа" (например, litwareinc\exum1); и 4) отображаемое имя Active Directory контакта (например, "Автосекретарь группы").

Полный тип данных: Microsoft.Rtc.Management.AD.UserIdParameter

LdapFilter

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

System.String

Позволяет ограничить возвращаемые данные путем фильтрации "общих" атрибутов Active Directory (то есть атрибутов, которые не относятся только к Skype для бизнеса Server 2015).

Параметр LdapFilter использует язык запросов LDAP во время создания фильтров.

OU

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

Microsoft.Rtc.Management.AD.OUIdParameter

Позволяет ограничить получаемые сведения до определенного подразделения Active Directory (OU). Обратите внимание, что данный командлет получает данные из заданного подразделения и из всех дочерних подразделений.

Во время задания подразделения используйте различающееся имя соответствующего контейнера; например, OU=ExUmContacts, dc=litwareinc, dc=com.

ResultSize

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

Microsoft.Rtc.Management.ADConnect.Core.Unlimited

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

В качестве размера результатов может быть указано любое целое число в диапазоне от 0 до 2147483647 включительно. При задании значения "0" команда будет выполняться, но данные возвращаться не будут.

Полный тип данных: Microsoft.Rtc.Management.ADConnect.Core.Unlimited

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

Возвращает объект типа Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact.

 
Показ: