• Artikel

Remove-CsHostedVoicemailPolicy

 

Letztes Änderungsdatum des Themas: 2012-03-27

Entfernt eine gehostete Voicemailrichtlinie.

Syntax

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

Detaillierte Beschreibung

Dieses Cmdlet entfernt eine Richtlinie, über die angegeben wird, wie nicht entgegengenommene Anrufe für Benutzer an einen gehosteten Exchange Unified Messaging (UM)-Dienst weitergeleitet werden.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Eine eindeutige ID für die gehostete Voicemailrichtlinie, die entfernt werden soll. Diese ID umfasst den Gültigkeitsbereich (im Fall von globalen Richtlinien), den Gültigkeitsbereich und den Standort (für eine Richtlinie auf Standortebene, z. B. "site:Redmond") oder den Richtliniennamen (für eine benutzerbasierte Richtlinie, z. B. "HVUserPolicy").

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

Rückgabetypen

Dieses Cmdlet gibt kein Objekt zurück. Mit ihm wird ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Policy.Voice.HostedVoicemailPolicy" entfernt.

Beispiel

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

Remove-CsHostedVoicemailPolicy -Identity ExRedmond

Dieser Befehl entfernt die gehostete Voicemailrichtlinie für die benutzerbasierte Richtlinie "ExRedmond".

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

Get-CsHostedVoicemailPolicy -Filter tag* | Remove-CsHostedVoicemailPolicy

Der Befehl in Beispiel 2 entfernt sämtliche benutzerbasierten gehosteten Voicemailrichtlinien. Der Befehl ruft zunächst das Cmdlet Get-CsHostedVoicemailPolicy mit dem Filter "tag*" auf, das alle benutzerbasierten Richtlinien abruft. Der Richtliniensatz wird dann an Remove-CsHostedVoicemailPolicy weitergeleitet, das die einzelnen Richtlinien löscht.