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.
Siehe auch
Weitere Ressourcen
Set-CsVoiceConfiguration
Get-CsVoiceConfiguration
Remove-CsVoiceTestConfiguration
Get-CsVoiceTestConfiguration