Remove-CsMediaConfiguration

Skype for Business Server 2015
 

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

Удаляет выбранную коллекцию параметров конфигурации мультимедиа. Данный командлет впервые появился в Lync Server 2010.

Remove-CsMediaConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

В примере 1 командлет Remove-CsMediaConfiguration используется для удаления коллекции параметров конфигурации мультимедиа с идентификатором site:Redmond1. После удаления параметров на уровне сайта для него автоматически вступают в силу глобальные параметры мультимедиа.

Remove-CsMediaConfiguration -Identity site:Redmond1

В примере 2 командлеты Get-CsMediaConfiguration , Where-Object и Remove-CsMediaConfiguration используются для удаления всех коллекций параметров мультимедиа, которые предусматривают применение шифрования данных всех участников разговора. Для этого сначала вызывается командлет Get-CsMediaConfiguration , возвращающий все коллекции параметров конфигурации мультимедиа в организации. Затем эта информация передается в командлет Where-Object , который применяет фильтр, ограничивающий передаваемые по конвейеру данные коллекциями, для которых свойство EncryptionLevel имеет значение (-eq) RequireEncryption. После этого отфильтрованная информация передается в командлет Remove-CsMediaConfiguration , который удаляет все ее элементы.

Get-CsMediaConfiguration | Where-Object {$_.EncryptionLevel -eq "RequireEncryption"} | Remove-CsMediaConfiguration

В этом примере удаляются все параметры конфигурации мультимедиа, определенные на уровне службы (то есть конфигурация применяется к отдельной службе). Для этого сначала вызывается командлет Get-CsMediaConfiguration с фильтром "service:*". Фильтр отбирает все коллекции конфигурации мультимедиа с идентификатором, начинающимся со слова "service", то есть все коллекции на уровне службы. Затем эти коллекции передаются в командлет Remove-CsMediaConfiguration , который их удаляет.

Get-CsMediaConfiguration -Filter service:* | Remove-CsMediaConfiguration

Данный командлет удаляет коллекцию параметров мультимедиа, относящихся к сеансам аудио- и видеосвязи клиентских конечных точек.

Он также может применяться для удаления глобальных параметров мультимедиа. В этом случае параметры не удаляются, а заменяются значениями по умолчанию.

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

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

 

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

Identity

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

Microsoft.Rtc.Management.Xds.XdsIdentity

Уникальный идентификатор удаляемых параметров мультимедиа. Идентификатор определяет, на каком уровне будет применяться данная конфигурация (глобально, на сайте или для службы).

Confirm

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

System.Management.Automation.SwitchParameter

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

Force

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

System.Management.Automation.SwitchParameter

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

Объект Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings. Принимает из конвейера входные данные объектов настройки мультимедиа.

Удаляет объект типа Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings.

 
Показ: