• Artikel

New-CsNetworkInterSitePolicy

 

Letztes Änderungsdatum des Themas: 2012-03-27

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

Syntax

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

New-CsNetworkInterSitePolicy -InterNetworkSitePolicyID <String> -NetworkSiteID1 <String> -NetworkSiteID2 <String> [-BWPolicyProfileID <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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 Netzwerkstandortrichtlinie erstellt, 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 New-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 "New-CsNetworkInterSitePolicy"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsGlobalRelativeIdentity

Eine eindeutige ID der neu erstellten standortübergreifenden Netzwerkrichtlinie. Standortübergreifende Netzwerkrichtlinien werden ausschließlich global erstellt, sodass mit dieser ID kein Gültigkeitsbereich festgelegt werden muss. Stattdessen ist eine Zeichenfolge enthalten, die der eindeutige Name zur Identifizierung dieser Standortrichtlinie ist.

InterNetworkSitePolicyID

Erforderlich

Zeichenfolge

Dieser Wert ist mit "Identity" identisch. Sie können nicht gleichzeitig den Identitätswert und den Parameter "InterNetworkSitePolicyID" angeben. Ein Wert, der für einen der beiden Parameter angegeben wird, gilt automatisch für beide.

NetworkSiteID1

Erforderlich

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

Erforderlich

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).

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.

Force

Optional

Switch-Parameter

Unterdrückt alle Bestätigungsaufforderungen, die andernfalls vor der Durchführung von Änderungen angezeigt würden.

InMemory

Optional

Switch-Parameter

Erstellt einen Objektverweis ohne einen Commit für das Objekt auszuführen und die Änderungen dadurch dauerhaft zu speichern. Wenn Sie die Ausgabe des mit diesem Parameter aufgerufenen Cmdlet einer Variablen zuweisen, können Sie die Eigenschaften des Objektverweises ändern und anschließend einen Commit für diese Änderungen ausführen, indem Sie das entsprechende Cmdlet vom Typ "Set-" aufrufen.

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

Keine.

Rückgabetypen

Erstellt ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkSitePolicy".

Beispiel

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

New-CsNetworkInterSitePolicy -Identity Reno_Portland -NetworkSiteID1 Reno -NetworkSiteID2 Portland -BWPolicyProfileID LowBWLimits

In diesem Beispiel wird eine neue standortübergreifende Netzwerkrichtlinie erstellt, die die Bandbreite zwischen den verbundenen Standorten "Reno" und "Portland" einschränkt. Die Bandbreiteneinschränkungen für Audio- und Videoverbindungen zwischen diesen Standorten erfolgen gemäß der Einstellung, die für das Bandbreitenrichtlinienprofil "LowBWLimits" konfiguriert ist.