Partager via


Set-CsNetworkInterRegionRoute

 

Dernière rubrique modifiée : 2012-03-27

Modifie l’itinéraire existant qui relie des régions réseau à l’intérieur de la configuration du contrôle d’admission des appels (CAC).

Syntaxe

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>]]

Description détaillée

Chaque région à l’intérieur d’une configuration CAC doit pouvoir accéder à l’autre région d’une manière ou d’une autre. Alors que les liens de région définissent des restrictions de bande passante sur les connexions entre les régions et qu’ils représentent des liens physiques, un itinéraire détermine le chemin lié que la connexion traverse d’une région à une autre. Cette cmdlet modifie le routage de ces connexions.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Set-CsNetworkInterRegionRoute : RTCUniversalServerAdmins. Pour retourner une liste de tous les rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette cmdlet a été affectée (y compris les rôles RBAC personnalisés créés par vos soins), exécutez la commande suivante à l’invite Windows PowerShell :

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsNetworkInterRegionRoute"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsGlobalRelativeIdentity

L’identificateur unique de la région de réseau que vous souhaitez modifier. Les itinéraires des régions de réseau ne sont créés que pour l’étendue globale, si bien que cet identificateur n’a pas besoin de spécifier une étendue. Il contient plutôt une chaîne avec un nom unique qui identifie cet itinéraire.

Instance

Facultatif

InterNetworkRegionRouteType

Référence d’objet à un itinéraire de région existant. L’objet doit être de type Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType, qui peut être récupéré en appelant la cmdlet Get-CsNetworkInterRegionRoute.

NetworkRegionID1

Facultatif

Chaîne

L’identité (NetworkRegionID) de l’une des deux régions connectées sur cet itinéraire. La valeur affectée à ce paramètre doit être une autre région que la valeur du paramètre NetworkRegionID2. (En d’autres mots, vous ne pouvez pas router une région à elle-même.) De plus, la combinaison NetworkRegionID1 et NetworkRegionID2 doit être unique (par exemple, vous ne pouvez pas définir deux itinéraires pour connecter NorthAmerica et EMEA).

NetworkRegionID2

Facultatif

Chaîne

L’identité (NetworkRegionID) de l’une de ces deux régions connectées grâce à cet itinéraire. La valeur affectée à ce paramètre doit être une autre région que la valeur du paramètre NetworkRegionID1. (En d’autres mots, vous ne pouvez pas router une région à elle-même.) De plus, la combinaison NetworkRegionID1 et NetworkRegionID2 doit être unique (par exemple, vous ne pouvez pas définir deux itinéraires pour connecter NorthAmerica et EMEA).

NetworkRegionLinkIDs

Facultatif

Chaîne

Vous permet de spécifier tous les liens de cet itinéraire sous la forme d’une chaîne de valeurs CSV. Les valeurs sont des identités (NetworkRegionLinkID) des liens entre régions. Si vous entrez des valeurs pour NetworkRegionLinkIDs et pour NetworkRegionLinks à la fois, NetworkRegionLinkIDs sera ignoré. Tout lien modifié et qui utilise ce paramètre remplacera tous les liens existants sur l’itinéraire.

NetworkRegionLinks

Facultatif

Modificateur de liste PS

Objet de liste contenant les identités (NetworkRegionLinkIDs) des liens de région qui s’appliquent à cet itinéraire. Pour cette cmdlet, le paramètre diffère de NetworkRegionLinkIDs dans la mesure où il vous permet non seulement de remplacer les liens existants pour cet itinéraire, mais également d’ajouter ou de supprimer des liens individuels.

Force

Facultatif

Paramètre de commutateur

Supprime les invites de confirmation qui s’affichent avant d’effectuer des modifications.

WhatIf

Facultatif

Paramètre de commutateur

Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement.

Confirm

Facultatif

Paramètre de commutateur

Vous demande confirmation avant d’exécuter la commande.

Types d’entrées

Objet Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType. Accepte la saisie de données transmises via le pipeline pour les objets d’itinéraire entre les zones de réseau.

Types de retours

Cette cmdlet ne renvoie aucune valeur. Elle modifie un objet de type Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType.

Exemple

-------------------------- Exemple 1 --------------------------

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

Cet exemple modifie l’itinéraire NA_APAC_Route en modifiant les liens entre régions qui seront traversés sur l’itinéraire. Le paramètre NetworkRegionLinkIDs est utilisé avec la valeur NA_SA,SA_APAC qui remplace tout lien existant par deux liens spécifiés dans cette chaîne.

-------------------------- Exemple 2 --------------------------

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

Comme à l’exemple 1, l’exemple 2 modifie les liens avec l’itinéraire NA_APAC_Route. Dans cet exemple toutefois, au lieu de remplacer tous les liens pour cet itinéraire en utilisant le paramètre NetworkRegionLinkIDs, le paramètre NetworkRegionLinks est utilisé pour ajouter un lien à la liste de liens qui existe déjà sur cet itinéraire. Dans ce cas, le lien SA_EMEA est ajouté à cet itinéraire. La syntaxe @{add=<link>} ajoute un élément à la liste de liens. Vous pouvez également utiliser la syntaxe @{replace=<link>} pour remplacer tous les liens existants par les liens spécifiés par <link> (qui se comporte essentiellement comme NetworkRegionLinkIDs) ou la syntaxe @{remove=<link>} qui permet de supprimer un lien de la liste.

-------------------------- Exemple 3 --------------------------

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

L’exemple 3 modifie l’itinéraire appelé NA_Route5. Cet exemple modifie l’une des régions qui constitue cet itinéraire. Le paramètre NetworkRegionID2 est utilisé pour spécifier la nouvelle région, puis le paramètre NetworkRegionLinkIDs crée une nouvelle liste de liens afin de connecter les régions de cet itinéraire.