Test-CsLisCivicAddress
Letztes Änderungsdatum des Themas: 2012-03-25
Vergleicht eine oder mehrere allgemeine Adressen mit der MSAG-Datenbank (Master Street Address Guide).
Syntax
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>]]
Detaillierte Beschreibung
Bei einer Enterprise-VoIP-Implementierung mit 9-1-1 (erweitert) (E9-1-1) wird der Standort des Benutzers basierend auf Standortzuordnungen bestimmt, die ein Subnetz, einen Port, einen Switch oder einen drahtlosen Zugriffspunkt einem Standort zuordnen. (Ist keine Verbindung mit einem zugeordneten Standort vorhanden, wird der Benutzer möglicherweise zur manuellen Eingabe seines Standorts aufgefordert.) Die Adresse dieser Standorte muss vom E9-1-1-Netzwerkroutinganbieter anhand der MSAG-Datenbank (Master Street Address Guide) überprüft werden. Dieses Cmdlet verwendet den Webdienst dieses Anbieters zum Überprüfen der zugeordneten Adressen. Sie können einen Dienstanbieter einrichten, indem Sie das Cmdlet Set-CsLisServiceProvider aufrufen.
Wenn Sie die Eigenschaft "MSAGValid" der allgemeinen Adresse aktualisieren möchten, stellen Sie sicher, dass der Parameter "UpdateValidationStatus" in Ihrem Aufruf von Test-CsLisCivicAddress enthalten ist. Verwenden Sie das Cmdlet Get-CsLisCivicAddress, um allgemeine Adressen abzurufen.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Test-CsLisCivicAddress lokal auszuführen: RTCUniversalServerAdmins. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsLisCivicAddress"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
City |
Optional |
Zeichenfolge |
Der Ortsname des Standorts. Maximale Länge: 64 Zeichen. |
Country |
Optional |
Zeichenfolge |
Das Land bzw. die Region, in dem bzw. der der Standort liegt. Maximale Länge: 2 Zeichen. |
HouseNumber |
Optional |
Zeichenfolge |
Die Hausnummer dieses Standorts. Bei einem Unternehmen ist dies die Hausnummer des Unternehmens. Maximale Länge: 10 Zeichen. |
HouseNumberSuffix |
Optional |
Zeichenfolge |
Zusätzliche Informationen für die Hausnummer wie "1/2" oder "A". Beispiel: "1234 1/2 Oak Street" oder "1234 A Elm Street". Maximale Länge: 5 Zeichen. |
PostalCode |
Optional |
Zeichenfolge |
Die Postleitzahl des Standorts. Maximale Länge: 10 Zeichen. |
PostDirectional |
Optional |
Zeichenfolge |
Angaben zur Himmelsrichtung als Teil des Straßennamens. Beispiel: NE oder NW für "Main Street NE" oder "7th Avenue NW". Maximale Länge: 2 Zeichen. |
PreDirectional |
Optional |
Zeichenfolge |
Angabe der Himmelsrichtung als Teil des Straßennamens, die vor dem Straßennamen steht. Beispiel: NE oder NW für "NE Main Street" oder "NW 7th Avenue". Maximale Länge: 2 Zeichen. |
State |
Optional |
Zeichenfolge |
Das Bundesland oder der Kanton, in dem sich der Standort befindet. Maximale Länge: 2 Zeichen. |
StreetName |
Optional |
Zeichenfolge |
Der Straßenname für den Standort. Maximale Länge: 60 Zeichen. |
StreetSuffix |
Optional |
Zeichenfolge |
Der Straßentyp als Teil des Straßennamens, z. B. "Street", "Avenue" oder "Court". Maximale Länge: 10 Zeichen. |
UpdateValidationStatus |
Optional |
Switch-Parameter |
Dieser Parameter ändert die Eigenschaft "MSAGValid" in Abhängigkeit davon, ob die Adresse durch dieses Cmdlet bestätigt wird. Wenn die Adresse gültig ist, wird "MSAGValid" auf "True" festgelegt. Bei Auslassung dieses Parameters bleibt der Wert für "MSAGValid" unverändert. |
WhatIf |
Optional |
Switch-Parameter |
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen. |
Confirm |
Optional |
Switch-Parameter |
Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf. |
Eingabetypen
Akzeptiert eine weitergeleitete Eingabe von LIS-Objekten (Location Information Server) mit allgemeinen Adressinformationen.
Rückgabetypen
Dieses Cmdlet gibt keinen Wert zurück.
Beispiel
-------------------------- Beispiel 1 --------------------------
Test-CsLisCivicAddress -HouseNumber 1234 -HouseNumberSuffix "" -PreDirectional "" -StreetName Main -StreetSuffix St -PostDirectional "" -City Redmond -State WA -PostalCode 99999 -Country US -UpdateValidationStatus
Mit diesem Befehl wird die Adresse, deren Eigenschaften mit den in diesen Parametern angegebenen Werten übereinstimmen, anhand der MSAG-Datenbank überprüft. Beachten Sie die Verwendung des Parameters "UdateValidationStatus" am Ende des Befehls: Hierdurch wird die Eigenschaft "MSAGValid" der Adresse aktualisiert.
-------------------------- Beispiel 2 --------------------------
Get-CsLisCivicAddress | Test-CsLisCivicAddress -UpdateValidationStatus
In diesem Beispiel wird das Überprüfen aller allgemeinen LIS-Adressen dargestellt. Zunächst wird Get-CsLisCivicAddress aufgerufen, um alle allgemeinen Adressen abzurufen, die in der Standortdatenbank definiert sind. Diese Adressen werden an das Cmdlet Test-CsLisCivicAddress weitergeleitet, das jede Adresse über den Netzwerkroutinganbieter-Webdienst für E9-1-1 überprüft.