Test-CsLocationPolicy
Letztes Änderungsdatum des Themas: 2012-03-26
Führt einen Test zum Bestimmen der Ortungsrichtlinie aus, die basierend auf den in den Parameterwerten angegebenen Kriterien verwendet wird. Die Ortungsrichtlinie enthält die Einstellungen, die bestimmen, ob und wie 9-1-1 (erweitert) (E9-1-1) zum Tragen kommt. Mit E9-1-1 können Notrufoperatoren den geografischen Standort des Anrufers ermitteln.
Syntax
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>]
Detaillierte Beschreibung
Mit der Ortungsrichtlinie werden Einstellungen im Zusammenhang mit der E9-1-1-Funktion und dem Clientstandort zugewiesen. Die Ortungsrichtlinie ermittelt, ob E9-1-1 für einen Benutzer aktiviert ist, und legt ggf. das Verhalten eines Notrufs fest. Sie können mit der Ortungsrichtlinie beispielsweise definieren, welche Nummer als Notrufnummer betrachtet wird, ob die Abteilung für Unternehmenssicherheit automatisch benachrichtigt werden soll, und wie der Anruf weitergeleitet werden soll. Dieses Cmdlet gibt Informationen zur Ortungsrichtlinie zurück, die genutzt werden, wenn ein bestimmter Client in einem bestimmten Pool, Subnetz oder einen bestimmten Switch oder drahtlosen Zugriffspunkt einen Anruf tätigt.
Wenn im Aufruf dieses Cmdlets kein Benutzer angegeben ist, wird der gegenwärtig konfigurierte Benutzer getestet. Rufen Sie Get-CsHealthMonitoringConfiguration auf, um den aktuell konfigurierten Benutzer zu bestimmen. Rufen Sie Set-CsHealthMonitoringConfiguration auf, um den konfigurierten Benutzer festzulegen.
Wenn eine Ortungsrichtlinie für den Benutzer oder das Subnetz gefunden wurde, hat der Test Erfolg. Zu den standardmäßig zurückgegebenen Informationen gehört der Name der Ortungsrichtlinie (falls eine benutzerbasierte Richtlinie zugewiesen ist) und ob der Benutzer oder das Subnetz für E9-1-1 aktiviert ist. Fügen Sie den allgemeinen Windows PowerShell-Parameter "Verbose" hinzu, um zusätzliche Informationen zum Test abzurufen.
Sie können Ortungsrichtlinien für Benutzer oder Netzwerksubnetze testen. Wenn Sie den Test für ein Subnetz ausführen (indem Sie einen Wert für den Parameter "Subnet" angeben), versucht das Cmdlet, die Ortungsrichtlinie für dieses Subnetz aufzulösen. Wenn dem Subnetz keine Ortungsrichtlinie zugewiesen ist, wird die Ortungsrichtlinie für den konfigurierten Benutzer abgerufen. Wenn die Subnetzrichtlinie erfolgreich abgerufen wird, enthält die Ausgabe den mit "subnet-tagid" beginnenden Wert "LocationPolicyTagID". Wenn keine Ortungsrichtlinie für das Subnetz gefunden wurde, beginnt die "LocationPolicyTagID" mit "user-tagid".
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Test-CsLocationPolicy 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-CsLocationPolicy"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
TargetFqdn |
Erforderlich |
Zeichenfolge |
Der vollqualifizierte Domänenname (FQDN) des Pools, in dem sich der angegebene Benutzer bzw. das Subnetz befindet. (Ist kein Benutzer angegeben, wird der vorkonfigurierte oder aktuelle Benutzer angenommen.) |
OutVerboseVariable |
Optional |
Zeichenfolge |
Falls angegeben, wird nach Ausführung des Cmdlets die detaillierte Ausgabe in der angegebenen Variablen gespeichert. Geben Sie beispielsweise die folgende Syntax an, um die Ausgabe in der Variablen "$Testausgabe" zu speichern: -OutVerboseVariable Testausgabe Setzen Sie kein Dollarzeichen ($) vor den Variablennamen. |
RegistrarPort |
Optional |
Ganze Zahl |
Die Portnummer des Registrierungsdiensts. |
Subnet |
Optional |
Zeichenfolge |
Die ID (IP-Adresse) des Netzwerksubnetzes, für das Sie die Ortungsrichtlinie testen möchten. |
UserCredential |
Optional |
PS-Objekt mit Anmeldeinformationen |
Ein Objekt mit Benutzer-ID und Kennwort des Benutzerkontos, dessen Ortungsrichtlinie getestet wird. Ein Objekt mit Anmeldeinformationen kann abgerufen werden, indem das Windows PowerShell-Cmdlet Get-Credential aufgerufen wird, die entsprechenden Informationen eingegeben werden und die Ausgabe in einer Variablen gespeichert wird. |
UserSipAddress |
Optional |
SIP-Adresse |
Die SIP-Adresse des Benutzers, dessen Ortungsrichtlinie Sie testen möchten. Diese muss das Format "sip:<Benutzer-ID>" haben, z. B. sip:kenmyer@litwareinc.com. |
Force |
Optional |
Switch-Parameter |
Unterdrückt alle Bestätigungsaufforderungen, die andernfalls vor der Durchführung von Änderungen angezeigt würden. |
Eingabetypen
Keine.
Rückgabetypen
Test-CsLocationPolicy gibt eine Instanz des Objekts "Microsoft.Rtc.SyntheticTransactions.TaskOutput" zurück.
Beispiel
-------------------------- Beispiel 1 --------------------------
Test-CsLocationPolicy -TargetFqdn atl-cs-001.litwareinc.com
In diesem Beispiel wird die Ortungsrichtlinie des aktuellen Benutzers (bzw. aktuell konfigurierten Benutzers) bestimmt. "TargetFqdn" ist erforderlich.
-------------------------- Beispiel 2 --------------------------
$cred = Get-Credential "litwareinc\kenmyer"
Test-CsLocationPolicy -TargetFqdn atl-cs-001.litwareinc.com -UserCredential $cred -UserSipAddress "sip:kenmyer@litwareinc.com"
Die erste Zeile in Beispiel 2 ist ein Aufruf des Windows PowerShell-Cmdlets Get-Credential. Dieses Cmdlet ruft die Benutzeranmeldeinformationen ab und gibt diese als sicheres Objekt zurück. Der einzige Parameter, der für dieses Cmdlet angegeben wird, ist die Benutzer-ID. Bei Ausführung dieses Cmdlets wird ein Dialogfeld geöffnet, das mit der Benutzer-ID vorab ausgefüllt wird und ein Textfeld aufweist, das die Eingabe des Benutzerkennworts ermöglicht. Diese Benutzeranmeldeinformationen werden in der Variablen "$cred" gespeichert.
In Zeile 2 wird das Cmdlet Test-CsLocationPolicy aufgerufen. Wie in Beispiel 1 muss "TargetFqdn" angegeben werden. Doch in diesem Beispiel wird nicht der vorkonfigurierte Benutzer verwendet, sondern der Test für einen Benutzer mit der SIP-Adresse "kenmyer@litwareinc.com" ausgeführt. Dieser Wert (mit dem Präfix "sip:") wird an den Parameter "UserSipAddress", und die (in der Variablen "$cred") gespeicherten Anmeldeinformationen werden an den Parameter "UserCredential" übergeben.
-------------------------- Beispiel 3 --------------------------
Test-CsLocationPolicy -TargetFqdn atl-cs-001.litwareinc.com -UserSipAddress "sip:kenmyer@litwareinc.com"
Dieses Beispiel ähnelt Beispiel 2, doch es werden keine Benutzeranmeldeinformationen angegeben. Wenn Test-CsLocationPolicy ohne Angabe von Benutzeranmeldeinformationen aufgerufen wird, dient das Serverzertifikat des Computers, auf dem das Cmdlet ausgeführt wird, zum Authentifizieren und Ermitteln der Ortungsrichtlinie des Benutzers. Wenn der Computer kein Serverzertifikat hat, müssen Sie Anmeldeinformationen angeben (siehe Beispiel 2). Um zu ermitteln, ob es ein Serverzertifikat für den Computer gibt, rufen Sie das Cmdlet Get-CsCertificate auf.
-------------------------- Beispiel 4 --------------------------
Test-CsLocationPolicy -TargetFqdn atl-cs-001.litwareinc.com -Subnet 172.15.11.0
In diesem Beispiel wird die Ortungsrichtlinie des Subnetzes mit der ID 172.15.11.0 bestimmt. Wenn dem Subnetz keine Ortungsrichtlinie zugewiesen ist, wird die Ortungsrichtlinie für den aktuell konfigurierten Benutzer abgerufen.
Hinweis: Eine Ortungsrichtlinie wird für ein Subnetz festgelegt, indem der Parameter "LocationPolicy" des Cmdlets Set-CsNetworkSite auf die Ortungsrichtlinien-ID festgelegt wird und anschließend der Parameter "NetworkSiteId" des Cmdlets Set-CsNetworkSubnet auf die ID dieses Standorts festgelegt wird. Beispiel:
Set-CsNetworkSite Portland –LocationPolicy Reno
Set-CsNetworkSubnet 175.15.11.0 –NetworkSiteID Portland