Freigeben über

  • Artikel

Get-CsTrunkConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-23

Ändert eine oder mehrere Trunkkonfigurationen, mit denen 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

Get-CsTrunkConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsTrunkConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Detaillierte Beschreibung

Verwenden Sie dieses Cmdlet, um eine oder mehrere Trunkkonfigurationen für PSTN-Gatewayentitäten abzurufen. 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.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsIdentity

Die eindeutige ID der Trunkkonfiguration, die abgerufen werden soll. Trunkkonfigurationen können auf globaler oder auf Standortebene bzw. für einen PSTN-Gatewaydienst auf Dienstebene festgelegt werden. Beispiel: "site:Redmond" (für den Standort) oder "PstnGateway:Redmond.litwareinc.com" (für den Dienst).

Filter

Optional

Zeichenfolge

Dieser Parameter akzeptiert eine Platzhalterzeichenfolge und gibt alle Trunkkonfigurationen zurück, deren Identitätswerte mit dieser Zeichenfolge übereinstimmen. Mit dem Filterwert "site:*" werden z. B. alle Trunkkonfigurationen zurückgegeben, die auf Standortebene definiert sind.

LocalStore

Optional

Switch-Parameter

Ruft die Trunkkonfiguration aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine.

Rückgabetypen

Mit diesem Cmdlet wird ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration" zurückgegeben.

Beispiel

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

Get-CsTrunkConfiguration

In diesem Beispiel werden alle Trunkkonfigurationen für die Microsoft Lync Server 2010-Bereitstellung abgerufen.

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

Get-CsTrunkConfiguration -Identity site:Redmond

In diesem Beispiel wird die Trunkkonfiguration mit dem Identitätswert "site:Redmond" abgerufen. Da die Identitätswerte eindeutig sind, wird mit diesem Befehl nur jeweils ein Objekt zurückgegeben.

-------------------------- Beispiel 3 --------------------------

Get-CsTrunkConfiguration -Filter site:*

In Beispiel 3 werden alle auf Standortebene definierten Trunkkonfigurationen abgerufen. Das Cmdlet Get-CsTrunkConfiguration verwendet den Parameter "Filter", um alle Trunkkonfigurationen abzurufen, deren Identitätswert mit "site:" beginnt, d. h. alle Trunkkonfigurationen, die auf Standortebene definiert sind.