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.
Siehe auch
Weitere Ressourcen
New-CsNetworkInterSitePolicy
Remove-CsNetworkInterSitePolicy
Get-CsNetworkInterSitePolicy