Get-CsAnalogDevice

Skype for Business Server 2015
 

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

Возвращает данные об аналоговых устройствах, которыми можно управлять с помощью Skype для бизнеса Server 2015. Аналоговое устройство — это телефон или другое устройство, подключенное к телефонной сети общего пользования. Данный командлет впервые появился в Lync Server 2010.

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

Команда, показанная в примере 1, возвращает коллекцию всех аналоговых устройств, используемых в настоящее время в организации. Это достигается путем вызова командлета Get-CsAnalogDevice без параметров.

Get-CsAnalogDevice

В примере 2 для всех аналоговых устройств в организации возвращаются значения только двух свойств: DisplayName и LineUri. Для этого сначала вызывается командлет Get-CsAnalogDevice без параметров, который возвращает значения всех свойств для всех аналоговых устройств в организации. Эта коллекция передается в командлет Select-Object , который выбирает и отображает только значения, связанные со свойствами LineUri и DisplayName.

Get-CsAnalogDevice | Select-Object DisplayName, LineUri

В примере 3 возвращаются данные об аналоговом устройстве с отображаемым именем "Building 14 Receptionist" в Active Directory. Чтобы сделать это, вызывается командлет Get-CsAnalogDevice с параметром Filter; значение фильтра, {DisplayName -eq "Building 14 Receptionist"}, ограничивает возвращенные объекты аналоговыми устройствами, у которых свойство DisplayName имеет значение "Building 14 Receptionist".

Get-CsAnalogDevice -Filter {DisplayName -eq "Building 14 Receptionist"}

В примере 4 возвращаются все аналоговые устройства, настроенные для шлюза 192.168.0.240. Это делается путем вызова командлета Get-CsAnalogDevice с параметром Filter; значение фильтра "192.168.0.240" обеспечивает возврат только тех аналоговых устройств, у которых свойство Gateway имеет значение 192.168.0.240.

Get-CsAnalogDevice -Filter {Gateway -eq "192.168.0.240"}

Команда, показанная в примере 5, возвращает данные о всех аналоговых факсимильных аппаратах в организации. Для этого вызывается командлет Get-CsAnalogDevice с параметром Filter. Значение фильтра {AnalogFax -eq $True} ограничивает возвращаемые объекты факсимильными аппаратами (аналоговыми устройствами, у которых свойство AnalogFax имеет значение True).

Get-CsAnalogDevice -Filter {AnalogFax -eq $True}

В примере 6 возвращается одно аналоговое устройство (значение свойства LineUri (номер телефона) которого равно "tel:+14255556001").

Get-CsAnalogDevice -Filter {LineUri -eq "tel:+14255556001"}

В примере 7 возвращаются все аналоговые устройства с кодом города 425 и префиксом номера телефона 555. Для этого вызывается командлет Get-CsAnalogDevice с параметром Filter; значение фильтра {LineUri -like "tel:+1425555*"} ограничивает возвращаемые данные устройствами, у которых свойство LineUri начинается с символов "tel:+1425555". Это равнозначно телефонному номеру, который начинается с символов 1425555 (например, 1-425-555-1298).

Get-CsAnalogDevice -Filter {LineUri -like "tel:+1425555*"}

В примере 8 возвращается коллекция всех аналоговых устройств, имеющих контактный объект в подразделении Telecommunications в доменных службах Active Directory. Для этого вызывается командлет Get-CsAnalogDevice с параметром OU; значение параметра ограничивает возвращаемые объекты аналоговыми устройствами, имеющими контактные объекты в подразделении с различающимся именем "ou=Telecommunications,dc=litwareinc,dc=com".

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

Команда, показанная в примере 9, возвращает коллекцию аналоговых устройств с последующим назначением политики голосовой связи каждому из устройств в коллекции. Для этого сначала вызывается командлет Get-CsAnalogDevice без параметров, который возвращает коллекцию всех аналоговых устройств, используемых в организации. Эта коллекция передается в командлет Grant-CsVoicePolicy , который присваивает каждому из устройств в ней политику голосовой связи AnalogVoicePolicy.

Get-CsAnalogDevice | Grant-CsVoicePolicy -PolicyName "AnalogVoicePolicy"

Аналоговые устройства включают в себя телефоны, факсы, модемы, телетайпные и телекоммуникационные устройства для текстовых (TTY/TDD) устройств, подключенных к телефонной сети общего пользования (PSTN). В отличие от устройств, использующих возможности системы корпоративной голосовой связи (решения для голосовой связи по протоколу VoIP, предлагаемого корпорацией Майкрософт), аналоговые устройства не передают информацию с помощью цифровых пакетов. Вместо этого информация передается с помощью непрерывного сигнала. Этот сигнал обычно называется аналоговым; отсюда и термин "аналоговые устройства".

Кроме аналоговых телефонов и телефонов, использующих возможности системы корпоративной голосовой связи, существует и другой вид телефонов: цифровые телефоны, не являющиеся IP-телефонами. Такие телефоны поставляются только вместе с определенной PBX и управлять ими с использованием командлетов Skype для бизнеса Server 2015 нельзя.

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

Командлет Get-CsAnalogDevice позволяет получать данные об аналоговых устройствах, используемых в организации. Если вызвать командлет Get-CsAnalogDevice без параметров, будут возвращены данные о всех аналоговых устройствах. Необязательные параметры позволяют фильтровать информацию различными способами. Например, можно извлечь все устройства, имеющие контактные объекты в указанном подразделении, или все аналоговые устройства, находящиеся в указанном здании.

 

Параметр Применение Тип Описание

Credential

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

System.Management.Automation.PSCredential

Позволяет запускать командлет Get-CsAnalogDevice с другими учетными данными. Используется, когда у учетной записи, с использованием которой был выполнен вход в 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 . Например, фильтр, возвращающий только факсимильные аппараты, выглядел бы следующим образом (при этом AnalogFax представляет атрибут Active Directory, -eq — оператор сравнения ("равно"), а $True, встроенная переменная Windows PowerShell, представляет значение фильтра):

-Filter {AnalogFax -eq $True}

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. Например, фильтр, возвращающий только контактные объекты, представляющие аналоговые устройства в городе Redmond, будет выглядеть следующим образом:

-LdapFilter "l=Redmond"

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

OU

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

Microsoft.Rtc.Management.AD.OUIdParameter

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

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

ResultSize

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

Microsoft.Rtc.Management.ADConnect.Core.Unlimited

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

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

Credential

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

System.Management.Automation.PSCredential

Позволяет запускать командлет Get-CsAnalogDevice с другими учетными данными. Используется, когда у учетной записи, с использованием которой был выполнен вход в 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 . Например, фильтр, возвращающий только факсимильные аппараты, выглядел бы следующим образом (при этом AnalogFax представляет атрибут Active Directory, -eq — оператор сравнения ("равно"), а $True, встроенная переменная Windows PowerShell, представляет значение фильтра):

-Filter {AnalogFax -eq $True}

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. Например, фильтр, возвращающий только контактные объекты, представляющие аналоговые устройства в городе Redmond, будет выглядеть следующим образом:

-LdapFilter "l=Redmond"

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

OU

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

Microsoft.Rtc.Management.AD.OUIdParameter

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

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

ResultSize

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

Microsoft.Rtc.Management.ADConnect.Core.Unlimited

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

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

Строка. Командлет Get-CsAnalogDevice принимает из конвейера строковое значение, которое представляет идентификатор аналогового устройства.

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

 
Показ: