Compartir a través de

  • Artículo

Grant-CsLocationPolicy

 

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

Asigna una directiva de ubicación E9-1-1 (Enhanced 9-1-1) a usuarios individuales o grupos. El servicio E9-1-1 permite determinar a las personas que responden llamadas del 911 la ubicación geográfica del autor de la llamada.

Sintaxis

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

Descripción detallada

La directiva de ubicación se usa para aplicar opciones de configuración relacionadas con las funciones de E9-1-1. La directiva de ubicación determina si un usuario está habilitado para E9-1-1 y, si es así, cuál es el comportamiento de una llamada de emergencia. Por ejemplo, puede usar la directiva de ubicación para definir qué número constituye una llamada de emergencia (911 en los EE. UU.), si se debe informar a la seguridad corporativa de forma automática y cómo se debe desviar la llamada. Este cmdlet concede una directiva de ubicación a un usuario o a un grupo específico.

IMPORTANTE: La directiva de ubicación se comporta de forma distinta a otras directivas de Microsoft Lync Server 2010 en lo que se refiere al orden de los ámbitos. Para todas las demás directivas, si se define una directiva en el ámbito por usuario, la directiva se aplica a cualquier usuario al que se haya otorgado dicha directiva. Si no se ha otorgado al usuario ninguna directiva por usuario, se aplica la directiva del sitio. Si no existe ninguna directiva de sitio, se aplica la directiva global. Las directivas de ubicación se aplica del mismo modo, con una excepción: una directiva de ubicación por usuario también puede asignarse a un sitio de red. (Un sitio de red está formado por un grupo de subredes.) Si el usuario realiza la llamada de emergencia desde una ubicación asignada a un sitio de red de la organización, se utiliza la directiva de nivel de usuario asignada a dicho sitio de red. Esta funcionalidad invalidará cualquier directiva por usuario que se haya otorgado al usuario. Si el usuario llama desde una ubicación desconocida o sin asignar en la organización, se aplicará el ámbito de directiva estándar.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Grant-CsLocationPolicy de manera local: RTCUniversalUserAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC), se ha asignado este cmdlet (incluidos los roles RBAC que haya creado usted mismo) para ejecutar el siguiente comando desde el símbolo del sistema de Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

UserIdParameter

Indica la identidad de la cuenta de usuario a la que se debe 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 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 SAMAccountName no puede usarse como identidad.

Asimismo, puede usar el asterisco (*) como comodín al usar el nombre para mostrar como identidad del usuario. Por ejemplo, la identidad "* Smith" concedería la directiva a todos los usuarios que se apelliden Smith.

DomainController

Opcional

Fqdn

Permite especificar un controlador de dominio. Si no se especifica ninguno, se usará el primero que haya disponible.

PassThru

Opcional

Parámetro modificador

Al incluir este parámetro (que no admite ningún valor), se muestra la información del usuario cuando se completa el cmdlet. Normalmente, no se obtiene ningún resultado cuando se ejecuta este cmdlet.

PolicyName

Opcional

Cadena de caracteres

El valor de Identity de la directiva de ubicación que se va a aplicar al usuario.

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 otorga la directiva de ubicación.

Tipos de valores devueltos

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

Ejemplo

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

Grant-CsLocationPolicy -Identity "Ken Myer" -PolicyName Reno

En el ejemplo 1, se usa Grant-CsLocationPolicy para asignar la directiva de ubicación Reno al usuario Ken Myer.

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

Get-CsUser -LDAPFilter "Department=Accounting" | Grant-CsLocationPolicy -PolicyName AccountingArea

En el Ejemplo 2, se asigna la directiva AccountingArea a todos los usuarios del departamento de Contabilidad (Accounting). Para devolver una recopilación de todos los usuarios del departamento de Contabilidad, se usa el cmdlet Get-CsUser con el parámetro LDAPFilter. El valor de consulta enviado a LDAPFilter, "Department=Accounting", devuelve todos los usuarios que tengan el valor de departamento (Department) de Active Directory Accounting. A continuación, dicha recopilación se envía a Grant-CsLocationPolicy, que asigna la directiva AccountingArea a todos los usuarios incluidos en la recopilación.

-------------------------- Ejemplo 3 --------------------------

Grant-CsLocationPolicy -Identity "Ken Myer" -PolicyName Reno -PassThru | Select-Object DisplayName, LocationPolicy

En este ejemplo se concede la directiva de ubicación Reno al usuario con la identidad (en este caso, el nombre para mostrar) Ken Myer. Además, el ejemplo incluye el parámetro PassThru, que hará que la información de usuario de Ken Myer se muestre una vez concedida la directiva de ubicación. Sin embargo, en lugar de mostrar la información de usuario de inmediato en la consola, la información se transfiere al cmdlet Select-Object, que solo mostrará las propiedades DisplayName y LocationPolicy del usuario.

Una cosa que se debe tener en cuenta con este ejemplo es que la directiva de ubicación recién concedida aparecerá en el resultado en LocationPolicy, pero aparecerá como valor delimitador en lugar de como nombre de directiva. (Un valor delimitador es un valor numérico asignado automáticamente a una directiva en el momento en que se crea.) Para ver el nombre de la directiva que se ha aplicado, ejecute el comando Get-CsUser –Identity "Ken Myer" | Select-Object DisplayName, LocationPolicy.