Compartilhar via

  • Artigo

Get-CsDialPlan

 

Tópico modificado em: 2012-03-23

Retorna as informações sobre os planos de discagem utilizados na organização.

Sintaxe

Get-CsDialPlan [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsDialPlan [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrição Detalhada

Este cmdlet retorna as informações sobre um ou mais planos de discagem (também conhecidos como perfis de local) em uma organização. Os planos de discagem fornecem as informações necessárias para habilitar os usuários do Enterprise Voice a fazerem chamadas telefônicas. Os planos de discagem também são utilizados 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: É possível utilizar Get-CsDialPlan para recuperar as informações específicas sobre as regras de normalização de um plano de discagem, mas se esta for a única informação de plano de discagem necessária, também será possível utilizar o cmdlet Get-CsVoiceNormalizationRule.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsDialPlan localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

XdsIdentity

O identificador exclusivo designando o escopo e, no caso de escopos por usuário, um nome, para identificar o plano de discagem que se deseja recuperar.

Filter

Opcional

Cadeia de caracteres

Executa uma pesquisa de caracteres curinga que permite reduzir os resultados aos planos de discagem com identidades que correspondam à cadeia de caracteres curingas fornecida.

LocalStore

Opcional

SwitchParameter

Recupera as informações do plano de discagem na réplica local do Repositório de Gerenciamento Central, em vez do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

Este cmdlet retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile.

Exemplo

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

Get-CsDialPlan

O exemplo 1 retorna uma coleção de todos os planos de discagem configurados para uso na organização, chamando-se Get-CsDialPlan sem quaisquer parâmetros adicionais.

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

Get-CsDialPlan -Identity RedmondDialPlan

No Exemplo 2, utiliza-se o parâmetro Identity para limitar os dados recuperados aos planos de discagem que tiverem sido aplicados em um escopo por usuário e cuja Identidade for RedmondDialPlan. Uma vez que as identidades devem ser únicas, este comando retornará somente o plano de discagem especificado.

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

Get-CsDialPlan -Identity site:Redmond

O Exemplo 3 é idêntico ao Exemplo 2, exceto que, em vez de recuperar um plano de discagem por usuário, recuperamos um plano de discagem atribuído a um site. Fazemos isso especificando o valor site: seguido do nome do site (nesse caso, Redmond) que queremos recuperar.

-------------------------- Exemplo 4 --------------------------

Get-CsDialPlan -Filter tag:*

Este exemplo usa o parâmetro Filter para retornar uma coleção de todos os planos de discagem que tiverem sido configurados no escopo por usuário (as definições configuradas no escopo por usuário (escopo de marca) podem ser atribuídas diretamente aos usuários e grupos). A cadeia de caracteres curinga tag:* instrui o cmdlet a retornar somente os planos de discagem que possuírem uma identidade começando com um valor de cadeia de caracteres tag:, que identifica os planos de discagem como sendo por usuário.

-------------------------- Exemplo 5 --------------------------

Get-CsDialPlan | Select-Object -ExpandProperty NormalizationRules

Este exemplo exibe as regras de normalização usadas para os planos de discagem configurados para usar na organização. Como a propriedade NormalizationRules consiste em uma matriz de objetos, normalmente não se exibirá na tela o conjunto completo de regras de normalização. Para consultar todas estas regras, este comando de amostra usa primeiro o Get-CsDialPlan para recuperar uma coleção de todos os planos de discagem. Essa coleção será então canalizada para o cmdlet Select-Object. Por sua vez, utiliza-se o parâmetro ExpandProperty de Select-Object para expandir os valores encontrados na propriedade NormalizationRules. A expansão dos valores significa apenas que todas as regras de normalização serão listadas individualmente na tela, a mesma saída que seria exibida se Get-CsVoiceNormalizationRule tivesse sido chamado.

-------------------------- Exemplo 6 --------------------------

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

No Exemplo 6, o Get-CsDialPlan e o Where-Object são usados para recuperar uma coleção de todos os planos de discagem que incluem a palavra Redmond na sua descrição. Para fazer isso, o comando usa primeiro o Get-CsDialPlan para recuperar todos os planos de discagem. Esta coleção será então canalizada para o cmdlet Where-Object, que aplicará um filtro que limita os dados retornados aos perfis que tiverem a palavra Redmond em qualquer posição de sua descrição.