Partager via

  • Article

Test-CsLisConfiguration

 

Dernière rubrique modifiée : 2012-03-26

Teste la configuration LIS (Location Information Server).

Syntaxe

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>]

Description détaillée

Cette cmdlet détermine si le service Web LIS (Location Information Server) peut être contacté sur la base des informations contenues dans les paramètres fournis. Si le service Web peut être contacté et qu’un emplacement correspondant à l’un des paramètres fournis est trouvé, le test est jugé concluant et l’emplacement est affiché. Même si l’emplacement n’est pas trouvé, si le service Web peut être contacté, le test sera positif mais ne fournira aucune information sur l’emplacement. De plus, si vous appelez cette cmdlet sans fournir de paramètres facultatifs, le test sera toujours concluant à condition que le service Web puisse être contacté. Mais une nouvelle fois, aucune information sur l’emplacement ne sera retournée.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Test-CsLisConfiguration : RTCUniversalServerAdmins. Pour retourner une liste de tous les rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette cmdlet a été affectée (y compris les rôles RBAC personnalisés créés par vos soins), exécutez la commande suivante à l’invite Windows PowerShell :

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

TargetFqdn

Obligatoire

Chaîne

Nom de domaine complet (sous la forme server.litwareinc.com) du serveur à partir duquel vous voulez effectuer le test.

Ce paramètre est nécessaire à moins que vous ne spécifiiez le paramètre TargetUri, auquel cas vous ne pouvez pas spécifier de paramètre TargetFqdn.

TargetUri

Obligatoire

Chaîne

URI (Uniform Resource Identifier) du service d’informations sur l’emplacement. Vous pouvez récupérer l’URI du service d’informations sur l’emplacement en exécutant la commande suivante : Get-CsService –WebServer | Select-Object LIServiceInternalUri

Si vous spécifiez une valeur pour ce paramètre, le paramètre UserSipAddress sera également requis. Si l’ordinateur sur lequel vous exécutez la commande n’a pas de certificat de serveur, vous devrez également spécifier une valeur pour le paramètre WebCredential.

Ce paramètre est nécessaire à moins que vous ne spécifiiez le paramètre TargetFqdn.

UserCredential

Obligatoire

Objet Credential PS

Objet dans lequel sont stockées les informations d’authentification de l’utilisateur permettant à celui-ci d’accéder au service d’informations sur l’emplacement. Cet objet peut être récupéré en appelant la cmdlet Get-Credential et en fournissant les informations d’authentification.

Ce paramètre est requis si les paramètres TargetFqdn et UserSipAddress sont spécifiés, et si l’ordinateur à partir duquel vous exécutez la cmdlet n’a pas de certificat de serveur.

UserSipAddress

Obligatoire

Chaîne

Adresse SIP d’un utilisateur distant.

Si vous spécifiez une valeur pour ce paramètre, le paramètre TargetFqdn ou TargetUri sera également requis.

Ce paramètre est nécessaire lorsque vous spécifiez le paramètre TargetFqdn uniquement si vous n’avez pas défini d’utilisateurs pour les transactions synthétiques. Pour savoir si des utilisateurs de transactions synthétiques ont été définis, exécutez la cmdlet Get-CsHealthMonitoringConfiguration.

BssId

Facultatif

Chaîne

Identificateur BSSID (Basic Service Set Identifier) d’un point d’accès sans fil. Cette valeur prendra la forme nn-nn-nn-nn-nn-nn (par exemple, 12-34-56-78-90-ab).

ChassisId

Facultatif

Chaîne

Adresse MAC (Media Access Control) d’un commutateur de réseau. Cette valeur prendra la forme nn-nn-nn-nn-nn-nn (par exemple, 12-34-56-78-90-ab) ou celle d’une adresse IP.

External

Facultatif

Paramètre de commutateur

Ce paramètre n’est pas pris en charge pour le serveur LIS.

Mac

Facultatif

Chaîne

Adresse MAC du commutateur de port. Cette valeur prendra la forme nn-nn-nn-nn-nn-nn (par exemple, 12-34-56-78-90-ab).

PortId

Facultatif

Chaîne

ID du port associé à l’emplacement à tester. Ce paramètre peut également inclure une adresse MAC ou une adresse IP.

PortIdSubType

Facultatif

PortIDSubType

Sous-type du port. Cette valeur peut être saisie sous la forme d’une valeur numérique ou d’une chaîne mais elle doit être un sous-type valide. Les sous-types valides sont les suivants :

1: InterfaceAlias

5: InterfaceName

7: LocallyAssigned

RegistrarPort

Facultatif

System.Nullable

Numéro du port du service Serveur d’inscriptions.

Subnet

Facultatif

Chaîne

Adresse IP du sous-réseau. Cette valeur doit apparaître sous la forme d’une adresse IPv4 (chiffres séparés par des points ; par exemple, 192.0.2.0).

