Compartilhar via

  • Artigo

Remove-CsMediaConfiguration

 

Tópico modificado em: 2012-03-26

Remove a coleção especificada de definições de configuração de mídia.

Sintaxe

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

Descrição Detalhada

Este cmdlet remove uma coleção de configurações de mídia. Essas configurações estão relacionadas a chamadas de áudio e vídeo entre os pontos de extremidade do cliente.

Este cmdlet também pode ser usado para remover as definições de mídia globais. Neste caso, entretanto, as configurações não serão realmente removidas; em vez disso, elas serão simplesmente redefinidas para seus valores padrão.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Remove-CsMediaConfiguration localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

XdsIdentity

O identificador único das definições de configuração de mídias de comunicação que você deseja remover. Um identificador especifica o escopo no qual a configuração é aplicada (global, local ou serviço).

Force

Opcional

SwitchParameter

Suprime todos os avisos de confirmação que seriam exibidos antes que as alterações sejam feitas.

WhatIf

Opcional

SwitchParameter

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

SwitchParameter

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings. Aceita entrada em pipeline de objetos de configuração de mídia.

Tipos de Retorno

Remove um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings.

Exemplo

-------------------------- Exemplo 1 --------------------------

Remove-CsMediaConfiguration -Identity site:Redmond1

No Exemplo 1, o Remove-CsMediaConfiguration é usado para excluir a coleção de configuração de mídia com Identity site:Redmond1. Quando as configurações de mídia são removidas do escopo do site, o site começará automaticamente a usar as configurações de mídia globais.

-------------------------- Exemplo 2 --------------------------

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

No exemplo anterior, três cmdlets — Get-CsMediaConfiguration, Where-Object e Remove-CsMediaConfiguration — são usados para remover todas as coleções de configuração de mídia onde a criptografia é requerida de todas as partes envolvidas na conversa. Para fazer isso, Get-CsMediaConfiguration é usado primeiro para retornar todas as coleções de configuração de mídia na organização. Estas informações são, então, canalizadas para o Where-Object, que aplica um filtro que restringe os dados de pipeline para as coleções onde a propriedade EncryptionLevel é igual a (-eq) RequireEncryption. Finalmente, o conjunto filtrado de dados é passado para o Remove-CsMediaConfiguration, que exclui cada item no conjunto.

-------------------------- Exemplo 3 --------------------------

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

Neste exemplo todas as configurações de mídia definidas no escopo do serviço (significa que a configuração se aplica a um serviço específico) são removidas. Isso é realizado ao chamar primeiro Get-CsMediaConfiguration usando o serviço Filtro:*. Esse filtro recupera todas as coleções de configuração de mídia com uma Identity iniciando com service, ou seja, todas as coleções em escopo de serviço. Esse conjunto de coleções é então canalizado no Remove-CsMediaConfiguration, que o remove por completo.