Compartir a través de

  • Artículo

Grant-CsDialPlan

 

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

Asigna un plan de marcado a uno o más usuarios o grupos.

Sintaxis

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

Descripción detallada

Este cmdlet asigna un plan de marcado por usuario existente a un usuario. Los planes de marcado proporcionan información necesaria para habilitar las llamadas telefónicas para los usuarios de Enterprise Voice. Los usuarios que no posean un plan de marcado válido no podrán realizar llamadas con Enterprise Voice. Los planes de marcado determinan opciones como la manera de aplicar las reglas de normalización y si se debe marcar un prefijo para las llamadas externas.

Puede comprobar si se ha concedido un plan de marcado por usuario a un usuario determinado llamando a un comando con este formato: Get-CsUser "<nombre de usuario>" | Select-Object DialPlan. Por ejemplo:

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

Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Grant-CsDialPlan localmente: RTCUniversalUserAdmins. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

UserIdParameter

La Identidad (identificador único) del usuario al que se va a asignar el plan de marcado.

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 valor de la Identidad del plan de marcado que se asignará al usuario. (Tenga en cuenta que esto sólo incluye la sección de nombre de la identidad. Las identidades de plan de marcado por usuario incluyen el prefijo 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 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 transferida que representa el parámetro Identity de una cuenta de usuario a la que se va a otorgar el plan de marcado.

Tipos de valores devueltos

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

Ejemplo

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

Grant-CsDialPlan -Identity "Ken Myer" -PolicyName RedmondDialPlan

En el ejemplo anterior, se usa Grant-CsDialPlan para asignar el plan de marcado RedmondDialPlan al usuario con Identity (en este caso, el nombre para mostrar), Ken Myer.

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

Get-CsUser -LDAPFilter "l=Redmond" | Grant-CsDialPlan -PolicyName RedmondDialPlan

En el Ejemplo 2, se asigna el plan de marcado RedmondDialPlan a todos los usuarios con oficina en la ciudad de Redmond. Para hacerlo, se invoca el cmdlet Get-CsUser para recuperar una colección de todos los usuarios con oficina en la ciudad de Redmond; para ello, se usa el parámetro LDAPFilter y la consulta LDAP l=Redmond. (En el lenguaje de consulta LDAP que usa Active Directory Domain Services (AD DS), la l indica la localidad o ciudad de un usuario.) A continuación, se transfiere esta colección a Grant-CsDialPlan, que asigna el plan de marcado Redmond a cada usuario de la colección.