Compartir a través de

  • Artículo

Grant-CsHostedVoicemailPolicy

 

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

Asigna una directiva de correo de voz hospedado en el ámbito por usuario. (El ámbito por usuario permite asignar directivas a usuarios individuales o a grupos).

Sintaxis

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

Descripción detallada

Este cmdlet asigna una directiva de correo de voz hospedado específica de usuario a un usuario. Una directiva de correo de voz hospedado especifica cómo enrutar llamadas no respondidas de un usuario a un servicio de Mensajería unificada de Exchange (UM) hospedado.

Puede comprobar si se ha concedido una directiva de correo voz hospedado por usuario a un usuario llamando un comando con este formato: Get-CsUser "<nombre_usuario>" | Select-Object HostedVoicemailPolicy. Por ejemplo:

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

Si se asigna a un usuario una directiva de correo de voz hospedado que no incluye un destino, no se habilitará a dicho usuario para el correo de voz hospedado.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Grant-CsHostedVoicemailPolicy de forma local: RTCUniversalUserAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

UserIdParameter

La Identidad (identificador único) del usuario al que se va a asignar la directiva de correo de voz hospedado.

Las identidades de usuario pueden especificarse con cuatro formatos: 1) La dirección SIP del usuario; 2) el nombre principal del usuario (UPN); 3) el nombre del dominio y el nombre de inicio de sesión del usuario, con formato dominio\nombre (por ejemplo, litwareinc\kenmyer), y 4) el nombre para mostrar de Active Directory del usuario (por ejemplo, Ken Myer).

Tenga en cuenta que puede usar el asterisco (*) como comodín al utilizar el Nombre para mostrar como identidad del usuario. Por ejemplo, la identidad "* Smith" devolverá todos los usuarios que se apelliden Smith.

Tipo de datos completo: Microsoft.Rtc.Management.AD.UserIdParameter

PolicyName

Opcional

Cadena de caracteres

El nombre (identidad) de la directiva de correo de voz hospedado que se debe asignar al usuario. (Tenga en cuenta que esto sólo incluye la sección de nombre de la identidad. Las identidades de directivas de correo de voz hospedado por usuario incluyen un prefijo de etiqueta: que no se debe incluir con PolicyName).

DomainController

Opcional

Fqdn

Permite especificar un controlador de dominio. Si no se especifica ningún controlador de dominio, se usará el primero que esté disponible.

PassThru

Opcional

Parámetro modificador

Devuelve los resultados del comando. De forma predeterminada, este cmdlet no genera resultados.

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

Cadena de caracteres. Acepta un valor de cadena transferido que representa la identidad de una cuenta de usuario a la que se ha concedido la directiva de correo de voz hospedado.

Tipos de valores devueltos

Cuando se utiliza con el parámetro PassThru, devuelve un objeto de tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADUserOrAppContact.

Ejemplo

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

Grant-CsHostedVoicemailPolicy -Identity "Ken Myer" -PolicyName ExRedmond

En este ejemplo se asigna la directiva de correo voz hospedado con el valor de Identity ExRedmond al usuario con el nombre para mostrar Ken Myer.

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

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

En este ejemplo se asigna la directiva de correo voz hospedado con el valor de Identity ExRedmond a todos los usuarios de la unidad organizativa (OU) Finance. OU=Finance,OU=NorthAmerica,DC=litwareinc,DC=com. La primera parte del comando llama al cmdlet Get-CsUser para recuperar todos los usuarios habilitados para Lync Server 2010 o Office Communications Server de la unidad organizativa especificada. Esta colección de usuarios se transfiere al cmdlet Grant-CsHostedVoicemailPolicy, que asigna la directiva ExRedmond a cada uno de los usuarios.