Test-CsLisConfiguration
Última modificación del tema: 2012-03-26
Prueba la configuración del servidor de información de ubicación (LIS).
Sintaxis
Test-CsLisConfiguration -TargetFqdn <String> [-BssId <String>] [-ChassisId <String>] [-External <SwitchParameter>] [-Force <SwitchParameter>] [-Mac <String>] [-OutVerboseVariable <String>] [-PortId <String>] [-PortIdSubType <InterfaceAlias | InterfaceName | LocallyAssigned>] [-RegistrarPort <Nullable>] [-Subnet <String>] [-UserSipAddress <String>]
Test-CsLisConfiguration -TargetUri <String> -UserSipAddress <String> [-BssId <String>] [-ChassisId <String>] [-Force <SwitchParameter>] [-Mac <String>] [-OutVerboseVariable <String>] [-PortId <String>] [-PortIdSubType <InterfaceAlias | InterfaceName | LocallyAssigned>] [-Subnet <String>] [-WebCredential <PSCredential>]
Test-CsLisConfiguration [-TargetFqdn <String>] -UserCredential <PSCredential> -UserSipAddress <String> [-BssId <String>] [-ChassisId <String>] [-External <SwitchParameter>] [-Force <SwitchParameter>] [-Mac <String>] [-OutVerboseVariable <String>] [-PortId <String>] [-PortIdSubType <InterfaceAlias | InterfaceName | LocallyAssigned>] [-RegistrarPort <Nullable>] [-Subnet <String>]
Descripción detallada
Este cmdlet determina si se puede establecer contacto con el servicio web del servidor de información de ubicaciones (LIS) en función de la información de los parámetros facilitados. Si se puede contactar con el servicio web y se encuentra una ubicación que corresponda a cualquiera de los parámetros facilitados, se considerará superada la prueba y se mostrará la ubicación. Si, aun cuando no se encuentre la ubicación, se puede establecer contacto con el servicio web, la prueba se realizará correctamente, aunque sin información de ubicación. Además, si llama a este cmdlet sin facilitar ningún parámetro opcional, la prueba se considerará superada si se puede establecer contacto con el servicio, aunque, de nuevo, no se devolverá ninguna información de ubicación.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Test-CsLisConfiguration 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 "Test-CsConfiguration"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
TargetFqdn |
Requerido |
Cadena de caracteres |
El nombre de dominio completo, FQDN (con la forma server.litwareinc.com) del servidor en el que desea ejecutar la prueba. Este parámetro es obligatorio a menos que especifique el parámetro TargetUri, en cuyo caso no podrá especificar TargetFqdn. |
TargetUri |
Requerido |
Cadena de caracteres |
Identificador uniforme de recursos (URI) del Servicio de información de ubicaciones. Puede recuperar el URI del Servicio de información de ubicaciones ejecutando el siguiente comando: Get-CsService –WebServer | Select-Object LIServiceInternalUri Si especifica un valor para este parámetro, se necesita también el parámetro UserSipAddress. Si el equipo donde se ejecuta el comando carece de un certificado de servidor, también tendrá que especificar un valor en el parámetro WebCredential. Este parámetro es obligatorio si no especifica el parámetro TargetFqdn. |
UserCredential |
Requerido |
PSCredential |
Objeto que contiene credenciales de usuario para obtener acceso al Servicio de información de ubicaciones. Este objeto se puede recuperar llamando al Get-Credential y facilitando las credenciales correspondientes. Este parámetro es necesario si se han especificado los parámetros TargetFqdn y UserSipAddress y si el equipo en el que el cmdlet se ejecuta carece de un certificado de servidor. |
UserSipAddress |
Requerido |
Cadena de caracteres |
Dirección IP de un usuario remoto. Si especifica un valor para este parámetro, los parámetros TargetFqdn o TargetUri también serán necesarios. Este parámetro es necesario cuando se especifica el parámetro TargetFqdn únicamente si no se han configurado usuarios de transacción sintética. Para saber si se han configurado usuarios de transacción sintética, ejecute el cmdlet Get-CsHealthMonitoringConfiguration. |
BssId |
Opcional |
Cadena de caracteres |
Identificador del conjunto de servicios básicos (BSSID) de un punto de acceso inalámbrico. Este valor debe estar en la forma nn-nn-nn-nn-nn-nn, por ejemplo, 12-34-56-78-90-ab. |
ChassisId |
Opcional |
Cadena de caracteres |
Dirección de Media Access Control (MAC) de un conmutador de red. Este valor debe estar en la forma nn-nn-nn-nn-nn-nn, por ejemplo, 12-34-56-78-90-ab, o como dirección IP. |
External |
Opcional |
Parámetro modificador |
Este parámetro no es compatible con el servidor de información de ubicaciones. |
Mac |
Opcional |
Cadena de caracteres |
La dirección MAC del conmutador de puertos. Este valor debe estar en la forma nn-nn-nn-nn-nn-nn, por ejemplo, 12-34-56-78-90-ab. |
PortId |
Opcional |
Cadena de caracteres |
El identificador del puerto asociado a la ubicación que se probará. También puede contener una dirección MAC o una dirección IP. |
PortIdSubType |
Opcional |
PortIDSubType |
Subtipo del puerto. Este valor se puede especificar en forma de valor numérico o de cadena de caracteres, pero debe ser un subtipo válido. Los subtipos válidos son: 1: InterfaceAlias 5: InterfaceName 7: LocallyAssigned |
RegistrarPort |
Opcional |
System.Nullable |
El número de puerto del servicio registrador. |
Subnet |
Opcional |
Cadena de caracteres |
La dirección IP de una subred. Este valor debe escribirse como dirección IPv4 (con los dígitos separados por puntos, como en 192.0.2.0). |
WebCredential |
Opcional |
PSCredential |
Objeto que contiene credenciales de usuario para obtener acceso al Servicio de información de ubicaciones. Este objeto se puede recuperar llamando al cmdlet Get-Credential y facilitando las credenciales correspondientes. Este parámetro es necesario si se han especificado los parámetros TargetUri y UserSipAddress y si el equipo en el que el comando se ejecuta carece de un certificado de servidor. |
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. |
Force |
Opcional |
Parámetro modificador |
Suprime las preguntas de confirmación que aparecerían antes de realizar cambios. |
Tipos de entrada
Ninguno.
Tipos de valores devueltos
Test-CsLisConfiguration devuelve una instancia del objeto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Test-CsLisConfiguration -TargetFqdn atl-cs-001.litwareinc.com -Subnet 192.168.0.0
En este ejemplo se prueba la configuración del LIS en el nombre de dominio completo atl-cs-001.litwareinc.com. La prueba se considerará superada si se puede establecer una conexión con las credenciales de usuario actuales y el servicio web del LIS en ese nombre de dominio completo. Si se encuentra alguna ubicación asignada a la dirección IP 192.168.0.0 de la subred, se devolverá la dirección de esa ubicación.
Para que este comando se ejecute correctamente, debe haber una configuración de supervisión de mantenimiento que contenga usuarios de transacción sintética. Para saber si existe una configuración de supervisión de mantenimiento, ejecute el cmdlet Get-CsHealthMonitoringConfiguration. Para crear una configuración de supervisión de mantenimiento nueva, ejecute el cmdlet New-CsHealthMonitoringConfiguration.
-------------------------- Ejemplo 2 --------------------------
Test-CsLisConfiguration -TargetFqdn atl-cs-001.litwareinc.com -Subnet 192.168.0.0 -UserSipAddress sip:kmyer@litwareinc.com
Este ejemplo es idéntico al ejemplo 1, si bien se integra el parámetro UserSipAddress. Use este comando cuando no se hayan configurado usuarios de transacción sintética y el equipo en el que el comando se ejecuta carece de un certificado de servidor.
-------------------------- Ejemplo 3 --------------------------
$cred = Get-Credential
Test-CsLisConfiguration -TargetFqdn atl-cs-001.litwareinc.com -Subnet 192.168.0.0 -UserSipAddress sip:kmyer@litwareinc.com -UserCredential $cred
La primera línea de este ejemplo llama a un cmdlet de Windows PowerShell, Get-Credential, que solicita al usuario un identificador de usuario y una contraseña. Esta información se almacena de forma cifrada en la variable $cred.
La segunda línea es idéntica al comando del ejemplo 2, si bien se integra el parámetro UserSipAddress. Use este comando cuando no se hayan configurado usuarios de transacción sintética y el equipo en el que el comando se ejecuta carece de un certificado de servidor.
-------------------------- Ejemplo 4 --------------------------
$cred = Get-Credential
Test-CsLisConfiguration -TargetUri https://atl-cs-001.litwareinc.com/locationinformation/lisservice.svc -UserSipAddress sip:kmyer@litwareinc.com -WebCredential $cred -Subnet 192.168.0.0 -Mac 0A-23-00-00-00-AA -PortId 4500 -ChassisId 0A-23-00-00-00-AA
La primera línea de este ejemplo llama al cmdlet Get-Credential, que solicita al usuario un identificador de usuario y una contraseña. Esta información se almacena de forma cifrada en la variable $cred.
La línea 2 llama al URI del servicio web para probar la configuración del LIS (https://atl-cs-001.litwareinc.com/locationinformation/lisservice.svc) a partir de la dirección SIP del usuario remoto (sip:kmyer@litwareinc.com), y usa las credenciales que obtuvimos en la línea 1 pasándolas al parámetro WebCredential. La prueba se considerará superada si se puede establecer una conexión con las credenciales de usuario facilitadas y el servicio web del LIS en ese URI. Si se encuentra alguna ubicación asignada a la dirección IP de subred 192.168.0.0, la dirección MAC 0A-23-00-00-00-AA o el id. de puerto 4500 y ChassisId 0A-23-00-00-00-AA, se devolverá la dirección de esa ubicación.
Use este comando cuando el equipo en el que el comando se ejecuta carece de un certificado de servidor.
-------------------------- Ejemplo 5 --------------------------
Test-CsLisConfiguration -TargetUri https://atl-cs-001.litwareinc.com/locationinformation/lisservice.svc -UserSipAddress sip:kmyer@litwareinc.com -Subnet 192.168.0.0 -Mac 0A-23-00-00-00-AA -PortId 4500 -ChassisId 0A-23-00-00-00-AA
Este ejemplo es idéntico al ejemplo 4, excepto por el hecho de que el comando no usa el parámetro WebCredential (y, por lo tanto, no llama a Get-Credential). Use este comando cuando el equipo en el que el comando se ejecuta tiene un certificado de servidor.