Test-CsLisCivicAddress
Ultima modifica dell'argomento: 2012-03-25
Verifica uno o più indirizzi civici rispetto allo stradario informatico.
Sintassi
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>]]
Descrizione dettagliata
In un'implementazione di VoIP aziendale con Enhanced 9-1-1 (E9-1-1), le posizioni degli utenti sono determinate sulla base di mappe di posizione che mappano una subnet, una porta, uno switch o un punto di accesso wireless a una posizione. In assenza di una connessione a una posizione mappata, è possibile richiedere all'utente di immettere la sua posizione manualmente. Gli indirizzi di queste posizioni devono essere convalidati rispetto allo stradario informatico dal provider del routing di rete del servizio chiamate di emergenza. Questo cmdlet utilizza il servizio Web di tale provider per convalidare gli indirizzi mappati. È possibile configurare un provider di servizi chiamando il cmdlet Set-CsLisServiceProvider.
Se si desidera aggiornare la proprietà MSAGValid dell'indirizzo civico, è necessario includere il parametro UpdateValidationStatus nella chiamata a Test-CsLisCivicAddress. Utilizzare il cmdlet Get-CsLisCivicAddress per recuperare gli indirizzi civici.
Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Test-CsLisCivicAddress in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsLisCivicAddress"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
City |
Facoltativo |
Stringa |
La città della posizione. Lunghezza massima: 64 caratteri. |
Country |
Facoltativo |
Stringa |
Il paese/area geografica relativo alla posizione. Lunghezza massima: 2 caratteri |
HouseNumber |
Facoltativo |
Stringa |
Il numero civico della posizione. Nel caso di una società è il numero nella via in cui ha sede la società. Lunghezza massima: 10 caratteri |
HouseNumberSuffix |
Facoltativo |
Stringa |
Informazioni aggiuntive sul numero civico, come 1/2 o A. Ad esempio: 1234 1/2 Oak Street o 1234 A Elm Street. Lunghezza massima: 5 caratteri |
PostalCode |
Facoltativo |
Stringa |
Il codice postale associato a questa posizione. Lunghezza massima: 10 caratteri |
PostDirectional |
Facoltativo |
Stringa |
La designazione direzionale di una via. Esempio: NE o NW per Main Street NE o 7th Avenue NW. Lunghezza massima: 2 caratteri |
PreDirectional |
Facoltativo |
Stringa |
La designazione direzionale per un nome di una via che precede il nome della via. Esempio: NE o NW per NE Main Street o NW 7th Avenue. Lunghezza massima: 2 caratteri |
State |
Facoltativo |
Stringa |
Lo stato o la provincia associato a questa posizione. Lunghezza massima: 2 caratteri |
StreetName |
Facoltativo |
Stringa |
Il nome della via per questa posizione. Lunghezza massima: 60 caratteri |
StreetSuffix |
Facoltativo |
Stringa |
Il tipo di via indicato nel nome, ad esempio Street, Avenue o Court. Lunghezza massima: 10 caratteri |
UpdateValidationStatus |
Facoltativo |
Parametro opzionale |
Se si include questo parametro la proprietà MSAGValid dell'indirizzo civico viene modificata in base al risultato della convalida dell'indirizzo con questo cmdlet. Se l'indirizzo è valido, MSAGValid viene impostato su True. Se si omette questo parametro, il valore di MSAGValid resta invariato. |
WhatIf |
Facoltativo |
Parametro opzionale |
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente. |
Confirm |
Facoltativo |
Parametro opzionale |
Viene visualizzata una richiesta di conferma prima di eseguire il comando. |
Tipi di input
Consente di accettare l'input da pipeline contenente un oggetto indirizzo civico LIS (Location Information Server).
Tipi restituiti
Questo cmdlet non restituisce un valore.
Esempio
-------------------------- Esempio 1 --------------------------
Test-CsLisCivicAddress -HouseNumber 1234 -HouseNumberSuffix "" -PreDirectional "" -StreetName Main -StreetSuffix St -PostDirectional "" -City Redmond -State WA -PostalCode 99999 -Country US -UpdateValidationStatus
Con questo comando l'indirizzo viene convalidato, utilizzando le proprietà che corrispondono ai valori specificati in questi parametri, rispetto alla Master Street Address Guide. Si noti l'inclusione del parametro UpdateValidationStatus alla fine per aggiornare la proprietà MSAGValid dell'indirizzo.
-------------------------- Esempio 2 --------------------------
Get-CsLisCivicAddress | Test-CsLisCivicAddress -UpdateValidationStatus
Con questo esempio viene dimostrato come testare tutti gli indirizzi civici LIS. L'esempio inizia con una chiamata a Get-CsLisCivicAddress per recuperare tutti gli indirizzi civici definiti nel database delle posizioni. Questi indirizzi vengono inviati tramite pipe a Test-CsLisCivicAddress, che utilizza il servizio Web del provider del routing di rete del servizio chiamate di emergenza per convalidare ogni indirizzo.