WebCredential

Facultatif

Objet Credential PS

Objet dans lequel sont stockées les informations d’authentification de l’utilisateur permettant à celui-ci d’accéder au service d’informations sur l’emplacement. Cet objet peut être récupéré en appelant la cmdlet Get-Credential et en fournissant les informations d’authentification.

Ce paramètre est requis si les paramètres TargetUri et UserSipAddress sont spécifiés, et si l’ordinateur sur lequel vous exécutez la commande n’a pas de certificat de serveur.

OutVerboseVariable

Facultatif

Chaîne

Lorsqu’elle est définie, la sortie détaillée de l’exécution de la cmdlet est stockée dans la variable spécifiée. Par exemple, pour stocker une sortie dans une variable nommée $TestOutput, utilisez la syntaxe suivante :

-OutVerboseVariable TestOutput

N’utilisez pas le caractère $ pour indiquer le nom de la variable.

Force

Facultatif

Paramètre de commutateur

Supprime les invites de confirmation qui s’affichent avant d’effectuer des modifications.

Types d’entrées

Aucun.

Types de retours

Test-CsLisConfiguration retourne une instance de l’objet Microsoft.Rtc.SyntheticTransactions.TaskOutput.

Exemple

-------------------------- Exemple 1 --------------------------

Test-CsLisConfiguration -TargetFqdn atl-cs-001.litwareinc.com -Subnet 192.168.0.0

Cet exemple teste la configuration LIS du nom de domaine complet (FQDN) atl-cs-001.litwareinc.com. Ce test réussit si une connexion au service Web LIS peut être établie avec les informations d’authentification de l’utilisateur pour ce nom de domaine complet. Si un emplacement peut être trouvé et qu’il est associé à l’adresse IP du sous-réseau 192.168.0.0, cette adresse géographique sera retournée.

Pour que cette commande soit concluante, une configuration d’analyse d’intégrité contenant des utilisateurs de transactions synthétiques doit exister. Pour savoir s’il existe une configuration d’analyse d’intégrité, exécutez la cmdlet Get-CsHealthMonitoringConfiguration. Pour créer une configuration d’analyse d’intégrité, exécutez la cmdlet New-CsHealthMonitoringConfiguration.

-------------------------- Exemple 2 --------------------------

Test-CsLisConfiguration -TargetFqdn atl-cs-001.litwareinc.com -Subnet 192.168.0.0 -UserSipAddress sip:kmyer@litwareinc.com

Cet exemple est identique à l’exemple 1 mais il ajoute le paramètre UserSipAddress. Utilisez cette commande lorsqu’aucun utilisateur de transactions synthétiques n’a été défini, mais quand l’ordinateur sur lequel la commande est exécutée dispose d’un certificat de serveur.

-------------------------- Exemple 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 première ligne de cet exemple appelle une cmdlet Windows PowerShell, Get-Credential qui invite l’utilisateur à fournir un nom d’utilisateur et un mot de passe. Ces informations sont enregistrées de manière chiffrée dans la variable $cred.

La deuxième ligne est identique à la commande dans l’exemple 2 mais elle ajoute le paramètre UserSipAddress. Utilisez cette commande lorsqu’aucun utilisateur de transactions synthétiques n’a été défini, et quand l’ordinateur sur lequel la commande est exécutée ne dispose pas d’un certificat de serveur.

-------------------------- Exemple 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 première ligne de cet exemple appelle la cmdlet Get-Credential qui invite l’utilisateur à fournir un nom d’utilisateur et un mot de passe. Ces informations sont enregistrées de manière chiffrée dans la variable $cred.

La ligne 2 teste la configuration LIS en appelant l’URI du service Web (https://atl-cs-001.litwareinc.com/locationinformation/lisservice.svc) en fonction de l’adresse SIP de l’utilisateur distant (sip:kmyer@litwareinc.com) et en utilisant les informations d’authentification que nous avons obtenues à la ligne 1 et en les transférant au paramètre WebCredential. Ce test sera réussi si la connexion au service Web LIS peut être réalisée avec les informations d’authentification de l’utilisateur pour ce nom de domaine complet. Si un emplacement est trouvé et s’il est associé à l’adresse IP de sous-réseau 192.168.0.0, l’adresse MAC 0A-23-00-00-00-AA ou l’ID de port 4500 et ChassisId 0A-23-00-00-00-AA, cette adresse géographique sera retournée.

Utilisez cette commande quand l’ordinateur sur lequel la commande est exécutée ne dispose pas d’un certificat de serveur.

-------------------------- Exemple 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

Cet exemple est identique à l’exemple 4, sauf que la commande n’utilise pas le paramètre WebCredential (et donc, elle n’appelle pas non plus la cmdlet Get-Credential). Utilisez cette commande quand l’ordinateur sur lequel la commande est exécutée dispose d’un certificat de serveur.