Test-CsLocationPolicy
Dernière rubrique modifiée : 2012-03-26
Effectue un test pour déterminer la stratégie qui sera utilisée en fonction des critères spécifiés dans les valeurs de paramétrage. La stratégie d’emplacement contient les paramètres qui décideront si Enhanced 9-1-1 (E9-1-1) doit être appliqué et comment il le sera. Le système E9-1-1 permet à des personnes répondant à des appels d’urgence de déterminer la position géographique de l’appelant.
Syntaxe
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>]
Description détaillée
La stratégie d’emplacement est utilisée pour appliquer des paramètres liés à la fonctionnalité E9-1-1 et la position du client. La stratégie d’emplacement détermine si un utilisateur peut avoir recours au système E9-1-1 et, le cas échéant, quel est le comportement d’un appel d’urgence. Par exemple, la stratégie d’emplacement permet de définir le numéro d’appel d’urgence (911 aux États-Unis), de déterminer si le service de sécurité de l’entreprise doit être automatiquement averti et comment l’appel doit être acheminé. Cette cmdlet retourne les informations concernant la stratégie d’emplacement qui seront utilisées quand les appels seront effectués par un client spécifique sur un pool, un sous-réseau, un commutateur ou un point d’accès sans fil.
Si un utilisateur n’est pas spécifié lors de l’appel effectué vers cette cmdlet, un test effectué sur l’utilisateur configuré. Pour trouver les utilisateurs configurés actuellement, appelez Get-CsHealthMonitoringConfiguration. Pour configurer les utilisateurs, appelez Set-CsHealthMonitoringConfiguration.
Le test est réussi quand une stratégie d’emplacement correspond à un utilisateur ou le sous-réseau. Les informations retournées par défaut incluent le nom de la stratégie d’emplacement (si une stratégie par utilisateur a été assignée) et l’activation, le cas échéant, de E9-1-1 pour l’utilisateur ou le sous-réseau. Incluez Verbose, le paramètre commun de Windows PowerShell, pour récupérer les informations supplémentaires concernant le test.
Vous pouvez tester les stratégies d’emplacement sur les utilisateurs ou les sous-réseaux. Si vous effectuez un test sur un sous-réseau (en spécifiant la valeur pour le paramètre de sous-réseau), la cmdlet essaiera de résoudre la stratégie d’emplacement pour ce sous-réseau. Si aucune stratégie d’emplacement n’a été assignée au sous-réseau, c’est la stratégie d’emplacement de l’utilisateur configuré qui sera récupérée. Si la stratégie de sous-réseau a été récupérée avec succès, le résultat comprendra une valeur LocationPolicyTagID commençant par le label de sous-réseau. Si la stratégie d’emplacement pour le sous-réseau n’a pas été récupérée, LocationPolicyTagID commencera par l’identifiant de l’utilisateur.
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-CsLocationPolicy : 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-CsLocationPolicy"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
TargetFqdn |
Obligatoire |
Chaîne |
Nom de domaine complet (FQDN) du pool dans lequel l’utilisateur ou le sous-réseau spécifié est hébergé. (Si aucun utilisateur n’a été spécifié, c’est l’utilisateur actuel ou préconfiguré qui sera pris en compte). |
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. |
RegistrarPort |
Facultatif |
Entier |
Indique le numéro du port du serveur d’administration. |
Subnet |
Facultatif |
Chaîne |
Identificateur (ou l’adresse IP) du sous-réseau pour lequel vous voulez tester la politique d’emplacement. |
UserCredential |
Facultatif |
Objet Credential PS |
Objet contenant l’identificateur de l’utilisateur et le mot de passe du compte d’utilisateur pour lequel la politique d’emplacement a été testée. Un objet d’information d’identification peut être récupéré en appelant la cmdlet Get-Credential de Windows PowerShell, en fournissant les informations qui conviennent et en sauvegardant les résultats dans une variable. |
UserSipAddress |
Facultatif |
Adresse SIP |
L’adresse SIP de l’utilisateur pour lequel vous voulez tester la stratégie d’emplacement. Elle doit être au format sip :<user id>, par exemple, sip:kenmyer@litwareinc.com. |
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-CsLocationPolicy retourne une instance de l’objet Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Exemple
-------------------------- Exemple 1 --------------------------
Test-CsLocationPolicy -TargetFqdn atl-cs-001.litwareinc.com
Cet exemple détermine la stratégie d’emplacement de l’utilisateur actuel (ou utilisateur configuré actuellement). TargetFqdn est obligatoire.
-------------------------- Exemple 2 --------------------------
$cred = Get-Credential "litwareinc\kenmyer"
Test-CsLocationPolicy -TargetFqdn atl-cs-001.litwareinc.com -UserCredential $cred -UserSipAddress "sip:kenmyer@litwareinc.com"
La première ligne de l’exemple 2 est un appel vers la cmdlet Get-Credential de Windows PowerShell. Cette cmdlet récupérera les informations d’identification de l’utilisateur et les renverra comme objet sécurisé. Le seul paramètre fourni pour cette cmdlet est l’ID utilisateur. Le fait d’exécuter cette cmdlet ouvre une boîte de dialogue prégarnie de l’ID utilisateur. Elle comporte en outre une zone de texte permettant de saisir le mot de passe de l’utilisateur. Les informations d’identification sont enregistrées dans la variable $cred.
La ligne 2 appelle la cmdlet Test-CsLocationPolicy. Comme à l’exemple 1, nous fournissons le FQDN cible. Cependant, dans cet exemple, plutôt que d’utiliser l’utilisateur préconfiguré, nous allons effectuer le test de l’adresse SIP kenmyer@litwareinc.com. Nous transférons la valeur (avec le préfixe:SIP au paramètre UserSipAddress et les informations d’identification pour cet utilisateur (enregistrées dans la variable $cred) au paramètre UserCredential.
-------------------------- Exemple 3 --------------------------
Test-CsLocationPolicy -TargetFqdn atl-cs-001.litwareinc.com -UserSipAddress "sip:kenmyer@litwareinc.com"
Cet exemple est similaire à l’exemple 2, mais sans informations d’authentification spécifiées. Quand Test-CsLocationPolicy est appelé sans informations d’authentification, le certificat du serveur de l’ordinateur sur lequel cette cmdlet est exécutée est utilisé pour authentifier et mettre en évidence la stratégie d’emplacement de l’utilisateur. Si l’ordinateur n’a pas de certificat de serveur, vous devez spécifier des informations d’authentification comme indiqué dans l’exemple 2. Pour savoir si l’ordinateur possède un certificat de serveur, appelez la cmdlet Get-CsCertificate.
-------------------------- Exemple 4 --------------------------
Test-CsLocationPolicy -TargetFqdn atl-cs-001.litwareinc.com -Subnet 172.15.11.0
Cet exemple détermine la stratégie d’emplacement du sous-réseau ID 172.15.11.0. Si le sous-réseau n’est pas associé à une stratégie d’emplacement, c’est la stratégie de l’utilisateur configuré actuellement qui sera récupérée.
Remarque : Une stratégie d’emplacement pour un sous-réseau se définit en configurant le paramètre LocationPolicy de la cmdlet Set-CsNetworkSite avec l’identité de stratégie d’emplacement, puis en configurant le paramètre NetworkSiteId de la cmdlet Set-CsNetworkSubnet avec l’identifiant de ce site. Par exemple :
Set-CsNetworkSite Portland –LocationPolicy Reno
Set-CsNetworkSubnet 175.15.11.0 –NetworkSiteID Portland