Compartir a través de

  • Artículo

Get-CsLocationPolicy

 

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

Devuelve información sobre si se ha configurado el Servicio de información de ubicaciones Enhanced 9-1-1 (E9-1-1) o cómo se ha configurado. El servicio E9-1-1 permite que las personas que responden llamadas de emergencia determinen la ubicación geográfica del autor de la llamada.

Sintaxis

Get-CsLocationPolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsLocationPolicy [-Filter <String>] [-LocalStore <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, cómo se debe desviar la llamada, etc. Este cmdlet recupera una o más directivas de ubicación.

Quién puede ejecutar este cmdlet: de manera predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar localmente el cmdlet Get-CsLocationPolicy: RTCUniversalUserAdmins, RTCUniversalServerAdmins. 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 "Get-CsLocationPolicy"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

El identificador único de la directiva de ubicación que se quiere recuperar. Para recuperar la directiva de ubicación global, use un valor de Global. Para una directiva creada en el ámbito del sitio, este valor tendrá el formato site:<nombre del sitio>, donde "nombre del sitio" es el nombre de un sitio definido en la implementación de Microsoft Lync Server 2010 (por ejemplo, site:Redmond). Para una directiva creada en el ámbito por usuario, este valor simplemente será el nombre de la directiva, como Reno.

Filter

Opcional

Cadena de caracteres

Una cadena de caracteres que contiene caracteres comodín y que recuperará directivas de ubicación según la coincidencia del valor de Identity de la directiva con la cadena de caracteres con comodín.

LocalStore

Opcional

Parámetro modificador

Recupera la información de la directiva de ubicación de la réplica local del Almacén de administración central, en lugar de recuperarla del propio Almacén de administración central.

Tipos de entrada

Ninguno.

Tipos de valores devueltos

Get-CsLocationPolicy devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy.

Ejemplo

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

Get-CsLocationPolicy

En el Ejemplo 1 se devuelve una recopilación de todas las directivas de ubicación que están actualmente en uso en la organización. Para ello, simplemente se llama a Get-CsLocationPolicy sin parámetros.

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

Get-CsLocationPolicy -Identity Reno

El comando mostrado en el Ejemplo 2 solo devuelve las directivas de ubicación que tengan un valor de Identity igual a Reno. Dado que las identidades deben ser únicas, este comando devolverá, como mucho, una directiva de ubicación.

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

Get-CsLocationPolicy -Filter tag:*

El comando anterior usa el parámetro Filter para devolver todas las directivas de ubicación que se han configurado en el ámbito por usuario. (Las directivas configuradas en el ámbito por usuario se pueden asignar directamente a usuarios y sitios de red.) La cadena de caracteres comodín tag:* indica a Get-CsLocationPolicy que los datos devueltos deben limitarse a las directivas de ubicación que tengan un valor de Identity que comience por el valor de cadena tag:. A pesar de que no es necesario especificar el prefijo tag: para recuperar una directiva individual, puede usarlo para filtrar todas las directivas por usuario.

-------------------------- Ejemplo 4 --------------------------

Get-CsLocationPolicy | Where-Object {$_.EnhancedEmergencyServicesEnabled -eq $False}

El Ejemplo 4 devuelve una colección de todas las directivas de ubicación que tienen deshabilitados los servicios de emergencia mejorados. Para ello, el comando primero usa Get-CsLocationPolicy para devolver una colección de todas las directivas de ubicación que estén actualmente en uso en la organización. A continuación, la colección se transfiere al cmdlet Where-Object. A su vez, Where-Object aplica un filtro que restringe los datos devueltos a las directivas en las que la propiedad EnhancedEmergencyServicesEnabled es igual a (-eq) False ($False).