Compartilhar via

  • Artigo

Grant-CsDialPlan

 

Tópico modificado em: 2012-03-23

Atribui um plano de discagem a um ou mais usuários ou grupos.

Sintaxe

Grant-CsDialPlan -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Este cmdlet atribui a um usuário um plano de discagem existente específico a usuários. Os planos de discagem fornecem as informações necessárias para habilitar os usuários do Enterprise Voice a fazerem chamadas telefônicas. Os usuários que não possuírem um plano de discagem válido não serão habilitados para fazer chamadas usando Enterprise Voice. Um plano de discagem determina, por exemplo, como se aplicarão as regras de normalização e se um prefixo deverá ser discado para efetuar chamadas externas.

É possível verificar se um usuário tem permissão para um plano de discagem por usuário, chamando um comando no seguinte formato: Get-CsUser "<user name>" | Select-Object DialPlan. Por exemplo:

Get-CsUser "Ken Myer" | Select-Object DialPlan

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

UserIdParameter

A identidade (identificador exclusivo) do usuário para o qual está sendo atribuído o plano de discagem.

As identidades de usuário podem ser especificadas utilizando-se um dos quatro formatos a seguir: 1) O endereço SIP do usuário, 2) o UPN (nome principal de usuário), 3) o nome de domínio do usuário e nome de logon, na forma domínio\logon (por exemplo, litwareinc\kenmyer) e 4) o nome de exibição no Active Directory do usuário (por exemplo, Ken Myer).

Observe que é possível usar o caráter curinga asterisco (*) ao usar o Nome de Exibição como Identidade de usuário. Por exemplo, a Identidade "* Smith" retornaria todos os usuários com o sobrenome Smith.

Tipo de dados completos: Microsoft.Rtc.Management.AD.UserIdParameter

PolicyName

Opcional

Cadeia de caracteres

O valor de Identidade do plano de discagem a ser atribuído ao usuário. (observe que isto inclui somente a parte do nome da Identidade. As identidades do plano de discagem por usuário incluem um prefixo com a marca: que não pode ser incluído com PolicyName).

DomainController

Opcional

Fqdn

Permite especificar um controlador de domínio. Se nenhum controlador de domínio for especificado, será utilizado o primeiro disponível.

PassThru

Opcional

SwitchParameter

Retorna os resultados do comando. Por padrão, esse cmdlet não gera saída.

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

Cadeia de caracteres. Aceita um valor de cadeia de caracteres em pipeline que representa a Identidade de uma conta de usuário à qual o plano de discagem está sendo concedido.

Tipos de Retorno

Quando usado com o parâmetro PassThru, retorna um objeto do tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADUserOrAppContact.

Exemplo

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

Grant-CsDialPlan -Identity "Ken Myer" -PolicyName RedmondDialPlan

No exemplo apresentado acima, Grant-CsDialPlan é utilizado para atribuir o plano de discagem RedmondDialPlan ao usuário com a identidade (nesse caso, o nome de exibição) Ken Myer.

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

Get-CsUser -LDAPFilter "l=Redmond" | Grant-CsDialPlan -PolicyName RedmondDialPlan

No Exemplo 2, o plano de discagem RedmondDialPlan é atribuído a todos os usuários que tiverem escritórios na cidade de Redmond. Para fazer isso, o cmdlet Get-CsUser é chamado para recuperar uma coleção de todos os usuários que tiverem um escritório na cidade de Redmond; isto é feito utilizando-se o parâmetro LDAPFilter e a consulta LDAP l=Redmond. (no idioma de consulta LDAP utilizado pelo Serviços de Domínio Active Directory (AD DS), o l indica a localidade ou cidade de um usuário.) Esta coleção será então canalizada para Grant-CsDialPlan, que atribui o plano de discagem Redmond a todos os usuários da coleção.