Get-CsThirdPartyVideoSystem

Skype for Business Server 2015
 

Дата изменения раздела:2017-03-15

Возвращает информацию о контактном объекте Active Directory, представляющем стороннюю видеосистему. Сторонняя видеосистема — это устройство для видеоконференций (VTC), предоставляющее пользователям возможности телеприсутствия — способность участвовать в собраниях и конференциях по сети со всеми функциями аудио и видео.

Этот командлет появился в Skype для бизнеса Server 2015.

Get-CsThirdPartyVideoSystem [-Identity <UserIdParameter>] [-Confirm [<SwitchParameter>]] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-LdapFilter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>] [-WhatIf [<SwitchParameter>]]

Команда, показанная в примере 1, возвращает коллекцию всех сторонних видеосистем, настроенных для использования в организации.

Get-CsThirdPartyVideoSystem

В примере 2 возвращаются сведения для одной сторонней видеосистемы — системы с отображаемым именем Active Directory "Видеосистема Redmond".

Get-CsThirdPartyVideoSystem -Filter {DisplayName -eq "Redmond Video System"}

В примере 3 параметр OU используется для получения всех сторонних видеосистем с учетными записями в подразделении Telecommunications. Обратите внимание, что данная команда также возвращает сведения для любых сторонних видеосистем с учетными записями в дочернем подразделении подразделения Telecommunications (например, ou=Telecommunications,ou=AudioVideo,dc=litwareinc,dc=com).

Get-CsThirdPartyVideoSystem -OU "ou=Telecommunications,dc=litwareinc,dc=com"

Сторонние видеосистемы — это устройства VTC, предоставляющие пользователям возможности телеприсутствия (преимущественно аудио и видео). В Skype для бизнеса Server 2015 сторонние устройства VTC можно настроить как контактные объекты Active Directory, что во многом аналогично настройке аналоговых телефонов и телефонов общего пользования как контактных объектов. Связывание устройств VTC с контактными объектами облегчает администраторам отслеживание таких устройств и управление ими. Контактные объекты VTC можно создать с помощью командлета New-CsThirdPartyVideoSystem. Информацию о таких контактных объектах можно получить с помощью командлета Get-CsThirdPartyVideoSystem.

 

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

Confirm

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

System.Management.Automation.SwitchParameter

Запрашивает подтверждение перед выполнением команды.

Credential

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

System.Management.Automation.PSCredential

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

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

DomainController

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

Microsoft.Rtc.Management.Deploy.Fqdn

Позволяет подключиться к определенному контроллеру домена для получения контактных данных. Чтобы подключиться к контроллеру, укажите параметр DomainController с полным доменным именем (FQDN) компьютера. Например: atl-cs-001.litwareinc.com.

Filter

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

System.String

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

Синтаксис фильтрации Windows PowerShell, используемый параметром Filter, ничем не отличается от используемого командлетом Where-Object. Например, фильтр, возвращающий только видеосистемы в ИТ-отделе, выглядел бы следующим образом (при этом Department представляет атрибут Active Directory, -eq — оператор сравнения ("равно"), а "IT"представляет значение фильтра):

-Filter {Department -eq "IT"}

Identity

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

Microsoft.Rtc.Management.AD.UserIdParameter

Уникальный идентификатор для сторонней видеосистемы. Видеосистемы идентифицируются по различающемуся имени соответствующего объекта контакта в Active Directory. По умолчанию видеосистемы используют GUID (глобальный уникальный идентификатор) в качестве своего общего имени, т. е. системы, как правило, будут иметь идентификатор следующего вида: CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com.

LdapFilter

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

System.String

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

При создании фильтров параметром LdapFilter используется язык запросов LDAP. Например, фильтр, возвращающий только контактные объекты, представляющие видеосистемы в городе Редмонд, будет выглядеть следующим образом:

-LdapFilter "l=Redmond"

В предыдущем фильтре символ "l" представляет атрибут Active Directory (местонахождение), знак "=" — оператор сравнения ("равно"), а "Redmond" — значение фильтра.

OU

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

Microsoft.Rtc.Management.AD.OUIdParameter

Позволяет вернуть контактные объекты из определенного подразделения Active Directory. Данный командлет затем возвращает данные как из указанного подразделения, так и из его дочерних подразделений. Например, если подразделение Finance имеет два дочерних подразделения (AccountsPayable и AccountsReceivable), будут возвращены сведения о сторонних видеосистемах для каждого из них.

При указании подразделения используйте различающееся имя этого контейнера; например: -OU "OU=Finance,dc=litwareinc,dc=com".

ResultSize

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

Microsoft.Rtc.Management.ADConnect.Core.Unlimited

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

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

Нет. Командлет Get-CsThirdPartyVideoSystem не принимает входные данные из конвейера.

Командлет Get-CsThirdPartyVideoSystem возвращает экземпляры объекта Microsoft.Rtc.Management.ADConnect.Schema.OCSADThirdPartyVideoSystemContact.

 
Показ: