Compartir a través de

  • Artículo

Grant-CsVoicePolicy

 

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

Asigna una directiva de voz a uno o más usuarios o grupos.

Sintaxis

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

Descripción detallada

Este cmdlet asigna una directiva de voz por usuario existente a un usuario. Las directivas de voz se usan para administrar características de Enterprise Voice, como las llamadas simultáneas (la posibilidad de recibir una segunda llamada cada vez que alguien llama al número de una oficina) o el desvío de llamadas. Use este cmdlet para asignar la configuración que habilita y deshabilita estas características para un usuario determinado.

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

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

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Grant-CsVoicePolicy 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-CsVoicePolicy"}

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.

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 de dominio y 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 voz 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 por usuario incluyen un prefijo de tag: 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 haya 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 voz.

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

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

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

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

Este ejemplo asigna la directiva de voz con la Identidad VoicePolicyRedmond a todos los usuarios de la unidad organizativa 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 recopilación de usuarios se transfiere al cmdlet Grant-CsVoicePolicy, que asigna la directiva VoicePolicyRedmond a cada uno de los usuarios.