Compartir a través de

  • Artículo

Remove-CsLocationPolicy

 

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

Quita la directiva de ubicación especificada. (Las directivas de ubicación se usan con el servicio de 9-1-1 mejorado a fin de habilitar a quienes atienden las llamadas de 911 a determinar la ubicación geográfica del autor de llamada en base al número de teléfono del teléfono o dispositivo usado para realizar la llamada).

Sintaxis

Remove-CsLocationPolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

La directiva de ubicación se usa para aplicar las configuraciones relacionadas con la funcionalidad 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 redirigir la llamada. Este cmdlet quita una directiva de ubicación existente.

Además de quitar directivas de sitio y ubicación por usuario, este cmdlet además se puede usar para quitar la directiva de ubicación global. Aunque en este caso no se quita realmente la directiva, solo se restablecen las opciones en los valores predeterminados.

Si se ejecuta este cmdlet con una directiva de ubicación por usuario asignada al usuario, se le pedirá que confirme la eliminación.

Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los grupos siguientes están autorizados a ejecutar el cmdlet Remove-CsLocationPolicy de forma local: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Identificador único de la directiva de ubicación que se quiere quitar. Para quitar la directiva de ubicación global (que simplemente restablece esa directiva a sus valores predeterminados), use un valor de Global. Para una directiva creada en el ámbito del sitio, este valor tendrá el formato site:<nombre_sitio>, donde nombre_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 será simplemente el nombre de la directiva, como Bldg30Floor3Sector1.

Force

Opcional

Parámetro modificador

La especificación de este parámetro omitirá cualquier aviso de confirmación y la eliminación se realizará sin ningún aviso de advertencia. Por ejemplo, si se asigna una directiva de ubicación por usuario a uno o más usuarios, se mostrará un aviso de confirmación antes de la eliminación si este parámetro no está incluido en el comando.

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

Objeto Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy. Acepta entradas canalizadas de los objetos de la directiva de ubicación.

Tipos de valores devueltos

Este cmdlet no devuelve un valor ni un objeto. En su lugar, el cmdlet quita instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy.

Ejemplo

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

Remove-CsLocationPolicy -Identity Reno

El comando que se muestra en el Ejemplo 1 usa Remove-CsLocationPolicy para eliminar la directiva de ubicación con la identidad Reno. Cuando se quita una directiva por usuario, los usuarios o grupos asignados a esa directiva en su lugar usarán automáticamente la directiva configurada para su sitio. Si no se han configurado directivas para su sitio, estos usuarios y grupos usarán la directiva de ubicación global.

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

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

En el Ejemplo 2 se eliminan todas las directivas de ubicación donde la propiedad EnhancedEmergencyServicesEnabled es falsa. (En otras palabras, elimina todas las directivas de ubicación que no habilitan a E9-1-1.) Para ello, el comando primero usa Get-CsLocationPolicy para recuperar todas las directivas de ubicación actualmente en uso en la organización. A continuación, esta recopilación se canaliza al cmdlet Where-Object, que aplica un filtro para limitar los datos recuperados a las directivas donde la propiedad EnhancedEmergencyServicesEnabled es igual a (-eq) False ($False). Finalmente, esta recopilación filtrada pasa a Remove-CsLocationPolicy, que procede a eliminar cada directiva de la recopilación.