Freigeben über


Remove-CsVoicePolicy

 

Letztes Änderungsdatum des Themas: 2012-03-24

Entfernt die angegebene VoIP-Richtlinie.

Syntax

Remove-CsVoicePolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Dieses Cmdlet entfernt eine vorhandene VoIP-Richtlinie. VoIP-Richtlinien werden zum Verwalten von Enterprise-VoIP-bezogenen Funktionen verwendet, z. B. für das gleichzeitige Klingeln (die Möglichkeit, ein zweites Telefon läuten zu lassen, wenn jemand die Nummer Ihres Bürotelefons wählt) und die Anrufweiterleitung. Dieses Cmdlet kann zudem zum Entfernen der globalen VoIP-Richtlinie verwendet werden. In diesem Fall wird die Richtlinie jedoch nicht wirklich entfernt. Stattdessen werden die Richtlinieneinstellungen einfach auf ihre Standardwerte zurückgesetzt.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Remove-CsVoicePolicy 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 "Remove-CsVoicePolicy"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Eine eindeutige ID zur Angabe des Gültigkeitsbereichs und in einigen Fällen des Namens der zu entfernenden Richtlinie.

Force

Optional

Switch-Parameter

Unterdrückt alle Bestätigungsaufforderungen, die andernfalls vor der Durchführung von Änderungen angezeigt würden.

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.Voice.VoicePolicy-Objekt. Akzeptiert eine weitergeleitete Eingabe von VoIP-Richtlinienobjekten.

Rückgabetypen

Dieses Cmdlet gibt keinen Wert zurück. Mit ihm wird eine Instanz des Objekts "Microsoft.Rtc.Management.WritableConfig.Policy.Voice.HostedVoicemailPolicy" entfernt.

Beispiel

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

Remove-CsVoicePolicy -Identity UserVoicePolicy1

In diesem Beispiel wird die benutzerbasierte VoIP-Richtlinieneinstellung "UserVoicePolicy1" entfernt.

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

Get-CsVoicePolicy -Filter tag* | Remove-CsVoicePolicy

In diesem Beispiel werden alle VoIP-Richtlinieneinstellungen entfernt, die bestimmten Benutzern zugewiesen werden können. Zunächst wird das Cmdlet Get-CsVoicePolicy mit dem Filter "tag*" aufgerufen, um alle benutzerbezogenen VoIP-Richtlinien abzurufen. Diese Richtliniensammlung wird anschließend zum Entfernen an das Cmdlet Remove-CsVoicePolicy weitergeleitet.