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.)
Voir aussi
Autres ressources
Remove-CsNetworkRegionLink
Set-CsNetworkRegionLink
Get-CsNetworkRegionLink
Get-CsNetworkBandwidthPolicyProfile
New-CsNetworkSite