Partager via

  • Article

New-CsNetworkRegion

 

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

Crée une région de réseau. Les régions de réseau représentent des concentrateurs réseau ou les clés de voûte d’un réseau d’entreprise.

Syntaxe

New-CsNetworkRegion -Identity <XdsGlobalRelativeIdentity> -CentralSite <String> [-AudioAlternatePath <$true | $false>] [-BWAlternatePaths <PSListModifier>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-VideoAlternatePath <$true | $false>] [-WhatIf [<SwitchParameter>]]

New-CsNetworkRegion -CentralSite <String> -NetworkRegionID <String> [-AudioAlternatePath <$true | $false>] [-BWAlternatePaths <PSListModifier>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-VideoAlternatePath <$true | $false>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Une région de réseau interconnecte diverses parties d’un réseau sur plusieurs zones géographiques. Chaque région de réseau doit être associée à un site central. Le site central est le site du centre de données sur lequel le service de stratégie de bande passante du contrôle d’admission des appels (CAC) est exécuté. Utilisez cette cmdlet pour créer une région de réseau. Les paramètres de cette cmdlet vous permettent de fournir des paramètres qui déterminent si d’autres chemins Internet sont autorisés pour les connexions audio et vidéo et peuvent générer l’ID de contournement de façon automatique.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsGlobalRelativeIdentity

Identificateur unique de la région de réseau créée. Les régions ne peuvent être créées qu’au niveau de l’étendue globale. Cet identificateur n’a donc pas besoin de spécifier d’étendue. Au lieu de cela, il contient une chaîne qui représente un nom unique pour cette région.

CentralSite

Obligatoire

Chaîne

site central exécutant le service de stratégie de bande passante. Ce service doit être activé pour pouvoir utiliser le contrôle d’admission des appels. Ce service s’exécute sur le serveur frontal ou le serveur Standard Edition.

NetworkRegionID

Obligatoire

Chaîne

Cette valeur est la même que pour Identity. Vous ne pouvez pas spécifier une valeur pour Identity et une autre pour NetworkRegionID ; la valeur saisie pour l’une de ces propriétés sera automatiquement utilisée pour l’autre.

AudioAlternatePath

Facultatif

Booléen

Ce paramètre détermine si les appels audio seront acheminés via un autre chemin, quand la bande passante est insuffisante sur le chemin principal.

Ce paramètre remplit la propriété BWAlternatePaths. La valeur saisie pour ce paramètre est stockée dans la propriété AlternatePath pour l’autre élément de chemin dont la valeur BWPolicyModality est Audio.

Si vous fournissez une valeur pour ce paramètre, vous ne pouvez pas spécifier de valeur pour le paramètre BWAlternatePaths.

Valeur par défaut : True. Définissez ce paramètre sur False uniquement si vous avez besoin de désactiver le déchargement vers Internet. Si certains de vos appels sont des appels Internet, cette valeur doit être True, quels que soient les paramètres de bande passante

BWAlternatePaths

Facultatif

Modificateur de liste PS

Liste d’objets qui contiennent des informations sur l'autorisation ou non des chemins de connexion Internet, quand si une demande multimédia ne peut pas être exécutée sur le chemin préféré (par exemple, si des limites ont été atteintes sur ce chemin). Les autres objets de chemins doivent être créés en appelant la cmdlet New-CsNetworkBWAlternatePath.

Si vous fournissez une valeur pour ce paramètre, vous ne pouvez pas fournir de valeur pour AudioAlternatePath ou VideoAlternatePath.

Les autres chemins pour l’audio et la vidéo sont activés (AlternatePath = True) par défaut.

BypassID

Facultatif

Chaîne

Identificateur global unique (GUID). Ce GUID est utilisé pour mapper des régions réseau à des paramètres de déviation du trafic multimédia au sein d’une configuration réseau CAC ou Enhanced 9-1-1. (Utilisez cette valeur BypassID au moment d’appeler la cmdlet New-CsNetworkMediaBypassConfiguration).

Si vous ne spécifiez pas de valeur pour ce paramètre, une valeur sera automatiquement générée. Si vous spécifiez une valeur, ce doit être sous forme de GUID (par ex., 3b24a047-dce6-48b2-9f20-9fbff17ed62a). La génération automatique est recommandée. Si vous fournissez une valeur pour ce paramètre, vous serez invité à confirmer que vous souhaitez vraiment fournir cette valeur plutôt que d’avoir recours à la génération automatique.

Description

Facultatif

Chaîne

Chaîne décrivant la région. Ce paramètre peut être utilisé pour fournir une explication plus descriptive de la région que ne l’est la propriété Identity seule.

VideoAlternatePath

Facultatif

Booléen

Ce paramètre détermine si les appels vidéo seront acheminés via un autre chemin, quand la bande passante est insuffisante sur le chemin principal.

Ce paramètre remplit la propriété BWAlternatePaths. La valeur saisie pour ce paramètre est stockée dans la propriété AlternatePath pour l’autre élément de chemin dont la valeur BWPolicyModality est Video.

Si vous fournissez une valeur pour ce paramètre, vous ne pouvez pas spécifier de valeur pour le paramètre BWAlternatePaths.

Valeur par défaut : True. Définissez ce paramètre sur False uniquement si vous avez besoin de désactiver le déchargement vers Internet. Si certains de vos appels sont des appels Internet, cette valeur doit être True, quels que soient les paramètres de bande passante.

Force

Facultatif

Paramètre de commutateur

Supprime les invites de confirmation qui s’affichent avant d’effectuer des modifications. Par exemple, si vous fournissez une valeur pour le paramètre BypassID, aucune invite de confirmation ne s’affichera.

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.NetworkRegionType.

Exemple

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

New-CsNetworkRegion -Identity NorthAmerica -Description "All North American Locations" -CentralSite Redmond-NA-MLS

Dans cet exemple, une région réseau nommée NorthAmerica est créée. Le nom de la région est spécifié en tant que valeur pour le paramètre Identity. Une valeur est également spécifiée pour le paramètre facultatif Description et décrit cette région comme étant composée de tous les emplacements d’Amérique du Nord (« All North American Locations »). Enfin, le paramètre CentralSite reçoit une valeur du nom du site central pour cette région, Redmond-NA-MLS.

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

New-CsNetworkRegion -Identity EMEA -CentralSite Dublin-EU-Site -AudioAlternatePath $False

Cet exemple crée une région de réseau nommée EMEA qui inclut des paramètres pour un autre chemin audio. Pour cela, nous appelons New-CsNetworkRegion, en passant le paramètre Identity EMEA. Nous attribuons une valeur au paramètre requis CentralSite (dans cet exemple, le nom du site central pour cette région est Dublin-EU-Site), puis nous spécifions le paramètre AudioAlternatePath, en lui passant la valeur $False. Le fait de définir AudioAlternatePath sur False indique que si la bande passante appropriée n’est pas disponible, les appels audio ne seront pas acheminés vers un autre chemin ; ils ne seront simplement pas effectués.

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

$a = New-CsNetworkBWAlternatePath -BWPolicyModality "audio" -AlternatePath $False
New-CsNetworkRegion -Identity EMEA -CentralSite Dublin-EU-Site -BWAlternatePaths $a

Cet exemple crée la même région de réseau que celle créée dans l’exemple 2. Toutefois, ici, nous utilisons le paramètre BWAlternatePaths pour définir les paramètres des autres chemins, au lieu du paramètre AudioAlternatePath. La première ligne de cet exemple appelle la cmdlet New-CsNetworkBWAlternatePath afin de créer un autre chemin. Les autres chemins n’ont que deux propriétés : BWPolicyModality, qui doit être définie sur audio ou vidéo (audio dans cet exemple) et AlternatePath, qui doit être définie sur True ou False (False dans cet exemple). Nous attribuons la sortie de cette cmdlet, référence à l’autre objet de chemin tout juste créé, à la variable $a.

Dans la ligne 2 de cet exemple, nous utilisons cet autre chemin nouvellement créé lorsque nous créons une région de réseau. Pour cela, nous appelons New-CsNetworkRegion, en passant le paramètre Identity EMEA. Nous attribuons une valeur au paramètre requis CentralSite (dans cet exemple, le nom du site central pour cette région est Dublin-EU-Site), puis nous spécifions le paramètre BWAlternatePaths, en lui passant la variable ($a) contenant l’autre objet de chemin que nous venons de créer.