New-CsLocationPolicy
Última modificación del tema: 2012-03-26
Crea una directiva de ubicación nueva para usarla con una identificación de ubicación para el servicio Enhanced 9-1-1 (E9-1-1) y una ubicación general del cliente. El servicio E9-1-1 permite que quienes responden las llamadas al 911 determinen la ubicación geográfica de quien realiza la llamada.
Sintaxis
New-CsLocationPolicy -Identity <XdsIdentity> [-ConferenceMode <Nullable>] [-ConferenceUri <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EmergencyDialMask <String>] [-EmergencyDialString <String>] [-EnhancedEmergencyServicesEnabled <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LocationRequired <Nullable>] [-NotificationUri <String>] [-PstnUsage <String>] [-UseLocationForE911Only <Nullable>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
La directiva de ubicación se usa para aplicar configuraciones relacionadas con la funcionalidad E9-1-1 y con la ubicación a usuarios o contactos. 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 y cómo se debe desviar la llamada. Este cmdlet crea una directiva de ubicación nueva en el sitio o en un ámbito por usuario. (Ya hay una directiva en el ámbito general).
IMPORTANTE: La directiva de ubicación se comporta de forma distinta a otras directivas de Lync Server 2010 en lo que se refiere al orden de los ámbitos. Para el resto de las directivas, si la directiva se define en el ámbito por usuario, ésta se aplicará a cualquier usuario al que se le haya otorgado la directiva. Si no existe ningún usuario al que se le haya otorgado una directiva por usuario, se aplica la directiva del sitio. Si no hay ninguna directiva del sitio, se aplica la directiva global. Las directivas de ubicación se aplican del mismo modo, pero con una excepción: una directiva de ubicación por usuario también se puede asignar a un sitio de red (que un sitio que consta de varias subredes). Si el usuario realiza la llamada de emergencia desde una ubicación asignada a un sitio de red de la organización, se usa la directiva por usuario asignada a dicho sitio de red. Esta funcionalidad invalida cualquier directiva por usuario que se haya otorgado a ese 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 New-CsLocationPolicy localmente: RTCUniversalServerAdmins. 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 "New-CsLocationPolicy"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Identidad Xds |
Un identificador único de la directiva de ubicación. Puede utilizarse este cmdlet para crear directivas en el ámbito de sitio o por usuario. (Una directiva global existe de manera predeterminada y no se puede quitar.) Para una directiva creada en el ámbito de sitio, este valor debe tener el formato site:<site name>, donde site name es el nombre de un sitio definido en la implementación de Microsoft Lync Server 2010. Por ejemplo, site:Redmond. A una directiva creada en el ámbito por usuario se le puede asignar cualquier valor de cadena como, por ejemplo, Reno. |
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 solo puede escuchar. Los valores disponibles son: - oneway: el tercero solamente puede escuchar la conversación entre el autor de la llamada y el operador PSAP (Public Safety Answering Point). - twoway: la otra persona puede escuchar y participar en la llamada entre la persona que realiza la llamada y el operador del PSAP. |
ConferenceUri |
Opcional |
Cadena de caracteres |
URI de 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, la oficina de seguridad de la empresa podría recibir una llamada cuando se realice una llamada de emergencia y escuchar o participar en la misma (dependiendo del valor de la propiedad ConferenceMode). La cadena debe tener de 1 a 256 caracteres de longitud y comenzar con el SIP del prefijo. |
Description |
Opcional |
Cadena de caracteres |
Una descripción detallada de esta ubicación. Por ejemplo, "Usuarios de empresa de Reno". |
EmergencyDialMask |
Opcional |
Cadena de caracteres |
Un número marcado que se transformará en el valor de la propiedad EmergencyDialString. Por ejemplo, si EmergencyDialMask tiene un valor de "212" y EmergencyDialString, un valor de "911", cuando un usuario marque 212, la llamada se efectuará al 911. De este modo, pueden marcarse números de emergencia alternativos y las llamadas se recibirán en los servicios de emergencia (por ejemplo, si alguien de un país con un número de emergencia diferente intenta llamar a la policía marcando el número de su país en lugar del número del país en el que se encuentra.) Puede establecer varias máscaras de marcado de emergencia separando los valores con punto y coma (por ejemplo, -EmergencyDialMask “212;414”). IMPORTANTE. Asegúrese de que el número especificado como máscara de marcado no coincide con un número dentro del rango de órbita de estacionamiento de llamadas, ya que el enrutamiento de estacionamiento de llamadas tendrá prioridad frente a la conversión de la cadena de marcado de emergencia. Para ver los rangos de órbita de estacionamiento de llamadas, llame al cmdlet Get-CsCallParkOrbit. La longitud máxima de la cadena es de 100 caracteres. Cada carácter debe ser un dígito del 0 al 9. |
EmergencyDialString |
Opcional |
Cadena de caracteres |
El número que se marca para ponerse en contacto con 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 |
Requerido |
Booleano |
Especifica si los usuarios asociados con esta directiva están habilitados para E9-1-1. Establezca el valor en True para habilitar E9-1-1, de modo que los clientes de Lync Server 2010 recuperarán información de ubicación durante el registro y la incluirán al realizar una llamada de emergencia. Valor predeterminado: False |
LocationRequired |
Opcional |
LocationRequiredEnum |
Si el cliente no puede recuperar una ubicación de la base de datos de configuración de ubicaciones, es posible que se le pida que especifique una ubicación manualmente. Este parámetro acepta los siguientes valores: - no: no se le pedirá una ubicación al usuario. Cuando se realice una llamada sin información de ubicación, el proveedor de servicios de emergencia responderá a la llamada y preguntará la ubicación. - yes: se le pedirá al usuario que introduzca la información de ubicación cuando el cliente se registre en una ubicación nueva. El usuario puede rechazar la solicitud y no introducir ninguna información. Si se especifica información, primero el proveedor de servicio de emergencia comprobará la ubicación de una llamada al 911 y, a continuación, la enrutará al operador 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 ignora si EnhancedEmergencyServicesEnabled está establecido en False (el valor predeterminado). No se pedirá la información de ubicación a los usuarios. |
NotificationUri |
Opcional |
Cadena de caracteres |
Uno o varios URI de SIP a los que se notificará cuando se realice una llamada de emergencia. Por ejemplo, la oficina de seguridad de la empresa puede recibir una notificación a través de un mensaje instantáneo siempre que se realice una llamada de emergencia. Si la ubicación del autor de la llamada está disponible, aparecerá reflejada en la notificación. Se pueden incluir varios URI de SIP a modo de lista de elementos separados por comas (por ejemplo, -NotificationUri sip:security@litwareinc.com,sip:kmyer@litwareinc.com). No olvide que no se admiten listas de distribución y URI de grupo. La cadena debe tener de 1 a 256 caracteres de longitud y comenzar con el SIP del prefijo. |
PstnUsage |
Opcional |
Cadena de caracteres |
Uso que se hará de la red telefónica conmutada (RTC) para averiguar qué ruta de voz se usa para enrutar llamadas de emergencia realizadas desde clientes que usen este perfil. La ruta asociada con este uso debería señalar a un tronco SIP dedicado a llamadas de emergencia. El uso ya debe existir en la lista global de usos de RTC. Llame al cmdlet Get-CsPstnUsage para obtener una lista de usos. Para crear un nuevo uso, 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 sobre la ubicación actual). Establezca este valor en True para asegurarse de que la información de ubicación sólo esté disponible para usarla con una llamada de emergencia. |
Force |
Opcional |
Parámetro modificador |
Suprime las preguntas de confirmación que aparecerían antes de realizar cambios. |
InMemory |
Opcional |
Parámetro modificador |
Crea una referencia de objeto sin confirmar realmente el objeto como cambio permanente. Si se asigna la salida de este cmdlet llamado con este parámetro en una variable, puede realizar cambios en las propiedades de la referencia del objeto y después confirmar estos cambios, llamando a este conjunto coincidente de cmdlet, - cmdlet. |
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
Ninguno.
Tipos de valores devueltos
Crea un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
New-CsLocationPolicy -Identity site:Redmond -EnhancedEmergencyServicesEnabled $True
En el ejemplo 1 se usa New-CsLocationPolicy para crear una directiva de ubicación nueva para el sitio Redmond que habilita a todos los usuarios de dicho sitio para E9-1-1. Para crear esta directiva, se llama a New-CsLocationPolicy junto con dos parámetros: uno para establecer la Identidad, que en este caso es la cadena site: seguido del nombre del sitio al que se aplicará esta directiva; el otro, para establecer el valor de la propiedad EnhancedEmergencyServicesEnabled en True.
-------------------------- Ejemplo 2 --------------------------
New-CsLocationPolicy -Identity Reno -Description "All users located at the Reno site" -EnhancedEmergencyServicesEnabled $True -PstnUsage Emergency -EmergencyDialString 911
En este ejemplo se crea una directiva de ubicación por usuario. (Las directivas de ubicación por usuario se asignan específicamente a usuarios o grupos individuales). Esta directiva tiene una Identidad de Reno. Hemos agregado una descripción más detallada de la directiva mediante el parámetro Description. El siguiente parámetro que proporcionamos es EnhancedEmergencyServicesEnabled, que se establece en True para activar la funcionalidad E9-1-1 para todos los usuarios a los que se conceda esta directiva. El parámetro siguiente es PstnUsage, es este caso con un valor de Emergency. Este valor debería coincidir con un valor de la lista de usos de RTC (para obtener esta lista, llame a Get-CsPstnUsage). El uso debería estar asociado con una ruta de voz que se utilizará para llamadas de emergencia. (Puede recuperar rutas de voz llamando al cmdlet Get-CsVoiceRoute.) El último parámetro usado en este ejemplo es EmergencyDialString, que especifica el número marcado que indica una llamada de emergencia.