Compartilhar via


Remove-CsVoiceConfiguration

 

Tópico modificado em: 2012-03-27

Redefine a configuração de voz para seus valores padrão.

Sintaxe

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

Descrição Detalhada

As configurações de teste de voz são usadas para testar um número de telefone contra uma diretiva de voz específica, rota e plano de discagem. Este cmdlet remove a configuração de voz global (e única), que é um contêiner para todas as configurações de teste de voz definidas para uma implantação Microsoft Lync Server 2010. "Remover" a configuração de voz na verdade não a remove, a instância global continua lá. Entretanto, ele define a lista de configurações de teste de voz para o padrão, que está vazia.

AVISO: Remover a configuração de voz (que define a lista de configurações de teste de voz para vazia) exclui todas as configurações de teste de voz para uma implantação Lync Server 2010. Após chamar este cmdlet, uma chamada para o Get-CsVoiceTestConfiguration não retornará resultados.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Remove-CsVoiceConfiguration 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-CsVoiceConfiguration"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

XdsIdentity

O escopo da configuração de voz para remover. Este valor deve ser Global.

Force

Opcional

SwitchParameter

Suprime eventuais avisos de confirmação que seriam exibidos para a realização de alterações.

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.Policy.Voice.VoiceConfiguration. Aceita entrada em pipeline de um objeto de configuração de voz.

Tipos de Retorno

Este cmdlet remove (redefine) um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoiceConfiguration.

Exemplo

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

Remove-CsVoiceConfiguration -Identity Global -Confirm

Este exemplo redefine a configuração de voz Global (e única) para os valores padrão. Esta ação exclui todas as configurações de teste de voz definidas, então adicionamos os parâmetro Confirmar para receber uma solicitação perguntando se desejamos realmente desempenhar esta ação antes de efetuar a remoção.