• Artikel

Remove-CsVoiceConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-27

Setzt die VoIP-Konfiguration auf die Standardwerte zurück.

Syntax

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

Detaillierte Beschreibung

VoIP-Testkonfigurationen werden dazu verwendet, eine bestimmte VoIP-Richtlinie, -Route und einen bestimmten Satz mit Wähleinstellungen für eine Telefonnummer zu testen. Mit diesem Cmdlet wird die globale (und einzige) VoIP-Konfiguration entfernt, bei der es sich um einen Container für alle VoIP-Testkonfigurationen handelt, die für eine Microsoft Lync Server 2010-Bereitstellung definiert sind. "Entfernen" bedeutet in diesem Fall nicht, dass die VoIP-Konfiguration tatsächlich entfernt wird. Die globale Instanz ist weiterhin vorhanden. Die Liste der VoIP-Testkonfigurationen wird jedoch auf die Standardeinstellung festgelegt, eine leere Liste.

WARNUNG: Das Entfernen der VoIP-Konfiguration (d. h. das Festlegen einer leeren VoIP-Testkonfigurationsliste) löscht alle definierten VoIP-Testkonfigurationen für eine Lync Server 2010-Bereitstellung. Nach dem Aufruf dieses Cmdlets liefert ein Aufruf von Get-CsVoiceTestConfiguration keine Ergebnisse.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Der Gültigkeitsbereich der VoIP-Konfiguration, die entfernt werden soll. Dieser Wert muss "Global" lauten.

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.VoiceConfiguration-Objekt. Akzeptiert eine weitergeleitete Eingabe von VoIP-Objekten.

Rückgabetypen

Mit diesem Cmdlet wird ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoiceConfiguration" entfernt (bzw. zurückgesetzt).

Beispiel

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

Remove-CsVoiceConfiguration -Identity Global -Confirm

In diesem Beispiel wird die globale (und einzige) VoIP-Konfiguration auf die Standardwerte zurückgesetzt. Da bei dieser Aktion alle definierten VoIP-Testkonfigurationen gelöscht werden, wurde der Parameter "Confirm" hinzugefügt, um eine Meldung anzuzeigen, in der diese Aktion vor dem Entfernen bestätigt werden muss.