Compartilhar via

  • Artigo

Set-CsHostedVoicemailPolicy

 

Tópico modificado em: 2012-03-26

Modifica uma diretiva de correio de voz apresentada.

Sintaxe

Set-CsHostedVoicemailPolicy [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Destination <String>] [-Force <SwitchParameter>] [-Organization <String>] [-WhatIf [<SwitchParameter>]]

Set-CsHostedVoicemailPolicy [-Confirm [<SwitchParameter>]] [-Description <String>] [-Destination <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Organization <String>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Este cmdlet modifica uma diretiva que configura uma conta de usuário habilitada para o Microsoft Lync Server 2010 ou o Microsoft Office Communications Server a usar um serviço de caixa postal hospedado do Unificação de Mensagens (UM) do Exchange. A diretiva determina como rotear camadas não respondidas para o usuário para um serviço UM do Exchange apresentado.

Um usuário deve estar habilitado para a caixa postal apresentada do UM do Exchange para esta diretiva entrar em vigor. Você também pode chamar o cmdlet Get-CsUser e verificar a propriedade do HostedVoiceMail para determinar se um usuário está habilitado para a caixa postal apresentada. (Um valor de Verdadeiro significa que o usuário está habilitado.)

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-CsHostedVoicemailPolicy localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Cadeia de caracteres

Um identificador único para a diretiva de mensagem de voz apresentada que você deseja modificar. Este identificador inclui o escopo (no caso de global), o escopo e o site (para uma diretiva de site, como site:Redmond) ou o nome da diretiva (para uma diretiva por usuário, como HVUserPolicy).

Instance

Opcional

HostedVoicemailPolicy

Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais. O objeto deve ser do tipo HostedVoicemailPolicy, que pode ser recuperado chamando o cmdlet Get-CsHostedVoicemailPolicy.

Description

Opcional

Cadeia de caracteres

Uma descrição amigável da diretiva.

Destination

Opcional

Cadeia de caracteres

O valor atribuído para este parâmetro é o FQDN (Nomes de Domínio Completamente Qualificados) do serviço UM do Exchange apresentado.

A tentativa de habilitar um usuário para caixa postal hospedada irá falhar se a diretiva atribuída ao usuário não tiver um valor para Destination.

Este valor deve ser de 255 caracteres ou menos e em um formato correspondente à cadeia de caracteres de expressão regular ^[a-zás-Z0-9\-_]+(\.[a-zás-Z0-9\-_]+){0,}$. Isto significa apenas que ele pode estar na forma de um FQDN, como server.litwareinc.com.

Organization

Opcional

Cadeia de caracteres

Este parâmetro contém uma lista separada por vírgula dos Inquilinos do Exchange que contém os usuários do Lync Server 2010. Cada inquilino deve ser especificado como um FQDN do inquilino no Serviço Exchange apresentado.

Force

Opcional

SwitchParameter

Suprime eventuais solicitações de confirmação que seriam exibidas para a realização de 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.HostedVoicemailPolicy Aceita entrada em pipeline dos objetos de diretiva de caixa postal hospedada.

Tipos de Retorno

Este cmdlet modifica um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Policy.Voice.HostedVoicemailPolicy

Exemplo

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

Set-CsHostedVoicemailPolicy -Identity ExRedmond -Destination ExUM.contoso.com

Este comando modifica a propriedade Destino da diretiva de correio de voz apresentada nomeada ExRedmond. Ele define o destino do UM do Exchange para esta diretiva como FQDN ExUM.contoso.com.

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

$a = (Get-CsHostedVoicemailPolicy -Identity ExRedmond).Organization
$a += ",corp3.litwareinc.com"
Set-CsHostedVoicemailPolicy -Identity ExRedmond -Organization $a

Este comando adiciona um inquilino Exchange para a lista separada por vírgula de inquilinos (organizações) para a diretiva ExRedmond. A primeira linha chama Get-CsHostedVoicemailPolicy para recuperar a diretiva com a Identidade ExRedmond. Esta chamada de cmdlet está entre parênteses pois precisamos primeiro recuperar esta diretiva. Então usamos "dot notation" para recuperar a propriedade da Organização da diretiva. Salvamos a cadeia de caracteres retornada na variável $a. A próxima linha usa o operador += para anexar a cadeia de caracteres atribuída (,corp3.litwareinc.com) ao fim da cadeia de caracteres armazenada na variável $a (observe a vírgula na cadeia de caracteres atribuída. A Organização é uma lista separada por vírgulas, em caso afirmativo já há um valor na lista e quaisquer valores adicionais ´precisam ser precedidos por uma vírgula.) Finalmente, na última linha, chamamos Set-CsHostedVoicemailPolicy e atribuímos a nova cadeia de caracteres de Organization passando a variável $a para o parâmetro Organization.