Test-CsLisCivicAddress
Dernière rubrique modifiée : 2012-03-25
Teste une ou plusieurs adresses géographiques par rapport à la base de données MSAG (Master Street Address Guide).
Syntaxe
Test-CsLisCivicAddress [-City <String>] [-Confirm [<SwitchParameter>]] [-Country <String>] [-HouseNumber <String>] [-HouseNumberSuffix <String>] [-PostalCode <String>] [-PostDirectional <String>] [-PreDirectional <String>] [-State <String>] [-StreetName <String>] [-StreetSuffix <String>] [-UpdateValidationStatus <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Dans le cadre d’une implémentation Enterprise Voice avec le système Enhanced 9-1-1 (E9-1-1), les emplacements des utilisateurs sont déterminés selon des cartes, qui mappent un sous-réseau, un port, un commutateur ou un point d’accès sans fil à un emplacement. (En l’absence de connexion à un emplacement mappé, l’utilisateur peut être invité à saisir manuellement son emplacement.) Les adresses de ces emplacements doivent être validées par rapport à la base de données MSAG par le fournisseur de routage de réseau E9-1-1. Cette cmdlet utilise le service Web de ce fournisseur pour valider les adresses mappées. Vous pouvez configurer un fournisseur de services en appelant la cmdlet Set-CsLisServiceProvider.
Si vous souhaitez mettre à jour la propriété MSAGValid de l’adresse géographique, veillez à inclure le paramètre UpdateValidationStatus dans votre appel de Test-CsLisCivicAddress. Utilisez la cmdlet Get-CsLisCivicAddress pour récupérer des adresses géographiques.
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-CsLisCivicAddress : 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-CsLisCivicAddress"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
City |
Facultatif |
Chaîne |
Ville à l’emplacement concerné. Longueur maximale : 64 caractères. |
Country |
Facultatif |
Chaîne |
Pays/région de l’emplacement concerné. Longueur maximale : 2 caractères |
HouseNumber |
Facultatif |
Chaîne |
Numéro de la voie correspondant à l’emplacement. Pour les sociétés, il s’agit du numéro de la rue. Longueur maximale : 10 caractères |
HouseNumberSuffix |
Facultatif |
Chaîne |
Informations supplémentaires sur le numéro de la voie (de type 1/2 ou A). Exemple : 1234 1/2 Oak Street ou 1234 A Elm Street. Longueur maximale : 5 caractères |
PostalCode |
Facultatif |
Chaîne |
Code postal associé à cet emplacement. Longueur maximale : 10 caractères |
PostDirectional |
Facultatif |
Chaîne |
Orientation géographique d’un nom de rue. Exemple : NE (nord-est) ou NW (nord-ouest) pour la rue Main Street NE ou 7th Avenue NW. Longueur maximale : 2 caractères |
PreDirectional |
Facultatif |
Chaîne |
Orientation géographique d’un nom de rue précédant le nom de la rue. Exemple : NE (nord-est) ou NW (nord-ouest) pour la rue NE Main Street ou NW 7th Avenue. Longueur maximale : 2 caractères |
State |
Facultatif |
Chaîne |
État ou province associé(e) à cet emplacement. Longueur maximale : 2 caractères |
StreetName |
Facultatif |
Chaîne |
Nom de la rue pour cet emplacement. Longueur maximale : 60 caractères |
StreetSuffix |
Facultatif |
Chaîne |
Type d’artère désigné dans un nom (par exemple : rue, avenue ou boulevard). Longueur maximale : 10 caractères |
UpdateValidationStatus |
Facultatif |
Paramètre de commutateur |
En incluant ce paramètre, vous modifiez la propriété MSAGValid de l’adresse géographique si l’adresse est validée par cette cmdlet. Si l’adresse est valide, MSAGValid est définie sur True. Omettre ce paramètre a pour conséquence de ne pas modifier la valeur MSAGValid. |
WhatIf |
Facultatif |
Paramètre de commutateur |
Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement. |
Confirm |
Facultatif |
Paramètre de commutateur |
Vous demande confirmation avant d’exécuter la commande. |
Types d’entrées
Accepte la saisie de données transmises via le pipeline contenant un objet d’adresse géographique LIS (Location Information Server).
Types de retours
Cette cmdlet ne renvoie aucune valeur.
Exemple
-------------------------- Exemple 1 --------------------------
Test-CsLisCivicAddress -HouseNumber 1234 -HouseNumberSuffix "" -PreDirectional "" -StreetName Main -StreetSuffix St -PostDirectional "" -City Redmond -State WA -PostalCode 99999 -Country US -UpdateValidationStatus
Cette commande valide l’adresse avec les propriétés correspondant aux valeurs spécifiées dans ces paramètres par rapport à la base de données MSAG. Notez que le paramètre UdateValidationStatus a été inclus à la fin : il met à jour la propriété MSAGValid de l’adresse.
-------------------------- Exemple 2 --------------------------
Get-CsLisCivicAddress | Test-CsLisCivicAddress -UpdateValidationStatus
Cet exemple montre comment tester toutes les adresses géographiques LIS. L’exemple commence par un appel de Get-CsLisCivicAddress pour récupérer toutes les adresses géographiques définies dans la base de données des emplacements. Ces adresses sont redirigées vers Test-CsLisCivicAddress qui utilise le service Web du fournisseur de routage de réseau E9-1-1 pour valider chaque adresse.