Set-CsLocationPolicy
Última modificación del tema: 2012-03-26
Modifica una directiva de ubicación.
Sintaxis
Set-CsLocationPolicy [-Identity <XdsIdentity>] [-ConferenceMode <Nullable>] [-ConferenceUri <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EmergencyDialMask <String>] [-EmergencyDialString <String>] [-EnhancedEmergencyServicesEnabled <$true | $false>] [-Force <SwitchParameter>] [-LocationRequired <Nullable>] [-NotificationUri <String>] [-PstnUsage <String>] [-UseLocationForE911Only <Nullable>] [-WhatIf [<SwitchParameter>]]
Set-CsLocationPolicy [-ConferenceMode <Nullable>] [-ConferenceUri <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EmergencyDialMask <String>] [-EmergencyDialString <String>] [-EnhancedEmergencyServicesEnabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-LocationRequired <Nullable>] [-NotificationUri <String>] [-PstnUsage <String>] [-UseLocationForE911Only <Nullable>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
La directiva de ubicación se usa para aplicar opciones de configuración relacionadas con las funciones de Enhanced 9-1-1 (E9-1-1) y la ubicación del cliente. 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 EE.UU.), si se debe informar a la seguridad corporativa de forma automática, cómo se debe desviar la llamada, etc. Este cmdlet modifica una directiva de ubicación.
Quién puede ejecutar este cmdlet: de forma predeterminada, están autorizados para ejecutar el cmdlet Set-CsLocationPolicy localmente los miembros de los siguientes grupos: 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 (incluidos los roles de RBAC personalizados que haya creado), ejecute el siguiente comando en el símbolo del sistema de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-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 modificar. Para modificar la directiva de ubicación global, use el valor 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 las directivas creadas en el ámbito por usuario, este valor será simplemente el nombre de la directiva como, por ejemplo, Reno. |
Instance |
Opcional |
LocationPolicy |
Una referencia a un objeto de directiva de ubicación. Este objeto debe ser de tipo Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy, que puede recuperarse llamando a Get-CsLocationPolicy. Recupere este objeto, cambie las propiedades en memoria y, a continuación, transfiera la referencia a objeto como un valor a este parámetro para actualizar la directiva de ubicación. |
ConferenceMode |
Opcional |
ConferenceModeEnum |
Si se especifica un valor para el parámetro ConferenceUri, el parámetro ConferenceMode determina si un tercero puede participar en la llamada o sólo puede escuchar. Los valores admitidos son: - oneway: el tercero sólo puede escuchar la conversación entre el autor de la llamada y el operador del Punto de respuesta de seguridad pública (PSAP). - twoway: el tercero puede escuchar y participar en la conversación entre el autor de la llamada y el operador del servicio de emergencia. |
ConferenceUri |
Opcional |
Cadena de caracteres |
El Identificador uniforme de recursos (URI) del SIP, en este caso el número de teléfono, de un tercero que entrará en conferencia en cualquier llamada de emergencia realizada. Por ejemplo, el departamento de seguridad de la empresa puede recibir una llamada cuando se realiza una llamada de emergencia y escuchar o participar en la conversación (según el valor de la propiedad ConferenceMode). La cadena debe tener entre 1 y 256 caracteres de longitud y debe comenzar con el prefijo sip:. |
Description |
Opcional |
Cadena de caracteres |
Descripción detallada de la ubicación. Por ejemplo, "Edificio 30, 3ª planta, departamento C". |
EmergencyDialMask |
Opcional |
Cadena de caracteres |
Un número marcado que se traducirá al valor de la propiedad EmergencyDialString. Por ejemplo, si EmergencyDialMask tiene el valor "212" y EmergencyDialString tiene el valor "911", cuando un usuario marca 212, la llamada se realizará al 911. Esto permite marcar números de emergencia alternativos y seguir teniendo acceso a los servicios de emergencia (por ejemplo, si una persona de un país o una región con otro número de emergencia intenta marcar el número de su país o región, en lugar del número del país o la región donde se encuentra.) Para definir varias máscaras de marcado de emergencia, separe los valores con punto y coma. Por ejemplo, -EmergencyDialMask “212;414”. IMPORTANTE: compruebe que el valor de la máscara de marcado no coincide con ningún número del intervalo de la órbita de estacionamiento de llamadas. El enrutamiento del estacionamiento de llamadas tiene prioridad sobre la conversión de cadenas de marcado de emergencia. Para ver los intervalos existentes en la órbita de estacionamiento de llamadas, llame al cmdlet Get-CsCallParkOrbit. La longitud máxima de la cadena es de 100 caracteres. Todos los caracteres deben ser dígitos del 0 al 9. |
EmergencyDialString |
Opcional |
Cadena de caracteres |
El número que se marca para tener acceso a los servicios de emergencia. En España este valor es "911". La cadena debe estar formada por dígitos del 0 al 9 y puede contener de uno a diez dígitos. |
EnhancedEmergencyServicesEnabled |
Opcional |
Booleano |
Especifica si los usuarios asociados con esta directiva están habilitados para E9-1-1. Defina el valor en True para habilitar E9-1-1, de modo que los clientes de Lync Server recuperarán información de ubicación durante el registro y la incluirán al realizar una llamada de emergencia. |
LocationRequired |
Opcional |
LocationRequiredEnum |
Si el cliente no puede recuperar una ubicación de la base de datos de configuración de ubicaciones, puede solicitarse al usuario que especifique una ubicación manualmente. Este parámetro admite los siguientes valores: - no: No se solicitará al usuario que especifique una ubicación. Al realizar una llamada sin información de ubicación, el proveedor de servicio de emergencia responderá a la llamada y solicitará que se especifique una ubicación. - yes: Se solicitará al usuario que especifique información de ubicación cuando el cliente se registre en una nueva ubicación. El usuario puede anular la solicitud sin especificar ninguna información. Si se introduce información, primero, el proveedor del servicio de emergencia responderá a las llamadas realizadas al 911, para verificar la ubicación antes de enrutarla al PSAP, es decir, el operador del 911. - disclaimer: Esta opción es equivalente a "yes" con una diferencia: si el usuario rechaza la solicitud, se mostrará un texto de notificación para alertar al usuario sobre las consecuencias de negarse a especificar información de ubicación. (El texto de la notificación debe definirse llamando al cmdlet Set-CsEnhancedEmergencyServiceDisclaimer.) Este valor se omite si EnhancedEmergencyServicesEnabled está definido en False (valor predeterminado). No se solicitará a los usuarios información de ubicación. |
NotificationUri |
Opcional |
Cadena de caracteres |
Uno o más identificadores uniformes de recursos (URI) del SIP que se notificarán al realizar una llamada de emergencia. Por ejemplo, el departamento de seguridad de la empresa puede recibir una notificación por mensajería instantánea si se realiza una llamada de emergencia. Si la ubicación del autor de la llamada está disponible, se incluirá dicha ubicación en la notificación. Se pueden incluir varios URI del SIP, separados por comas, en una lista. Por ejemplo, -NotificationUri sip:security@litwareinc.com,sip:kmyer@litwareinc.com. Recuerde que no se admiten listas de distribución ni URI de grupos. La cadena debe tener entre 1 y 256 caracteres de longitud y debe comenzar con el prefijo sip:. |
PstnUsage |
Opcional |
Cadena de caracteres |
El uso de la red telefónica conmutada (RTC) que se utilizará para determinar qué ruta de voz se usará para enrutar llamadas al 911 realizadas desde clientes que usen este perfil. La ruta asociada con este uso debe hacer referencia a un tronco SIP dedicado a llamadas de emergencia. Este uso debe existir previamente en la lista global de usos de RTC. Llame al cmdlet Get-CsPstnUsage para recuperar una lista de usos. Para crear un uso nuevo, llame al cmdlet Set-CsPstnUsage. |
UseLocationForE911Only |
Opcional |
Booleano |
El cliente de Microsoft Lync 2010 puede usar la información de ubicación por diferentes motivos (como notificar a los compañeros de equipo la ubicación actual). Defina este valor en True para garantizar que la información de ubicación sólo está disponible para su uso en una llamada de emergencia. |
Force |
Opcional |
Parámetro modificador |
Suprime los mensajes de confirmación que, de lo contrario, se mostrarían antes de realizar cambios. |
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 la entrada por canalización de objetos de directiva de ubicación.
Tipos de valores devueltos
Este cmdlet no devuelve un objeto o valor. Por el contrario, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Set-CsLocationPolicy -Identity site:Redmond -EnhancedEmergencyServicesEnabled $True
Este comando usa el cmdlet Set-CsLocationPolicy para modificar la directiva de ubicación con el valor de Identity site:Redmond. En otras palabras, modifica la directiva de ubicación aplicada al sitio Redmond. En este caso, el comando define el valor de la propiedad EnhancedEmergencyServicesEnabled en True, lo que habilitará la función E9-1-1 para todos los usuarios conectados al sitio Redmond (en este caso).
-------------------------- Ejemplo 2 --------------------------
Get-CsLocationPolicy | Where-Object {$_.ConferenceUri -ne $null} | Set-CsLocationPolicy -ConferenceMode twoway
El Ejemplo 2 modifica todas las directivas de ubicación que utiliza la organización que tengan un URI de conferencia definido, y define el modo de conferencia bidireccional. Para llevar a cabo esta tarea, el comando usa primero Get-CsLocationPolicy para devolver una recopilación de todas las directivas de ubicación definidas actualmente. A continuación, esta recopilación se transfiere al cmdlet Where-Object para reducirla sólo a aquellas directivas de ubicación que tengan una propiedad ConferenceUri que no esté vacía (que no sea igual a Null). Como resultado se obtiene una recopilación de directivas de ubicación que tienen un valor para ConferenceUri. Esta recopilación se transfiere a Set-CsLocationPolicy, que modifica el valor de la propiedad ConferenceMode de todas las directivas de la recopilación y establece el valor twoway.