Remove-CsLocationPolicy
Letztes Änderungsdatum des Themas: 2012-03-27
Entfernt die angegebene Ortungsrichtlinie. (Ortungsrichtlinien werden im Zusammenhang mit dem E9-1-1-Dienst (9-1-1 (erweitert)) verwendet, damit Notrufoperatoren basierend auf der Telefonnummer oder des verwendeten Geräts den geografischen Standort des Anrufers ermitteln können.)
Syntax
Remove-CsLocationPolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <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. Dieses Cmdlet entfernt eine vorhandene Ortungsrichtlinie.
Zusätzlich zum Entfernen von Ortungsrichtlinien auf Standort- und Benutzerebene können Sie mit diesem Cmdlet auch die globale Ortungsrichtlinie entfernen. In diesem Fall wird die Richtlinie jedoch nicht wirklich entfernt. Stattdessen werden die Richtlinieneinstellungen einfach auf ihre Standardwerte zurückgesetzt.
Wenn dieses Cmdlet für eine Ortungsrichtlinie auf Benutzerebene ausgeführt wird, müssen Sie den Löschvorgang bestätigen.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Remove-CsLocationPolicy lokal ausfü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 "Remove-CsLocationPolicy"}
Parameter
Parameter | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Identity |
Erforderlich |
XdsIdentity |
Die eindeutige ID der Ortungsrichtlinie, die entfernt werden soll. Um die globale Ortungsrichtlinie zu entfernen (die Richtlinie wird lediglich auf ihre Standardwerte zurückgesetzt), 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"). Bei einer Richtlinie, die auf Benutzerebene erstellt wurde, entspricht dieser Wert einfach dem Namen der Richtlinie, z. B. "Bldg30Floor3Sector1". |
Force |
Optional |
Switch-Parameter |
Bei Angabe dieses Parameters werden alle Bestätigungsaufforderungen umgangen, und der Löschvorgang wird ohne Warnung durchgeführt. Wenn beispielsweise eine Ortungsrichtlinie auf Benutzerebene einem oder mehreren Benutzern zugewiesen ist, wird vor dem Löschen eine Bestätigungsaufforderung angezeigt, wenn dieser Parameter nicht in den Befehl eingeschlossen wurde. |
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
Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy-Objekt. Akzeptiert eine weitergeleitete Eingabe von Ortungsrichtlinienobjekten.
Rückgabetypen
Dieses Cmdlet gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy" entfernt.
Beispiel
-------------------------- Beispiel 1 --------------------------
Remove-CsLocationPolicy -Identity Reno
Der in Beispiel 1 gezeigte Befehl verwendet Remove-CsLocationPolicy, um die Ortungsrichtlinie mit dem Identitätswert "Reno" zu löschen. Wenn eine Richtlinie auf Benutzerebene entfernt wird, wird für alle Benutzer oder Gruppen, denen zuvor diese Richtlinie zugewiesen war, automatisch die für ihren Standort konfigurierte Richtlinie verwendet. Wenn für den Standort keine Richtlinie konfiguriert wurde, wird die globale Ortungsrichtlinie auf diese Benutzer und Gruppen angewendet.
-------------------------- Beispiel 2 --------------------------
Get-CsLocationPolicy | Where-Object {$_.EnhancedEmergencyServicesEnabled -eq $false} | Remove-CsLocationPolicy
In Beispiel 2 werden alle Ortungsrichtlinien gelöscht, bei denen die Eigenschaft "EnhancedEmergencyServicesEnabled" den Wert "False" aufweist. (Anders ausgedrückt, es werden alle Ortungsrichtlinien gelöscht, die E9-1-1 nicht aktivieren.) Hierzu verwendet der Befehl zunächst Get-CsLocationPolicy, um alle Ortungsrichtlinien abzurufen, die derzeit in der Organisation verwendet werden. Diese Auflistung wird an das Cmdlet Where-Object weitergeleitet, das mithilfe eines Filters die zurückgegebenen Daten auf diejenigen Richtlinien beschränkt, deren Eigenschaft "EnhancedEmergencyServicesEnabled" den Wert "False" ($False) aufweist (der Vergleichsoperator "-eq" steht für "equal to"). Abschließend wird die gefilterte Auflistung an das Cmdlet Remove-CsLocationPolicy weitergeleitet, das jede Richtlinie in der Auflistung löscht.
Siehe auch
Weitere Ressourcen
New-CsLocationPolicy
Set-CsLocationPolicy
Get-CsLocationPolicy
Grant-CsLocationPolicy
Test-CsLocationPolicy