Compartilhar via

  • Artigo

Grant-CsVoicePolicy

 

Tópico modificado em: 2012-03-23

Atribui uma política de voz a um ou mais usuários ou grupos.

Sintaxe

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

Descrição Detalhada

Este cmdlet atribui a um usuário uma política de voz por usuário existente. As políticas de voz são usadas para gerenciar tais recursos relacionados ao Enterprise Voice como o toque simultâneo (a capacidade de ter um segundo toque telefônico a cada vez que alguém chamar o seu telefone de escritório) e o encaminhamento de chamadas. Use este cmdlet para atribuir as definições que habilitam e desabilitam estes recursos para um usuário específico.

É possível verificar se um usuário tem permissão para uma política de voz por usuário, chamando-se um comando neste formato: Get-CsUser "<user name>" | Select-Object VoicePolicy. Por exemplo:

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

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

UserIdParameter

A Identidade (identificador exclusivo) do usuário ao qual está se atribuindo a política.

As identidades de usuário podem ser especificadas usando-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 dos Serviços de Domínio 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 nome (Identidade) da política de voz a ser atribuída ao usuário. (observe que isto inclui somente a parte do nome da Identidade. As identidades da política 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 canalizado de cadeia de caracteres, que representa a Identidade de uma conta de usuário à qual está sendo concedida a política de voz.

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-CsVoicePolicy -Identity "Ken Myer" -PolicyName VoicePolicyRedmond

Este exemplo atribui a política de voz com a identidade VoicePolicyRedmond ao usuário com o nome de exibição Ken Myer.

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

Get-CsUser -OU "ou=Finance,ou=North America,dc=litwareinc,dc=com" | Grant-CsVoicePolicy -PolicyName VoicePolicyRedmond

Esse exemplo atribui à política de voz a Identidade VoicePolicyRedmond, a todos os usuários na OU Financeira: OU=Finance,OU=NorthAmerica,DC=litwareinc,DC=com. A primeira parte do comando chama o cmdlet Get-CsUser, para recuperar todos os usuários habilitados para o Lync Server 2010 ou Office Communications Server da OU especificada. Esta coleção de usuários será, então, canalizada para o cmdlet Grant-CsVoicePolicy, que atribuirá a política VoicePolicyRedmond a cada um destes usuários.