Freigeben über


Get-CsNetworkInterSitePolicy

 

Letztes Änderungsdatum des Themas: 2012-03-23

Ruft eine oder mehrere standortübergreifende Netzwerkrichtlinien ab, die die Bandbreiteneinschränkungen zwischen Standorten definieren, die in einer Anrufsteuerungskonfiguration direkt verbunden sind.

Syntax

Get-CsNetworkInterSitePolicy [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

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

Detaillierte Beschreibung

Wenn Netzwerkstandorte eine direkte Verbindung teilen, können Bandbreiteneinschränkungen für Audio- und Videoverbindungen zwischen diesen zwei Standorten definiert werden. Mit diesem Cmdlet werden eine oder mehrere Netzwerkstandortrichtlinien abgerufen, die die Einstellungen zur Bandbreiteneinschränkung den direkt verbundenen Standorten zuordnen.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsGlobalRelativeIdentity

Die eindeutige ID der Netzwerkstandortrichtlinie, die abgerufen werden soll. Netzwerkstandortrichtlinien werden ausschließlich global erstellt, sodass mit dieser ID kein Gültigkeitsbereich festgelegt werden muss. Stattdessen ist eine Zeichenfolge enthalten, die den eindeutigen Namen zur Identifizierung dieser Richtlinie darstellt.

Filter

Optional

Zeichenfolge

Eine Zeichenfolge mit Platzhalterzeichen, mit der Richtlinien mit Identitätswerten durchsucht werden, die mit der Platzhalterzeichenfolge übereinstimmen.

LocalStore

Optional

Switch-Parameter

Ruft die standortübergreifenden Netzwerkrichtlinieninformationen aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine.

Rückgabetypen

Ruft ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkSitePolicyType" ab.

Beispiel

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

Get-CsNetworkInterSitePolicy

Mit dem Aufruf von Get-CsNetworkInterSitePolicy ohne Parameter werden alle Netzwerkstandortrichtlinien abgerufen, die zwischen zwei direkt miteinander verbundenen Netzwerkstandorten definiert sind.

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

Get-CsNetworkInterSitePolicy -Identity Reno_Portland

In diesem Beispiel wird die Netzwerkstandortrichtlinie mit dem Identitätswert "Reno_Portland" abgerufen.

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

Get-CsNetworkInterSitePolicy -Filter *Reno*

In Beispiel 3 werden alle Netzwerkstandortrichtlinien abgerufen, die die Zeichenfolge "Reno" an einer beliebigen Stelle im Identitätswert aufweisen. Die Platzhalterzeichen (*) im Wert, die an den Parameter "Filter" übergeben werden, bedeuten "jedes beliebige Zeichen oder jede beliebige Zeichenfolge". Anders ausgedrückt: Die Zeichenfolge "Reno" stimmt mit den Identitätswerten überein, die mit einem oder mehreren beliebigen Zeichen, gefolgt von der Zeichenfolge "Reno" und gefolgt mit einem oder mehreren beliebigen Zeichen beginnen.

-------------------------- Beispiel 4 --------------------------

Get-CsNetworkInterSitePolicy | Where-Object {$_.BWPolicyProfileID -eq $null}

In diesem Beispiel werden alle Netzwerkstandortrichtlinien abgerufen, die kein zugeordnetes Bandbreitenrichtlinienprofil haben. Hierzu ruft der Befehl zunächst Get-CsNetworkInterSitePolicy auf. Anschließend wird eine Auflistung aller Netzwerkstandortrichtlinien abgerufen (siehe Beispiel 1). Diese Auflistung wird anschließend an das Cmdlet Where-Object weitergeleitet. Mit Where-Object wird die Auflistung auf die Standortrichtlinien beschränkt, denen kein Bandbreitenrichtlinienprofil zugeordnet ist. Zu diesem Zweck wird verglichen, ob die Eigenschaft "BWPolicyProfileID" für jede Standortrichtlinie einen Nullwert ($null) aufweist (der Vergleichsoperator "-eq" steht für "equal to").