Partager via


New-CsNetworkRegionLink

 

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

Crée un lien entre deux régions configurées pour le contrôle d’admission des appels (CAC).

Syntaxe

New-CsNetworkRegionLink -Identity <XdsGlobalRelativeIdentity> -NetworkRegionID1 <String> -NetworkRegionID2 <String> [-BWPolicyProfileID <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

New-CsNetworkRegionLink -NetworkRegionID1 <String> -NetworkRegionID2 <String> -NetworkRegionLinkID <String> [-BWPolicyProfileID <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Régions dans un réseau relié par une connexion physique WAN. Cette cmdlet définit un lien entre deux régions et les limites de bande passante pour les connexions audio et vidéo entre ces régions.

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-CsNetworkRegionLink : 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-CsNetworkRegionLink"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsGlobalRelativeIdentity

Un identificateur unique pour le lien de région de réseau nouvellement créé. Les liens de région 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 ce lien.

NetworkRegionID1

Obligatoire

Chaîne

Identité de la région (NetworkRegionID) reliée à une région identifiée par un paramètre NetworkRegionID2.

NetworkRegionID2

Obligatoire

Chaîne

L’identité de la région (NetworkRegionID) reliée à la région identifiée par le paramètre NetworkRegionID1.

NetworkRegionLinkID

Obligatoire

Chaîne

Cette valeur est la même que l’identité. Vous ne pouvez pas spécifier à la fois une identité et un identificateur NetworkRegionLinkID. Une valeur saisie pour l’un des deux sera automatiquement utilisée pour les deux.

BWPolicyProfileID

Facultatif

Chaîne

L’identité du profil de stratégie de bande passante qui définit les limites pour ce lien. Vous pouvez récupérer une liste des profils disponibles en appelant la cmdlet Get-CsNetworkBandwidthPolicyProfile.

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

Cette cmdlet crée un objet de type Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionLinkType.

Exemple

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

New-CsNetworkRegionLink -Identity NA_EMEA -NetworkRegionID1 NorthAmerica -NetworkRegionID2 EMEA -BWPolicyProfileID LowBWLimits

Cet exemple crée un nouveau lien de région de réseau appelé NA_EMEA pour relier les régions NorthAmerica et EMEA. Le nom du lien de région est spécifié comme valeur du paramètre d’identité. (Cette valeur sera automatiquement assignée à NetworkRegionLinkID). Pour créer le lien, il faut obligatoirement connaître les deux régions de réseau à relier, dans ce cas, les régions appelées NorthAmerica et EMEA. Dans cet exemple, nous avons également assigné une valeur au paramètre BWPolicyProfile. Cela permettra d’assigner les limites de bande passante de ce profil de stratégie (LowBWLimits) aux connexions entre ces régions. Si aucune identité BWPolicyProfileID n’est fournie, il n’y a aucune limite de bande passante pour les connexions entre ces deux régions. (Certaines limitations peuvent tout de même exister entre ces sites : Pour plus d’informations, consultez la rubrique d’aide New-CsNetworkSite.)