Test-CsLocationPolicy
Última modificación del tema: 2012-03-26
Ejecuta una prueba para determinar la directiva de ubicación que se usará según los criterios especificados en los valores de parámetro. La directiva de ubicación contiene las configuraciones que determinarán si 9-1-1 mejorado (E9-1-1) se aplicará y cómo se llevará a cabo dicha implementación. E9-1-1 habilita a aquellos que responden llamadas de emergencia del 911 a determinar la ubicación geográfica del autor de la llamada.
Sintaxis
Test-CsLocationPolicy -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-Subnet <String>] [-UserSipAddress <String>]
Test-CsLocationPolicy [-TargetFqdn <String>] -UserCredential <PSCredential> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-Subnet <String>]
Descripción detallada
La directiva de ubicación se usa para aplicar configuraciones que se relacionan con la funcionalidad de 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 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 devuelve información acerca de la directiva de ubicación que se usará cuando se realizan llamadas desde un cliente en particular en un grupo, subred, conmutador o punto de acceso inalámbrico específico.
Si no se especifica un usuario en la llamada para este cmdlet, se probará es usuario actualmente configurado. Para encontrar el usuario actualmente configurado, llame a Get-CsHealthMonitoringConfiguration. Para establecer el usuario configurado, llame a Set-CsHealthMonitoringConfiguration.
Si se encontró una directiva de ubicación para el usuario o la subred, la prueba será correcta. La información devuelta de forma predeterminada incluye el nombre de la directiva de ubicación (en caso de que se asigne una directiva por usuario) y si el usuario o la subred están habilitados para E9-1-1. Incluye el parámetro común Verbose de Windows PowerShell para recuperar información adicional acerca de la prueba.
Puede probar directivas de ubicación en usuarios o subredes. Si ejecuta la prueba en una subred (mediante la especificación de un valor para el parámetro Subnet), el cmdlet intentará resolver la directiva de ubicación para esa subred. Si no se asigna ninguna directiva de ubicación a la subred, se recuperará la directiva de ubicación para el usuario configurado. Si la directiva de subred se recupera correctamente, la salida incluirá un valor LocationPolicyTagID que se iniciará con el Id. de etiqueta de la subred. Si no se encontró una directiva de ubicación para la subred, LocationPolicyTagID comenzará con el Id. de etiqueta del usuario.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Test-CsLocationPolicy localmente: 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 "Test-CsLocationPolicy"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
TargetFqdn |
Requerido |
Cadena de caracteres |
El nombre de dominio completo (FQDN) del grupo en el que se aloja el usuario o la subred específica. (Si no se especifica un usuario, el usuario actual o preconfigurado se da por supuesto). |
OutVerboseVariable |
Opcional |
Cadena de caracteres |
Cuando esté presente, el resultado detallado de ejecutar el cmdlet se almacenará en la variable especificada. Por ejemplo, para almacenar resultados en una variable llamada $TestOutput, utilice la sintaxis siguiente: -OutVerboseVariable TestOutput No anteponga un carácter $ al especificar el nombre de variable. |
RegistrarPort |
Opcional |
Integer |
El número de puerto del servicio registrador. |
Subnet |
Opcional |
Cadena de caracteres |
El Id. (la dirección IP) de la subred para la cual desea probar la directiva de ubicación. |
UserCredential |
Opcional |
Objeto de credencial de PS |
Un objeto que contiene el Id. y la contraseña de usuario de la cuenta de usuario cuya directiva de ubicación se está probando. Un objeto de credencial se puede recuperar mediante el llamado del cmdlet Get-Credential de Windows PowerShell, al completar la información correspondiente y al guardar el resultado en una variable. |
UserSipAddress |
Opcional |
Dirección SIP |
La dirección SIP del usuario cuya directiva de ubicación se desea probar. Esta se debe estar con el formato sip:<Id. de usuario>, por ejemplo, sip:kenmyer@litwareinc.com. |
Force |
Opcional |
Parámetro modificador |
Suprime las solicitudes de confirmación que, de lo contrario, se mostrarían antes de realizar cambios. |
Tipos de entrada
Ninguno.
Tipos de valores devueltos
Test-CsLocationPolicy devuelve una instancia del objeto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Test-CsLocationPolicy -TargetFqdn atl-cs-001.litwareinc.com
En este ejemplo, se determina la directiva de ubicación del usuario actual (o el usuario actualmente configurado). Se requiere TargetFqdn.
-------------------------- Ejemplo 2 --------------------------
$cred = Get-Credential "litwareinc\kenmyer"
Test-CsLocationPolicy -TargetFqdn atl-cs-001.litwareinc.com -UserCredential $cred -UserSipAddress "sip:kenmyer@litwareinc.com"
La primera línea en el Ejemplo 2 es una llamada al cmdlet Get-Credential de Windows PowerShell. Este cmdlet recuperará las credenciales de usuario y las devolverá como un objeto seguro. El único parámetro proporcionado a este cmdlet es user ID. La ejecución de este cmdlet abrirá un cuadro de diálogo que se completará previamente con el Id. de usuario proporcionado y que posee un cuadro de texto que le permite escribir la contraseña de usuario. Estas credenciales de usuario se guardan en la variable $cred.
La línea 2 llama al cmdlet Test-CsLocationPolicy. Al igual que el Ejemplo 1, se suministra el FQDN de destino. Sin embargo, en este ejemplo, en vez de usar un usuario preconfigurado, se ejecutará la prueba en función del usuario con la dirección SIP kenmyer@litwareinc.com. Ese valor se transfiere (con el sip: prefijo) al parámetro UserSipAddress y las credenciales para ese usuario (almacenadas en la variable $cred) al parámetro UserCredential.
-------------------------- Ejemplo 3 --------------------------
Test-CsLocationPolicy -TargetFqdn atl-cs-001.litwareinc.com -UserSipAddress "sip:kenmyer@litwareinc.com"
Este ejemplo es similar al Ejemplo 2, pero sin que se especifiquen las credenciales de usuario. Cuando se llama a Test-CsLocationPolicy sin que se especifiquen credenciales de usuario, el certificado del servidor en el equipo en donde se ejecuta este cmdlet se usa para autenticar y descubrir la directiva de ubicación del usuario. Si el equipo no cuenta con un certificado de servidor, se deben especificar las credenciales como se muestra en el Ejemplo 2. Para descubrir si hay un certificado de servidor en el equipo, llame al cmdlet Get-CsCertificate.
-------------------------- Ejemplo 4 --------------------------
Test-CsLocationPolicy -TargetFqdn atl-cs-001.litwareinc.com -Subnet 172.15.11.0
En este ejemplo, se determina la directiva de ubicación de la subred con el Id. de subred 172.15.11.0. Si la subred no está asociada con una directiva de ubicación, se recuperará la directiva de ubicación para el usuario actualmente configurado.
Nota: Una directiva de ubicación se establece en una subred mediante la configuración del parámetro LocationPolicy del cmdlet Set-CsNetworkSite en el Id. de la directiva de ubicación y, luego, mediante la configuración del parámetro NetworkSiteId del cmdlet Set-CsNetworkSubnet en el Id. de ese sitio. Por ejemplo:
Set-CsNetworkSite Portland –LocationPolicy Reno
Set-CsNetworkSubnet 175.15.11.0 –NetworkSiteID Portland