Compartilhar via

  • Artigo

Remove-CsDialPlan

 

Tópico modificado em: 2012-03-25

Remove o plano de discagem especificado. Este cmdlet também pode ser usado para remover o plano de discagem global. Entretanto, se o plano de discagem global for removido, ele não será removido de fato. Em vez disso, serão redefinidos os valores padrão das configurações.

Sintaxe

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

Descrição Detalhada

Este cmdlet remove um plano de discagem existente (também conhecido como um perfil de local). Os planos de discagem fornecem as informações necessárias para permitir que os usuários do Enterprise Voice façam chamadas telefônicas. Os planos de discagem também são usados pelo Aplicativo Atendedor de Conferência para efetuar conferências discadas. Um plano de discagem determina, por exemplo, quais regras de normalização serão aplicadas e se um prefixo deverá ser discado para se efetuar chamadas externas.

Observação: Remover um plano de discagem também remove quaisquer regras de normalização associadas. Se o plano de discagem global for removido, quaisquer regras de normalização associadas também serão removidas, mas uma regra de normalização global padrão será criada.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

XdsIdentity

O identificador exclusivo do plano de discagem que se deseja remover.

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.LocationProfile. Remove-CsDialPlan aceita a entrada canalizada de objetos de planos de discagem.

Tipos de Retorno

Esse cmdlet remove instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile.

Exemplo

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

Remove-CsDialPlan -Identity RedmondDialPlan

O exemplo anterior usa Remove-CsDialPlanpara excluir o plano de discagem por usuário cuja identidade for RedmondDialPlan. Observe que, ao se excluir um plano de discagem, não é preciso necessariamente atribuir um novo plano aos usuários aos quais tiver sido atribuído o plano recém-excluído. Em vez disso, estes usuários usarão o plano de discagem atribuído para seu serviço ou site, ou o plano global.

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

Get-CsDialPlan | Where-Object {$_.Description -match "Redmond"} | Remove-CsDialPlan

No Exemplo 2, todos os planos de discagem que incluem a palavra Redmond em sua descrição são excluídos. Para fazer isso, o comando chama primeiramente Get-CsDialPlan, para retornar uma coleção de todos os planos de discagem configurados para uso na organização. Esta coleção será então canalizada para o cmdlet Where-Object, que aplicará um filtro que limita os dados retornados a perfis que incluírem a palavra Redmond em sua descrição. Quando isso tiver sido concluído, a coleção filtrada será passada para Remove-CsDialPlan, que removerá todos os planos de discagem da coleção.