Set-CsAnalogDevice

Skype for Business Server 2015
 

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

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

Set-CsAnalogDevice -Identity <UserIdParameter> [-AnalogFax <$true | $false>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-ExchangeArchivingPolicy <Uninitialized | UseLyncArchivingPolicy | NoArchiving | ArchivingToExchange>] [-Gateway <Fqdn>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]

В примере 1 меняется значение свойства LineUri для аналогового устройства с удостоверением CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com.

Set-CsAnalogDevice -Identity "CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com" -LineUri "TEL:+14255551298"

Команда в примере 2 меняет шлюз всех аналоговых устройств, использующих шлюз 192.168.0.240. Для выполнения этой задачи вызывается командлет Get-CsAnalogDevice с параметром Filter. Значение фильтра ({Gateway -eq "192.168.0.240"}) гарантирует, что возвращаются только устройства, свойство Gateway которых имеет значение 192.168.0.240. Затем эта фильтрованная коллекция передается в командлет Set-CsAnalogDevice , который принимает каждый элемент коллекции и меняет значение свойства Gateway на 192.168.1.100.

Get-CsAnalogDevice -Filter {Gateway -eq "192.168.0.240"} | Set-CsAnalogDevice -Gateway "192.168.1.100"

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

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

Командлет Set-CsAnalogDevice позволяет изменять свойства объектов контактов, связанных с аналоговыми устройствами. Например, можно изменить отображаемое имя Active Directory контакта или URI-адрес, связанный с устройством.

По умолчанию запускать командлет Set-CsAnalogDevice локально могут участники следующих групп: RTCUniversalUserAdmins. Чтобы предоставить разрешения на запуск этого командлета определенным сайтам или подразделениям Active Directory, используйте командлет Grant-CsOUPermission . Чтобы получить список всех ролей управления доступом на основе ролей (RBAC), которые были назначены для этого командлета (включая все созданные вами роли RBAC), выполните следующую команду из командной строки Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsAnalogDevice"}

 

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

Identity

Обязательный

UserIdParameter

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

AnalogFax

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

Boolean

Задайте значение True ($True), если аналоговое устройство является факсимильным аппаратом. В противном случае установите значение False ($False).

Confirm

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

SwitchParameter

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

DisplayName

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

String

Задает отображаемое имя Active Directory для аналогового устройства.

DisplayNumber

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

String

Телефонный номер, отображаемый в Skype для бизнеса. Свойство DisplayNumber может быть отформатировано предпочитаемым образом, например: 1-800-555-1234; 1-(800)-555-1234; 1.800.555.1234.

DomainController

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

Fqdn

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

Enabled

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

Boolean

Если задано значение True ($True), аналоговое устройство можно использовать с Skype для бизнеса.

EnterpriseVoiceEnabled

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

Boolean

Указывает, включена ли у контактного объекта для аналогового устройства поддержка корпоративной голосовой связи, VoIP-решения корпорации Майкрософт. С помощью корпоративной голосовой связи можно выполнять телефонные вызовы по сети Интернет вместо стандартной телефонной сети.

ExchangeArchivingPolicy

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

ExchangeArchivingPolicyOptionsEnum

Указывает расположение, в которое архивируются сеансы обмена мгновенными сообщениями контакта. Допускаются следующие значения:

Uninitialized

UseLyncArchivingPolicy

ArchivingToExchange

NoArchiving

Gateway

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

Fqdn

IP-адрес шлюза PSTN, используемого аналоговым устройством.

LineURI

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

String

Телефонный номер аналогового устройства. URI линии необходимо указать в формате E.164, при этом используется префикс "TEL:". Например: TEL:+14255551297. Любой добавочный номер необходимо добавить в конец URI линии, например: TEL:+14255551297;ext=51297.

PassThru

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

SwitchParameter

Возвращает объект, представляющий телефон общего пользования.

SipAddress

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

String

Уникальный идентификатор, позволяющий аналоговому устройству взаимодействовать с SIP-устройствами, такими как Skype для бизнеса Server 2015. Перед SIP-адресом должен указываться префикс "sip:". Например: sip:bldg14lobby@litwareinc.com.

WhatIf

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

SwitchParameter

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

Объект Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact. Командлет Set-CsAnalogDevice принимает из конвейера экземпляры объекта аналогового устройства.

По умолчанию командлет Set-CsAnalogDevice не возвращает каких-либо значений или объектов. Но если указать параметр PassThru, командлет вернет экземпляры объекта Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact.

 
Показ: