Partager via

  • Article

New-CsNetworkInterRegionRoute

 

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

Crée un nouvel itinéraire qui connecte les régions de réseau au sein d’une configuration de contrôle d’admission des appels (Call Admission Control ou CAC).

Syntaxe

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

Description détaillée

Chaque région au sein d’une configuration de contrôle d’admission des appels doit être dotée d’un moyen d’accéder à chacune des autres régions. 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 crée cette association d’itinéraires.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet New-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 "New-CsNetworkInterRegionRoute"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsGlobalRelativeIdentity

Identificateur unique de l’itinéraire de la région de réseau nouvellement créé. Les itinéraires de région de réseau étant créés au niveau de l’étendue globale seulement, il n’est pas nécessaire de spécifier une étendue pour cet identificateur. Il contient en effet une chaîne au nom unique permettant d’identifier l’itinéraire.

InterNetworkRegionRouteID

Obligatoire

Chaîne

Cette valeur est la même que l’identité. Vous ne pouvez pas spécifier à la fois une identité et une valeur pour InterNetworkRegionRouteID. La valeur entrée pour l’un est automatiquement utilisée pour l’autre.

NetworkRegionID1

Obligatoire

Chaîne

Identité (NetworkRegionID) de l’une des deux régions connectées via cet itinéraire. La valeur transmise à ce paramètre doit être une région différente de la valeur du paramètre NetworkRegionID2. (En d’autres termes, vous ne pouvez pas router une région vers elle-même.) En outre, la combinaison de NetworkRegionID1 et NetworkRegionID2 doit être unique (vous ne pouvez pas, par exemple, avoir deux itinéraires définis connectés à NorthAmerica et EMEA).

NetworkRegionID2

Obligatoire

Chaîne

Identité (NetworkRegionID) de l’une des deux régions connectées via cet itinéraire. La valeur transmise à ce paramètre doit être une région différente de la valeur du paramètre NetworkRegionID1. (En d’autres termes, vous ne pouvez pas router une région vers elle-même.) En outre, la combinaison de NetworkRegionID1 et NetworkRegionID2 doit être unique (vous ne pouvez pas, par exemple, avoir deux itinéraires définis connectés à NorthAmerica et EMEA).

NetworkRegionLinkIDs

Facultatif

Chaîne

Permet de spécifier tous les liens de cet itinéraire sous forme d’une chaîne de valeurs séparées par des virgules. Les valeurs sont les identités (NetworkRegionLinkIDs) des liens de région. Si vous entrez des valeurs à la fois pour NetworkRegionLinkIDs et pour NetworRegionLinks, NetworkRegionLinkIDs sera ignoré. Ce paramètre permet de spécifier en toute facilité une liste de liens sans devoir construire une liste d’objets pour la transmettre au paramètre NetworkRegionLinks.

NetworkRegionLinks

Facultatif

Modificateur de liste PS

Liste d’objets contenant les identités (NetworkRegionLinkIDs) des liens de région s’appliquant à cet itinéraire. Pour cette cmdlet, ce paramètre ne diffère du paramètre NetworkRegionLinkIDs que dans le format si vous entrez plusieurs liens. Le paramètre NetworkRegionLinkIDs est la méthode recommandée pour définir la liste initiale avec cette cmdlet.

Force

Facultatif

Paramètre de commutateur

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

InMemory

Facultatif

Paramètre de commutateur

Crée une référence d’objet sans valider l’objet comme une modification définitive. Si vous affectez à une variable la sortie de cette cmdlet appelée avec ce paramètre, vous pouvez apporter des modifications aux propriétés de la référence d’objet, puis les valider en appelant la cmdlet Set- correspondante.

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

Aucun.

Types de retours

Crée un objet de type Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType.

Exemple

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

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

L’exemple 1 crée un itinéraire de région de réseau entre la région NorthAmerica et la région APAC. Nous attribuons l’identité NA_APAC_Route au nouvel itinéraire. (InterNetworkRegionRouteID lui est automatiquement affecté.) Les régions connectées sont NorthAmerica, transmise comme valeur au paramètre NetworkRegionID1, ainsi que APAC, transmise comme valeur au paramètre NetworkRegionID2. Dans cet exemple, nous partons du principe qu’il n’y a pas de lien de région configuré pour relier directement NorthAmerica à APAC. Toutefois, il existe des liens de NorthAmerica à EMEA (NA_EMEA) et de EMEA à APAC (EMEA_APAC). Nous utilisons ces deux liens, séparés par des virgules, comme valeur du paramètre NetworkRegionLinkIDs. Les connexions sont ainsi acheminées de NorthAmerica à APAC via EMEA et des restrictions de bande passante sont appliquées aux connexions audio et vidéo associées à ces liens.