• Artikel

Remove-CsTrunkConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-26

Entfernt eine vorhandene Trunkkonfiguration, mit der die Einstellungen für eine Trunkpeerentität wie z. B. ein PSTN-Gateway, eine IP-Nebenstellenanlage oder einen SBC (Session Border Controller) des Dienstanbieters definiert werden.

Syntax

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

Detaillierte Beschreibung

Verwenden Sie dieses Cmdlet, um eine Trunkkonfiguration für PSTN-Gatewayentitäten zu entfernen. Jede Konfiguration umfasst spezifische Einstellungen für eine Trunkpeerentität, wie z. B. ein PSTN-Gateway, eine IP-Nebenstellenanlage oder einen SBC (Session Border Controller) des Dienstanbieters. Diese Einstellungen konfigurieren beispielsweise, ob die Medienumgehung auf diesem Trunk aktiviert ist, ob unter bestimmten Bedingungen RTCP-Pakete (Real-Time Transport Control Protocol) gesendet werden und ob die sichere SRTP-Verschlüsselung (Secure Real-Time Transport Protocol) erforderlich ist.

Beachten Sie, dass wenn Sie Remove-CsTrunkConfiguration für die globale Konfiguration aufrufen, die Trunkkonfiguration nicht entfernt wird. Stattdessen wird die Konfiguration zurückgesetzt, und alle benutzerdefinierten Einstellungen werden durch die Standardwerte ersetzt.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Die eindeutige ID der Trunkkonfiguration, 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.Settings.TrunkConfiguration.TrunkConfiguration-Objekt. Akzeptiert eine weitergeleitete Eingabe von Trunkkonfigurationsobjekten.

Rückgabetypen

Dieses Cmdlet gibt keinen Wert zurück. Es entfernt ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration".

Beispiel

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

Remove-CsTrunkConfiguration -Identity site:Redmond

In diesem Beispiel wird die Trunkkonfiguration mit dem Identitätswert "site:Redmond" entfernt.

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

Get-CsTrunkConfiguration -Filter site:* | Remove-CsTrunkConfiguration

In Beispiel 2 werden alle auf Standortebene definierten Trunkkonfigurationen entfernt. Mit dem Befehl wird zunächst das Cmdlet Get-CsTrunkConfiguration mit dem Parameter "Filter" aufgerufen, um alle Trunkkonfigurationen abzurufen, deren Identitätswert mit "site:" beginnt (d. h. alle Trunkkonfigurationen, die auf Standortebene definiert sind). Diese Auflistung wird dann an das Cmdlet Remove-CsTrunkConfiguration weitergeleitet, das jedes Objekt in der Auflistung entfernt.