• Artikel

Set-CsNetworkInterSitePolicy

 

Letztes Änderungsdatum des Themas: 2012-03-26

Ändert eine vorhandene standortübergreifende Netzwerkrichtlinie zur Definition von Bandbreiteneinschränkungen zwischen Standorten, die in einer Anrufsteuerungskonfiguration direkt verbunden sind.

Syntax

Set-CsNetworkInterSitePolicy [-Identity <XdsGlobalRelativeIdentity>] [-BWPolicyProfileID <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-NetworkSiteID1 <String>] [-NetworkSiteID2 <String>] [-WhatIf [<SwitchParameter>]]

Set-CsNetworkInterSitePolicy [-BWPolicyProfileID <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-NetworkSiteID1 <String>] [-NetworkSiteID2 <String>] [-WhatIf [<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 wird eine standortübergreifende Netzwerkrichtlinie geändert, die zwei direkt verbundenen Standorten eine Richtlinie zur Bandbreiteneinschränkung zuordnet.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsGlobalRelativeIdentity

Die eindeutige ID der Netzwerkstandortrichtlinie, die geändert werden soll. Netzwerkstandortrichtlinien werden ausschließlich global erstellt, sodass mit dieser ID kein Gültigkeitsbereich festgelegt werden muss. Stattdessen ist eine Zeichenfolge mit einem eindeutigen Namen zur Identifizierung der Standortrichtlinie enthalten.

Instance

Optional

InterNetworkSitePolicyType

Ein Objektverweis auf eine Standortrichtlinie, die im Arbeitsspeicher geändert wurde. Dieses Objekt muss vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkSitePolicyType" sein und kann durch Aufrufen von Get-CsNetworkInterSitePolicy abgerufen werden.

BWPolicyProfileID

Optional

Zeichenfolge

Der Identitätswert des Bandbreitenrichtlinienprofils, das die Beschränkungen für diese Standortrichtlinie bestimmt. Sie können eine Liste der verfügbaren Profile durch Aufrufen des Cmdlets Get-CsNetworkBandwidthPolicyProfile abrufen.

NetworkSiteID1

Optional

Zeichenfolge

Der Identitätswert (NetworkSiteID) eines der beiden Standorte, denen diese Richtlinie zugeordnet ist. Die Kombination aus "NetworkSiteID1" und "NetworkSiteID2" muss eindeutig sein (Sie können beispielsweise nicht zwei Standortrichtlinien definieren, die "Reno" und "Portland" verbinden).

NetworkSiteID2

Optional

Zeichenfolge

Der Identitätswert (NetworkSiteID) eines der beiden Standorte, denen diese Richtlinie zugeordnet ist. Die Kombination aus "NetworkSiteID1" und "NetworkSiteID2" muss eindeutig sein (Sie können beispielsweise nicht zwei Standortrichtlinien definieren, die "Reno" und "Portland" verbinden).

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.NetworkConfiguration.InterNetworkSitePolicyType-Objekt. Akzeptiert eine weitergeleitete Eingabe von standortübergreifenden Netzwerkrichtlinienobjekten.

Rückgabetypen

Dieses Cmdlet gibt keinen Wert zurück. Es ändert ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkSitePolicyType".

Beispiel

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

Set-CsNetworkInterSitePolicy -Identity Reno_Portland -BWPolicyProfileID HighBWLimits

In diesem Beispiel wird die Netzwerkstandortrichtlinie mit dem Identitätswert "Reno_Portland" geändert. Hierbei wird der Parameter "BWPolicyProfileID" verwendet, um das dieser Netzwerkstandortrichtlinie zugeordnete Bandbreitenrichtlinienprofil in "HighBWLimits" zu ändern.