Compartilhar via

  • Artigo

Grant-CsHostedVoicemailPolicy

 

Tópico modificado em: 2012-03-23

Atribui uma política de correio de voz hospedado no escopo por usuário. (o escopo por usuário permite atribuir políticas a usuários ou grupos individuais.)

Sintaxe

Grant-CsHostedVoicemailPolicy -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 existente de caixa postal hospedada específica a usuário. Esta política de correio de voz hospedado especifica como rotear chamadas sem resposta a um usuário para um serviço do Unificação de Mensagens (UM) do Exchange hospedado.

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

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

Se você atribuir uma política de correio de voz hospedado que não inclui um destino a um usuário, não será possível habilitar esse usuário para o correio de voz hospedado.

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

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

UserIdParameter

A Identidade (identificador exclusivo) do usuário a quem a política de correio de voz hospedado está sendo atribuída.

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 e nome de logon do usuário, na forma domínio\logon (por exemplo: litwareinc\kenmyer) e 4) o nome de exibição do usuário no Active Directory (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 correio de voz hospedado a ser atribuída ao usuário (observe que isto inclui somente a parte do nome da Identidade. As identidades de políticas de correio de voz hospedado 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 canalizado, que representa a Identidade de uma conta de usuário à qual está sendo concedida a política de correio de voz hospedado.

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-CsHostedVoicemailPolicy -Identity "Ken Myer" -PolicyName ExRedmond

Este exemplo atribui a política de correio de voz hospedado cuja identidade for ExRedmond 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-CsHostedVoicemailPolicy -PolicyName ExRedmond

Este exemplo atribui a política de correio de voz hospedado cuja identidade for ExRedmond a todos os usuário na unidade organizacional (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-CsHostedVoicemailPolicy, que atribuirá a política ExRedmond a cada um destes usuários.