• Artikel

Get-CsLocationPolicy

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen dazu zurück, wie (oder ob) der Standortinformationsdienst für 9-1-1 (erweitert) (E9-1-1) konfiguriert wurde. Mit dem E9-1-1-Dienst können Notrufoperatoren den geografischen Standort des Anrufers ermitteln (Ortung).

Syntax

Get-CsLocationPolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsLocationPolicy [-Filter <String>] [-LocalStore <SwitchParameter>]

Detaillierte Beschreibung

Mit der Ortungsrichtlinie werden Einstellungen im Zusammenhang mit der E9-1-1-Funktion angewendet. 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, wie der Anruf weitergeleitet werden soll usw. Mit diesem Cmdlet wird mindestens eine dieser Ortungsrichtlinien abgerufen.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Get-CsLocationPolicy lokal ausführen: RTCUniversalUserAdmins, 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 "Get-CsLocationPolicy"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Eine eindeutige ID für die Ortungsrichtlinie, die abgerufen werden soll. Zum Abrufen der globalen Ortungsrichtlinie verwenden Sie den Wert "Global". Für eine auf Standortebene erstellte Richtlinie erhält dieser Wert das Format "site:<Standortname>", wobei der Standortname dem Namen eines Standorts entspricht, der in der Microsoft Lync Server 2010-Bereitstellung definiert ist (z. B. "site:Redmond"). Für eine auf Benutzerebene erstellte Richtlinie entspricht dieser Wert dem Namen der Richtlinie, beispielsweise "Reno".

Filter

Optional

Zeichenfolge

Eine Zeichenfolge mit Platzhalterzeichen zum Abrufen von Ortungsrichtlinien, deren Identitätswert mit der Platzhalterzeichenfolge übereinstimmt.

LocalStore

Optional

Switch-Parameter

Ruft die Informationen zu den Ortungsrichtlinien aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine.

Rückgabetypen

Mit Get-CsLocationPolicy werden Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy" zurückgegeben.

Beispiel

-------------------------- Beispiel 1 --------------------------

Get-CsLocationPolicy

In Beispiel 1 wird eine Auflistung aller derzeit in der Organisation verwendeten Ortungsrichtlinien zurückgegeben. Dazu wird einfach Get-CsLocationPolicy ohne Parameter aufgerufen.

-------------------------- Beispiel 2 --------------------------

Get-CsLocationPolicy -Identity Reno

Der Befehl in Beispiel 2 gibt nur Ortungsrichtlinien mit der Identität "Reno" zurück. Da Identitäten eindeutig sein müssen, wird mit diesem Befehl immer nur maximal eine Ortungsrichtlinie zurückgegeben.

-------------------------- Beispiel 3 --------------------------

Get-CsLocationPolicy -Filter tag:*

Im vorstehenden Befehl wird der Parameter "Filter" verwendet, um alle Ortungsrichtlinien zurückzugeben, die auf Benutzerebene konfiguriert wurden. (Eine auf Benutzerebene konfigurierte Richtlinie kann Benutzern und Netzwerkstandorten direkt zugewiesen werden.) Mit der Platzhalterzeichenfolge "tag:*" werden die von Get-CsLocationPolicy zurückgegebenen Daten auf die Ortungsrichtlinien beschränkt, deren Identitätswert mit der Zeichenfolge "tag:" beginnt. Auch wenn Sie das Präfix "tag:" nicht zum Abrufen einer einzelnen Richtlinie angeben müssen, können Sie es zum Filtern nach allen benutzerbasierten Richtlinien verwenden.

-------------------------- Beispiel 4 --------------------------

Get-CsLocationPolicy | Where-Object {$_.EnhancedEmergencyServicesEnabled -eq $False}

In Beispiel 4 wird eine Auflistung aller Ortungsrichtlinien zurückgegeben, wenn die Notrufunterstützungsdienste deaktiviert wurden. Dazu gibt der Befehl zunächst mit Get-CsLocationPolicy eine Auflistung aller derzeit in der Organisation verwendeten Ortungsrichtlinien zurück. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet. Das Cmdlet Where-Object wendet wiederum einen Filter an, um die zurückgegebenen Daten auf diejenigen Richtlinien zu beschränken, bei denen die Eigenschaft "EnhancedEmergencyServicesEnabled" den Wert "False" ($False) aufweist (der Vergleichsoperator "-eq" steht für "equal to").