Compartilhar via


Remove-CsOutboundTranslationRule

 

Tópico modificado em: 2012-03-25

Remove uma regra de conversão de saída existente. Uma regra de conversão de saída converte números de telefone no formato de discagem local para interação com sistemas PBX (central privada de comutação telefônica).

Sintaxe

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

Descrição Detalhada

Chame este cmdlet para remover uma regra de conversão de saída existente. O Microsoft Lync Server 2010 normaliza números de telefone para o formato E.164. No entanto, muitos sistemas PBX não funcionam com esse formato. As regras de conversão de saída convertem o número no formato de discagem local antes do envio do número para o Servidor de Mediação ou gateway.

Cada regra de conversão de saída está associada a uma configuração de tronco. Isso significa que o uso desse cmdlet para remover uma regra a removerá da configuração do tronco no escopo correspondente.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

XdsIdentity

O identificador exclusivo da regra de conversão de saída que você deseja remover. A Identity consiste no escopo seguido de um nome exclusivo dentro de cada escopo. Por exemplo, site:Redmond/OutboundRule1.

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.TrunkConfiguration.TranslationRule. Aceita entrada em pipeline dos objetos de regras de conversão de saída.

Tipos de Retorno

Este cmdlet não retorna um valor. Ele remove um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TranslationRule.

Exemplo

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

Remove-CsOutboundTranslationRule -Identity "site:Redmond/Prefix Redmond"

Este exemplo remove uma regra de conversão de saída existente do site de Redmond chamada Prefix Redmond. Como as identidades são exclusivas, o comando excluirá uma única regra.

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

Get-CsOutboundTranslationRule -Filter site:* | Remove-CsOutboundTranslationRule

Este exemplo remove todas as regras de conversão de saída no nível do site. A primeira parte do comando é uma chamada para Get-CsOutboundTranslationRule com um Filtro de site:*, que retornará uma coleção de todas as regras com valores Identity começando com site:. Em seguida, essa coleção é redirecionada para Remove-CsOutboundTranslationRule, que remove cada regra da coleção.