Compartir a través de

  • Artículo

Set-CsHostedVoicemailPolicy

 

Última modificación del tema: 2012-03-26

Modifica una directiva de correo de voz hospedado.

Sintaxis

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>]]

Descripción detallada

Este cmdlet modifica una directiva que configura una cuenta de usuario habilitada para Microsoft Lync Server 2010 o Microsoft Office Communications Server para usar un servicio de correo de voz hospedado en Mensajería unificada de Exchange (UM). La directiva determina cómo enrutar llamadas no respondidas del usuario a un servicio de Mensajería unificada de Exchange hospedado.

El usuario debe estar habilitado para correo de voz hospedado de Mensajería unificada de Exchange para que esta directiva tenga efecto. Puede llamar al cmdlet Get-CsUser y comprobar la propiedad HostedVoiceMail para determinar si un usuario está habilitado para correo de voz hospedado. (Un valor True indica que el usuario está habilitado.)

Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los grupos siguientes están autorizados a ejecutar el cmdlet Set-CsHostedVoicemailPolicy de forma local: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Cadena de caracteres

Identificador único de la directiva de correo de voz hospedado que quiere modificar. Este identificador incluye el ámbito (si es global), el ámbito y el sitio (para una directiva de sitio, por ejemplo, site:Redmond) o el nombre de la directiva (para directivas por usuario, por ejemplo, HVUserPolicy).

Instance

Opcional

HostedVoicemailPolicy

Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales. Este objeto debe ser de tipo HostedVoicemailPolicy, que se puede recuperar al llamar al cmdlet Get-CsHostedVoicemailPolicy.

Description

Opcional

Cadena de caracteres

Descripción sencilla de la directiva.

Destination

Opcional

Cadena de caracteres

El valor asignado a este parámetro es el nombre de dominio completo (FQDN) del servicio de Mensajería unificada de Exchange hospedado.

Si intenta habilitar a un usuario para correo de voz hospedado y la directiva asignada por el usuario no tiene valor de destino, se producirá un error en la habilitación.

Este valor debe tener 255 caracteres o menos y el formato de cadena de caracteres de expresión regular ^[a-zA-Z0-9\-_]+(\.[a-zA-Z0-9\-_]+){0,}$. Simplemente significa que debe tener el formato de un nombre de dominio completo, como server.litwareinc.com.

Organization

Opcional

Cadena de caracteres

Este parámetro contiene una lista separada por comas de los arrendatarios de Exchange que contienen usuarios de Lync Server 2010. Cada arrendatario debe especificarse como un nombre de dominio completo del arrendatario en el servicio Exchange Service hospedado.

Force

Opcional

Parámetro modificador

Suprime las solicitudes de confirmación que, de lo contrario, se mostrarían antes de realizar cambios.

WhatIf

Opcional

Parámetro modificador

Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.

Confirm

Opcional

Parámetro modificador

Solicita confirmación antes de ejecutar el comando.

Tipos de entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.HostedVoicemailPolicy. Acepta entradas canalizadas de los objetos de la directiva de correo de voz hospedado.

Tipos de valores devueltos

Este cmdlet modifica un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Policy.Voice.HostedVoicemailPolicy.

Ejemplo

-------------------------- Ejemplo 1 --------------------------

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

Este comando modifica la propiedad Destination de una directiva de correo de voz hospedado llamada ExRedmond. Establece el destino Mensajería unificada de Exchange de la directiva en el FQDN ExUM.contoso.com.

-------------------------- Ejemplo 2 --------------------------

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

Este comando agrega un arrendatario de Exchange a la lista de arrendatarios (organizaciones) separados por comas de la directiva ExRedmond. En la primera línea se llama a Get-CsHostedVoicemailPolicy para recuperar la directiva con el valor de Identity ExRedmond. Esta llamada de cmdlet está entre paréntesis porque primero es necesario recuperar la directiva. A continuación, se usa "notación de punto" para recuperar la propiedad Organization de la directiva. Se guarda la cadena devuelta en la variable $a. La siguiente línea usa el operador += para agregar la cadena asignada (,corp3.litwareinc.com) al final de la cadena almacenada en la variable $a. (Fíjese en la coma de la cadena asignada. Organization es una lista separada por comas, si ya contiene algún valor, los valores adicionales deben ir precedidos por una coma.) Finalmente, en la última línea, se llama a Set-CsHostedVoicemailPolicy y se asigna la nueva cadena de Organization enviando la variable $a al parámetro Organization.