Partager via

  • Article

Set-CsNetworkConfiguration

 

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

Modifie les paramètres d’une configuration réseau. Cette cmdlet est le plus souvent utilisée pour activer ou désactiver le contrôle d’admission des appels (Call Admission Control ; CAC).

Syntaxe

Set-CsNetworkConfiguration [-Identity <XdsIdentity>] [-BWPolicyProfiles <PSListModifier>] [-Confirm [<SwitchParameter>]] [-EnableBandwidthPolicyCheck <$true | $false>] [-Force <SwitchParameter>] [-InterNetworkRegionRoutes <PSListModifier>] [-InterNetworkSitePolicies <PSListModifier>] [-MediaBypassSettings <MediaBypassSettingsType>] [-NetworkRegionLinks <PSListModifier>] [-NetworkRegions <PSListModifier>] [-NetworkSites <PSListModifier>] [-Subnets <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Set-CsNetworkConfiguration [-BWPolicyProfiles <PSListModifier>] [-Confirm [<SwitchParameter>]] [-EnableBandwidthPolicyCheck <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-InterNetworkRegionRoutes <PSListModifier>] [-InterNetworkSitePolicies <PSListModifier>] [-MediaBypassSettings <MediaBypassSettingsType>] [-NetworkRegionLinks <PSListModifier>] [-NetworkRegions <PSListModifier>] [-NetworkSites <PSListModifier>] [-Subnets <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Description détaillée

L’objet de configuration réseau contient tous les paramètres d’une configuration CAC complète au sein d’un déploiement Microsoft Lync Server 2010, ainsi que les paramètres de déviation du trafic multimédia. Vous pouvez utiliser cette cmdlet pour modifier n’importe quelle partie de la configuration CAC et vous devez y recourir pour changer les paramètres de déviation du trafic multimédia. Néanmoins, il est recommandé d’utiliser des cmdlets spécifiques au type d’objet lorsque vous modifiez la plupart des paramètres de configuration CAC. Par exemple, pour travailler avec des régions réseau, utilisez les cmdlets se terminant par le nom CsNetworkRegion au lieu de manipuler le paramètre NetworkRegions de cette cmdlet.

Le principal rôle de cette cmdlet est d’activer (et de désactiver) CAC et d’appliquer des paramètres de déviation du trafic multimédia. Une fois que vous avez configuré les divers composants nécessaires à votre configuration (tels que régions, sites et sous-réseaux), vous devez activer la configuration pour permettre sa mise en œuvre. Pour ce faire, attribuez simplement la valeur True au paramètre EnableBandwidthPolicyCheck. Veuillez noter que même si EnableBandwidthPolicyCheck est défini sur True, l'exécution de cette cmdlet n'active pas immédiatement CAC. Avant de pouvoir activer CAC, une série de contrôles de validation doit être effectuée pour s’assurer que la configuration est correcte. Si des erreurs ou des incohérences sont détectées dans la configuration, des messages d'avertissement s'affichent, vous demandant si vous souhaitez continuer à activer CAC en dépit du problème rencontré. Si vous choisissez de continuer (en appuyant sur Entrée ou O), la validation se poursuit. Si un autre problème est détecté, vous devez à nouveau indiquer la marche à suivre.

Si vous effectuez l'intégralité de la validation en choisissant de continuer à chaque avertissement, la valeur True sera attribuée à EnableBandwidthPolicyCheck et CAC sera activé. Cependant, il ne fonctionnera probablement pas de façon correcte tant que les problèmes ne seront pas résolus. Si à n’importe quel stade de la validation, vous choisissez de l’interrompre (en saisissant N à l’invite d’avertissement), la validation prendra fin et EnableBandwidthPolicyCheck restera défini sur False (valeur par défaut).

Si EnableBandwidthPolicyCheck est déjà défini sur True, vous pouvez appeler Set-CsNetworkConfiguration et attribuer la valeur True au paramètre EnableBandwidthPolicyCheck de façon à exécuter la validation sans modifier aucun paramètre. En outre, si EnableBandwidthPolicyCheck est défini sur True, toute modification que vous tentez d'effectuer en appelant Set-CsNetworkConfiguration entraînera une nouvelle fois l'exécution du contrôle de validation.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Cette valeur est toujours Global.

Instance

Facultatif

NetworkConfigurationSettings

Référence à un objet de configuration réseau. Cet objet doit être de type Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkConfigurationSettings et peut être récupéré en appelant la cmdlet Get-CsNetworkConfiguration.

BWPolicyProfiles

Facultatif

Modificateur de liste PS

Collection de tous les profils de stratégie de bande passante qui peuvent être affectés aux sites, stratégies intersites et liens de région réseau. Chaque profil de stratégie de bande passante contient des limitations de bande passante (limitations globales et limitations de session) pour les connexions audio et/ou vidéo. Vous pouvez récupérer une liste complète des profils de stratégie de bande passante en appelant la cmdlet Get-CsNetworkBandwidthPolicyProfile.

EnableBandwidthPolicyCheck

Facultatif

Booléen

En définissant ce paramètre sur True, vous exécutez un contrôle de validation sur l’intégralité de la configuration CAC. Si tous les contrôles de validation sont réussis ou si vous choisissez d’ignorer l’ensemble des avertissements, CAC sera activé. Si un contrôle de validation échoue, vous pouvez choisir d’arrêter la validation et la valeur de EnableBandwidthPolicyCheck restera inchangée.

En définissant cette valeur sur False, vous désactivez CAC.

Valeur par défaut : False

InterNetworkRegionRoutes

Facultatif

Modificateur de liste PS

Collection de tous les itinéraires de région réseau définis dans la configuration CAC. Vous pouvez récupérer tous les membres de cette collection en appelant la cmdlet Get-CsNetworkInterRegionRoute.

InterNetworkSitePolicies

Facultatif

Modificateur de liste PS

Collection de stratégies inter-sites réseau définies dans la configuration CAC. Vous pouvez récupérer tous les membres de cette collection en appelant la cmdlet Get-CsNetworkInterSitePolicy.

MediaBypassSettings

Facultatif

MediaBypassSettingsType

Référence à un objet qui définit les paramètres globaux de déviation du trafic multimédia pour la configuration CAC. Si vous définissez cette valeur, le système remplacera tous les paramètres existants de déviation du trafic multimédia. Pour obtenir cette référence d'objet, appelez la cmdlet New-CsNetworkMediaBypassConfiguration et affectez les nouveaux paramètres de configuration à une variable. Transmettez ensuite cette variable au paramètre MediaBypassSettings afin de modifier les paramètres globaux de déviation du trafic multimédia.

NetworkRegionLinks

Facultatif

Modificateur de liste PS

Collection des liens de région réseau définis dans la configuration CAC. Chaque lien de région réseau définit une connexion entre deux régions et toutes les limitations de bande passante qui doivent être appliquées aux connexions entre ces régions. Vous pouvez récupérer tous les membres de cette collection en appelant la cmdlet Get-CsNetworkRegionLink.

NetworkRegions

Facultatif

Modificateur de liste PS

Collection des régions réseau (chacune d’entre elles représentant un concentrateur ou une dorsale principale dans le réseau) définies dans la configuration CAC. Vous pouvez récupérer tous les membres de cette collection en appelant la cmdlet Get-CsNetworkRegion.

NetworkSites

Facultatif

Modificateur de liste PS

Collection des sites réseau (chacun d’entre eux représentant un bureau ou un emplacement dans une région) définis dans la configuration CAC. Vous pouvez récupérer tous les membres de cette collection en appelant la cmdlet Get-CsNetworkSite.

Subnets

Facultatif

Modificateur de liste PS

Collection des sous-réseau de réseau (chacun d'entre eux étant associé par un point de terminaison à un site) définis dans la configuration CAC. Vous pouvez récupérer tous les membres de cette collection en appelant la cmdlet Get-CsNetworkSubnet.

Force

Facultatif

Paramètre de commutateur

Ce paramètre n’accepte aucune valeur. Si vous incluez ce paramètre, toute modification apportée à la configuration, y compris son activation, sera appliquée sans aucun avertissement ou contrôle de validation.

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.NetworkConfigurationSettings. Accepte la saisie de données transmises via le pipeline pour un objet de configuration de réseau.

Types de retours

Set-CsNetworkConfiguration ne renvoie ni valeur ni objet. Au lieu de cela, la cmdlet modifie les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkConfigurationSettings.

Exemple

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

Set-CsNetworkConfiguration -EnableBandwidthPolicyCheck $True

La commande de cet exemple exécutera un contrôle de validation sur l’ensemble de la configuration CAC, puis (en fonction de vos réponses aux avertissements retournés) activera CAC. Si CAC est déjà activé (en d’autres termes, si la propriété EnableBandwidthPolicyCheck a la valeur True) et que vous exécutez cette commande, elle exécutera simplement le contrôle de validation.