• Artikel

New-CsNetworkInterRegionRoute

 

Letztes Änderungsdatum des Themas: 2012-03-27

Erstellt eine neue Route, die Netzwerkregionen mit einer Anrufsteuerungskonfiguration verbindet.

Syntax

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

New-CsNetworkInterRegionRoute -InterNetworkRegionRouteID <String> -NetworkRegionID1 <String> -NetworkRegionID2 <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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 erstellt diese Routenzuordnung.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsGlobalRelativeIdentity

Eine eindeutige ID für die neu erstellte Netzwerkregionenroute. 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.

InterNetworkRegionRouteID

Erforderlich

Zeichenfolge

Dieser Wert ist mit "Identity" identisch. Sie können nicht sowohl einen Wert für "Identity" als auch für "InterNetworkRegionRouteID" angeben. Ein für einen Parameter eingegebener Wert wird automatisch für beide Parameter verwendet.

NetworkRegionID1

Erforderlich

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

Erforderlich

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. Mit diesem Parameter können Sie auf bequeme Weise die Liste der Verbindungen angeben, ohne ein Listenobjekt erstellen und dieses an den Parameter "NetworkRegionLinks" übergeben zu müssen.

NetworkRegionLinks

Optional

PSListModifier

Ein Listenobjekt mit den Identitätswerten (NetworkRegionLinkIDs) der Regionenverbindungen, die für diese Route gelten. Bei diesem Cmdlet unterscheidet sich dieser Parameter von "NetworkRegionLinkIDs" nur im Format, wenn Sie mehr als eine Verbindung eingeben. Zur Definition der anfänglichen Liste mit diesem Cmdlet wird die Verwendung des Parameters "NetworkRegionLinkIDs" empfohlen.

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.InterNetworkRegionRouteType".

Beispiel

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

New-CsNetworkInterRegionRoute -Identity NA_APAC_Route -NetworkRegionID1 NorthAmerica -NetworkRegionID2 APAC -NetworkRegionLinkIDs "NA_EMEA,EMEA_APAC"

In Beispiel 1 wird eine neue Netzwerkregionenroute zwischen der Region "NorthAmerica" und der Region "APAC" erstellt. Die neue Route erhält den Identitätswert "NA_APAC_Route". (Dieser Wert wird automatisch als Wert für "InterNetworkRegionRouteID" zugewiesen.) Die zu verbindenden Routen lauten "NorthAmerica", übergeben als Wert für den Parameter "NetworkRegionID1", und "APAC", übergeben als Wert für den Parameter "NetworkRegionID2". In diesem Beispiel wird vorausgesetzt, dass keine direkte Regionenverbindung zwischen "NorthAmerica" und "APAC" konfiguriert ist. Es bestehen jedoch Verbindungen zwischen "NorthAmerica" und "EMEA" (NA_EMEA) und zwischen "EMEA" und "APAC" (EMEA_APAC). Diese beiden Verbindungen werden, getrennt durch Komma, als Werte des Parameters "NetworkRegionLinkIDs" verwendet. Auf diese Weise werden Verbindungen von "NorthAmerica" über "EMEA" an "APAC" geroutet und Bandbreiteneinschränkungen auf Audio- und Videoverbindungen angewendet, die diesen Verbindungen zugeordnet sind.