Compartilhar via

  • Artigo

Remove-CsVoiceRoute

 

Tópico modificado em: 2012-03-25

Remove uma rota de voz. As rotas de voz contêm instruções que informam ao Microsoft Lync Server 2010 como rotear chamadas de usuários do Enterprise Voice para números de telefone na PSTN (rede telefônica pública comutada) ou em uma PBX (Central Privada de Comutação).

Sintaxe

Remove-CsVoiceRoute -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Use este cmdlet para remover uma rota de voz existente. As rotas de voz são associadas às políticas de voz mediante os usos da PSTN. Portanto, a remoção de uma rota de voz não altera quaisquer valores relacionados à política de voz, ela simplesmente altera o roteamento dos números que tiverem coincidido com o padrão da rota de voz excluída.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Remove-CsVoiceRoute localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

XdsGlobalRelativeIdentity

Uma cadeia de caracteres que identifica de forma exclusiva a rota de voz que se deseja excluir (se o nome da rota contiver um espaço, como Test Route, deve-se colocar a cadeia de caracteres completa entre aspas duplas).

Force

Opcional

SwitchParameter

Suprime qualquer aviso de confirmação que, de outra maneira, seria exibido antes de se realizar as 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.Route. Aceita entrada em pipeline de objetos de rota de voz.

Tipos de Retorno

Remove um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route.

Exemplo

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

Remove-CsVoiceRoute -Identity Route1

Remove as configurações para a rota de voz com a identidade Route1.

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

Get-CsVoiceRoute | Remove-CsVoiceRoute

Este comando remove todas as rotas de voz da organização. Primeiro, todas as rotas de voz são recuperadas pelo cmdlet Get-CsVoiceRoute. Estas rotas de voz serão, então, canalizadas para Remove-CsVoiceRoute, que removerá cada uma.

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

Get-CsVoiceRoute -Filter *Redmond* | Remove-CsVoiceRoute

Este comando remove todas as rotas de voz com uma identidade que inclui a cadeia de caracteres "Redmond." Primeiramente, o cmdlet Get-CsVoiceRoute é chamado com o parâmetro Filter. O valor do parâmetro Filter é a cadeia de caracteres Redmond delimitada pelos caracteres curinga (*), que especificam que a cadeia de caracteres pode estar em qualquer posição da identidade. Depois que forem recuperadas todas as rotas de voz com identidades que incluírem a cadeia de caracteres Redmond, estas rotas de voz serão canalizadas para Remove-CsVoiceRoute, que removerá cada uma.