• Artikel

Grant-CsLocationPolicy

 

Letztes Änderungsdatum des Themas: 2012-03-23

Weist individuellen Benutzern oder Gruppen eine Ortungsrichtlinie für 9-1-1 (erweitert) (E9-1-1) zu. Mit dem E9-1-1-Dienst können Notrufoperatoren den geografischen Standort des Anrufers ermitteln (Ortung).

Syntax

Grant-CsLocationPolicy -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<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, und wie der Anruf weitergeleitet werden soll. Mit diesem Cmdlet wird einem spezifischen Benutzer oder einer spezifischen Gruppe eine Ortungsrichtlinie zugewiesen.

WICHTIG: Das Verhalten der Ortungsrichtlinie unterscheidet sich in Bezug auf den Gültigkeitsbereich vom Verhalten anderer Richtlinien in Microsoft Lync Server 2010. Alle anderen Richtlinien werden, sofern eine Richtlinie auf Benutzerbasis definiert wurde, auf alle Benutzer angewendet, denen diese Richtlinie zugewiesen ist. Wurde dem Benutzer keine Richtlinie auf Benutzerebene zugewiesen, wird die Ortungsrichtlinie angewendet. Wenn es keine Ortungsrichtlinie gibt, gilt die globale Richtlinie. Ortungsrichtlinien werden in gleicher Weise angewendet, jedoch mit einer Ausnahme: eine Ortungsrichtlinie auf Benutzerbasis kann auch einem Netzwerkstandort zugewiesen werden. (Ein Netzwerk umfasst eine Gruppe von Subnetzen.) Wenn der Benutzer den Notruf von einem Standort aus tätigt, der einem Netzwerkstandort innerhalb der Organisation zugeordnet ist, wird die diesem Netzwerkstandort zugewiesene Richtlinie auf Benutzerebene verwendet. Diese Funktionalität setzt eine Richtlinie auf Benutzerbasis außer Kraft, die diesem Benutzer zugewiesen wurde. Wenn der Benutzer den Anruf von einem unbekannten oder innerhalb der Organisation nicht zugeordneten Standort aus tätigt, wird der Geltungsbereich der Standardrichtlinie verwendet.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

UserIdParameter

Gibt den Identitätswert des Benutzerkontos an, dem die Richtlinie zugewiesen werden soll. Benutzeridentitäten können in den folgenden vier Formaten angegeben werden: als 1) SIP-Adresse des Benutzers, 2) UPN (User Principal Name) des Benutzers, 3) Domänen- und Anmeldename des Benutzers (mit dem Format "Domäne\Anmeldename", z. B. "litwareinc\kenmyer") und 4) Active Directory-Anzeigename des Benutzers (z. B. "Ken Myer"). Beachten Sie, dass "SAMAccountName" nicht als Identitätswert verwendet werden kann.

Ferner können Sie das Sternchen (*) als Platzhalterzeichen verwenden, wenn Sie den Anzeigenamen als Benutzeridentität verwenden. Wenn als Identitätswert z. B. "* Smith" angegeben wird, wird die Richtlinie allen Benutzern mit dem Familiennamen Smith zugewiesen.

DomainController

Optional

FQDN

Ermöglicht die Angabe eines Domänencontrollers. Wenn kein Domänencontroller angegeben ist, wird der erste verfügbare Domänencontroller verwendet.

PassThru

Optional

Switch-Parameter

Bei Verwendung dieses Parameters (der keinen Wert aufweist) werden die Benutzerinformationen angezeigt, nachdem das Cmdlet beendet wurde. In der Regel erfolgt keine Ausgabe, wenn dieses Cmdlet ausgeführt wird.

PolicyName

Optional

Zeichenfolge

Der Identitätswert der für den Benutzer geltenden Ortungsrichtlinie.

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

Zeichenfolge. Akzeptiert einen weitergeleiteten Zeichenfolgenwert, der den Identitätswert eines Benutzerkontos repräsentiert, dem die Ortungsrichtlinie zugewiesen wird.

Rückgabetypen

Bei Verwendung mit dem Parameter "PassThru" wird ein Objekt vom Typ "Microsoft.Rtc.Management.ADConnect.Schema.OCSADUserOrAppContact" zurückgegeben.

Beispiel

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

Grant-CsLocationPolicy -Identity "Ken Myer" -PolicyName Reno

In Beispiel 1 wird die Ortungsrichtlinie "Reno" mithilfe von Grant-CsLocationPolicy dem Benutzer "Ken Myer" zugewiesen.

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

Get-CsUser -LDAPFilter "Department=Accounting" | Grant-CsLocationPolicy -PolicyName AccountingArea

In Beispiel 2 wird die Richtlinie "AccountingArea" allen Benutzern in der Abteilung "Accounting" zugewiesen. Um eine Auflistung aller Benutzer in der Abteilung "Accounting" zurückzugeben, wird das Cmdlet Get-CsUser mit dem Parameter "LDAPFilter" verwendet. Der an "LDAPFilter" weitergeleitete Abfragewert – "Department=Accounting" – gibt alle Benutzer zurück, deren Active Directory-Einstellung für die Abteilung "Accounting" lautet. Diese Auflistung wird dann an das Cmdlet Grant-CsLocationPolicy weitergeleitet, das jedem Benutzer in der Auflistung die Richtlinie "AccountingArea" zuweist.

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

Grant-CsLocationPolicy -Identity "Ken Myer" -PolicyName Reno -PassThru | Select-Object DisplayName, LocationPolicy

In diesem Beispiel wird dem Benutzer mit dem Identitätswert (in diesem Fall dem Anzeigenamen) "Ken Myer" die Ortungsrichtlinie "Reno" zugewiesen. In diesem Beispiel ist darüber hinaus der Parameter "PassThru" enthalten, über den im Anschluss an die Zuweisung der Ortungsrichtlinie die Benutzerinformationen für "Ken Myer" angezeigt werden. Die Benutzerinformationen werden allerdings nicht sofort in der Konsole angezeigt, sondern an das Cmdlet Select-Object weitergeleitet, das nur die Eigenschaften "DisplayName" und "LocationPolicy" des Benutzers anzeigt.

Bei diesem Beispiel sollte beachtet werden, dass die neu zugewiesene Ortungsrichtlinie in der Ausgabe unter "LocationPolicy" angezeigt wird, jedoch als Anchor-Wert und nicht als Richtlinienname. (Ein Anchor-Wert ist ein numerischer Wert, der einer Richtlinie automatisch bei der Erstellung zugewiesen wird.) Führen Sie den Befehl "Get-CsUser –Identity "Ken Myer" | Select-Object DisplayName, LocationPolicy" aus, um zu prüfen, ob der Richtlinienname zugewiesen wurde.