Freigeben über


Set-CsNetworkInterRegionRoute

 

Letztes Änderungsdatum des Themas: 2012-03-27

Ändert eine vorhandene Route, die Netzwerkregionen mit einer Anrufsteuerungskonfiguration verbindet.

Syntax

Set-CsNetworkInterRegionRoute [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-NetworkRegionID1 <String>] [-NetworkRegionID2 <String>] [-NetworkRegionLinkIDs <String>] [-NetworkRegionLinks <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Set-CsNetworkInterRegionRoute [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-NetworkRegionID1 <String>] [-NetworkRegionID2 <String>] [-NetworkRegionLinkIDs <String>] [-NetworkRegionLinks <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Jede Region in einer Anrufsteuerungskonfiguration muss auf jede andere Region zugreifen können. Während die Regionenverbindungen Bandbreiteneinschränkungen für Verbindungen zwischen Regionen festlegen und auch die physischen Verbindungen darstellen, bestimmt eine Route, welchen Pfad die Verbindung von einer Region zur anderen nimmt. Dieses Cmdlet ändert diese Routenzuordnung.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

XdsGlobalRelativeIdentity

Die eindeutige ID der Netzwerkregionenroute, die geändert werden soll. Netzwerkregionenrouten werden ausschließlich auf globaler Ebene erstellt, sodass mit dieser ID kein Gültigkeitsbereich festgelegt werden muss. Stattdessen ist eine Zeichenfolge enthalten, die den eindeutigen Namen zur Identifizierung dieser Route darstellt.

Instance

Optional

InterNetworkRegionRouteType

Ein Objektverweis auf eine vorhandene Regionenroute. Dieses Objekt muss vom Typ "Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType" sein, das durch Aufrufen von Get-CsNetworkInterRegionRoute abgerufen werden kann.

NetworkRegionID1

Optional

Zeichenfolge

Der Identitätswert (NetworkRegionID) einer der beiden Regionen, die durch diese Route verbunden werden. Der an diesen Parameter übergebene Wert muss eine andere Region als der Wert des Parameters "NetworkRegionID2" angeben. (Dies soll verhindern, dass eine Region zu sich selbst geroutet wird.) Darüber hinaus muss die Kombination von "NetworkRegionID1" und "NetworkRegionID2" eindeutig sein (es darf beispielsweise nicht zwei Routen geben, die "NorthAmerica" und "EMEA" verbinden).

NetworkRegionID2

Optional

Zeichenfolge

Der Identitätswert (NetworkRegionID) einer der beiden Regionen, die durch diese Route verbunden werden. Der an diesen Parameter übergebene Wert muss eine andere Region als der Wert des Parameters "NetworkRegionID1" angeben. (Dies soll verhindern, dass eine Region zu sich selbst geroutet wird.) Darüber hinaus muss die Kombination von "NetworkRegionID1" und "NetworkRegionID2" eindeutig sein (es darf beispielsweise nicht zwei Routen geben, die "NorthAmerica" und "EMEA" verbinden).

NetworkRegionLinkIDs

Optional

Zeichenfolge

Ermöglicht das Angeben aller Verbindungen für diese Route als Zeichenfolge mit durch Komma getrennten Werten. Die Werte sind die Identitätswerte (NetworkRegionLinkIDs) der Regionenverbindungen. Wenn Sie sowohl für "NetworkRegionLinkIDs" als auch für "NetworkRegionLinks" Werte eingeben, wird "NetworkRegionLinkIDs" ignoriert. Alle mithilfe dieses Parameters geänderten Verbindungen ersetzen alle in der Route vorhandenen Verbindungen.

NetworkRegionLinks

Optional

PSListModifier

Ein Listenobjekt mit den Identitätswerten (NetworkRegionLinkIDs) der Regionenverbindungen, die für diese Route gelten. Für dieses Cmdlet unterscheidet sich dieser Parameter von "NetworkRegionLinkIDs" dahingehend, dass Sie nicht nur die für diese Route vorhandenen Verbindungen ersetzen, sondern auch einzelne Verbindungen hinzufügen oder entfernen können.

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.InterNetworkRegionRouteType-Objekt. Akzeptiert eine weitergeleitete Eingabe von regionenübergreifenden Netzwerkroutenobjekten.

Rückgabetypen

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

Beispiel

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

Set-CsNetworkInterRegionRoute -Identity NA_APAC_Route -NetworkRegionLinkIDs "NA_SA,SA_APAC"

Dieses Beispiel ändert die Route "NA_APAC_Route", indem die Regionenverbindungen geändert werden, die entlang der Route durchquert werden. Für den Parameter "NetworkRegionLinkIDs" wird der Wert "NA_SA,SA_APAC" verwendet, der alle vorhandenen Verbindungen durch die beiden in dieser Zeichenfolge angegebenen Verbindungen ersetzt.

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

Set-CsNetworkInterRegionRoute -Identity NA_APAC_Route -NetworkRegionLinks @{add="SA_EMEA"}

Wie in Beispiel 1 werden in Beispiel 2 die Verbindungen innerhalb der Route "NA_APAC_Route" geändert. Doch anstatt mithilfe des Parameters "NetworkRegionLinkIDs" alle Verbindungen für diese Route zu ersetzen, wird hier der Parameter "NetworkRegionLinks" verwendet, um eine Verbindung der Liste der Verbindungen hinzuzufügen, die bereits für diese Route vorhanden sind. In diesem Fall wird die Verbindung "SA_EMEA" der Route hinzugefügt. Die Syntax "@{add=<Verbindung>}" fügt der Liste der Verbindungen ein Element hinzu. Sie können auch die Syntax "@{replace=<Verbindung>}" verwenden, um alle vorhandenen Verbindungen mit denen durch "<Verbindung>" angegebenen Verbindungen zu ersetzen (was dem Verhalten von "NetworkRegionLinkIDs" im Wesentlichen entspricht). Über die Syntax "@{remove=<Verbindung>}" können Sie eine Verbindung aus der Liste entfernen.

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

Set-CsNetworkInterRegionRoute -Identity NA_Route5 -NetworkRegionID2 SouthAmerica -NetworkRegionLinkIDs "NA_SA,SA_APAC"

Beispiel 3 ändert die Route "NA_Route5". Dieses Beispiel ändert eine der Regionen, aus denen diese Route sich zusammensetzt. Der Parameter "NetworkRegionID2" dient zum Angeben der neuen Region. Anschließend wird der Parameter "NetworkRegionLinkIDs" verwendet, um eine neue Liste mit Verbindungen zum Verbinden der Regionen dieser Route zu erstellen.