Freigeben über


Remove-CsVoiceTestConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-25

Entfernt eine VoIP-Testkonfiguration, die zum Testen von Routen und Regeln für Telefonnummern verwendet wird.

Syntax

Remove-CsVoiceTestConfiguration -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Vor der Implementierung von VoIP-Routen und -Richtlinien ist es sinnvoll, diese Einstellungen für verschiedene Telefonnummern zu testen, um die erwartete Funktionsweise sicherzustellen. Wenn Sie diese Tests abgeschlossen haben und nicht mehr benötigen, verwenden Sie dieses Cmdlet, um die Testkonfigurationen zu entfernen.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsGlobalRelativeIdentity

Eine Zeichenfolge zum eindeutigen Identifizieren der Testkonfiguration, die entfernt werden soll.

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

Rückgabetypen

Entfernt ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration".

Beispiel

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

Remove-CsVoiceTestConfiguration -Identity TestConfig1

In diesem Beispiel werden die Einstellungen für die VoIP-Testkonfiguration mit dem Identitätswert "TestConfig1" entfernt.

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

Get-CsVoiceTestConfiguration -Filter *test* | Remove-CsVoiceTestConfiguration

In diesem Beispiel werden alle VoIP-Testkonfigurationseinstellungen für beliebige Konfigurationen entfernt, deren Parameter "Identity" die Zeichenfolge "test" enthält. Mit dem Befehl wird zunächst das Cmdlet Get-CsVoiceTestConfiguration mit dem Parameter "Filter" aufgerufen, um alle VoIP-Testkonfigurationen abzurufen, deren Parameter "Identity" an beliebiger Stelle den Wert "test" aufweist. Die zurückgegebenen Konfigurationen werden anschließend an das Cmdlet Remove-CsVoiceTestConfiguration weitergeleitet und entfernt.