Remove-CsAnalogDevice

Skype for Business Server 2015
 

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

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

Remove-CsAnalogDevice -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

В примере 1 рассматривается удаление аналогового устройства, свойство Identity которого имеет значение CN={e5e7daba-394e-46ec-95a1-1f2a9947aad2},CN=Users,DC=litwareinc,DC=com.

Remove-CsAnalogDevice -Identity "CN={e5e7daba-394e-46ec-95a1-1f2a9947aad2},CN=Users,DC=litwareinc,DC=com"

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

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

В примере 3 рассматривается удаление аналоговых устройств, для которых назначена политика RedmondVoicePolicy. С этой целью используются командлет Get-CsAnalogDevice и параметр Filter для извлечения всех аналоговых устройств, свойство VoicePolicy которых имеет значение RedmondVoicePolicy. После фильтрации коллекция передается в командлет Remove-CsAnalogDevice , который удаляет все элементы в этой коллекции.

Get-CsAnalogDevice -Filter {VoicePolicy -eq "RedmondVoicePolicy"} | Remove-CsAnalogDevice

Команда, представленная в примере 4, служит для удаления всех аналоговых факсимильных аппаратов, которые в настоящее время используются в компании. Для выполнения этой задачи сначала вызывается командлет Get-CsAnalogDevice с параметром Filter. Значение фильтра {AnalogFax –eq $True} выбирает только те устройства, свойство AnalogFax которых имеет значение "True". После фильтрации эта коллекция передается в командлет Remove-CsAnalogDevice , который удаляет все элементы в этой коллекции.

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

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

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

Со временем может понадобиться удалить контактный объект, связанный с аналоговым устройством. Например, при выводе из эксплуатации всех факсимильных аппаратов ассоциации аналоговых устройств (и контактных объектов) с этими аппаратами больше не нужны. Командлет Remove-CsAnalogDevice позволяет удалить аналоговые устройства. При выполнении этого командлета устройство удаляется из списка аналоговых устройств, возвращаемого командлетом Get-CsAnalogDevice . Кроме того, контактный объект, ассоциированный с этим устройством, удаляется из Active Directory.

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

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

 

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

Identity

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

Microsoft.Rtc.Management.AD.UserIdParameter

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

Confirm

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

System.Management.Automation.SwitchParameter

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

 
Показ: