New-CsNetworkBandwidthPolicyProfile
Dernière rubrique modifiée : 2012-03-24
Crée un profil de stratégie de bande passante réseau. Cette cmdlet peut être également utilisée pour définir des stratégies de bande passante dans le profil.
Syntaxe
New-CsNetworkBandwidthPolicyProfile -Identity <XdsGlobalRelativeIdentity> [-AudioBWLimit <String>] [-AudioBWSessionLimit <String>] [-BWPolicy <PSListModifier>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-VideoBWLimit <String>] [-VideoBWSessionLimit <String>] [-WhatIf [<SwitchParameter>]]
Description détaillée
La stratégie de bande passante utilisée dans le cadre du contrôle d’admission des appels (CAC) permet de définir des restrictions de bande passante pour des modes bien précis. (Dans Microsoft Lync Server 2010, seuls les modes audio et vidéo peuvent être soumis à des restrictions en matière de bande passante.) Cette cmdlet crée un profil pour ces stratégies au sein du conteneur. Vous définissez les stratégies individuelles dans le conteneur en indiquant les limites de bande passante audio et vidéo lorsque vous appelez cette cmdlet.
Les profils de stratégies de bande passante sont appliqués aux sites du réseau par la cmdlet New-CsNetworkSite ou Set-CsNetworkSite
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-CsNetworkBandwidthPolicyProfile : 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-CsNetworkBandwidthPolicyProfile"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
XdsGlobalRelativeIdentity |
Valeur de type chaîne qui identifie de manière unique la stratégie. Tous les profils de stratégies de bande passante sont créés au niveau de l’étendue globale. Par conséquent, l’étendue est implicite et seul un nom unique doit être défini lors de la création d’un profil de stratégie de bande passante. Notez que cette valeur est également affectée à la propriété BWPolicyProfileID du profil. |
AudioBWLimit |
Facultatif |
Chaîne |
Quantité maximale de bande passante à allouer pour toutes les connexions audio. Si une seule session audio dépasse la limite de bande passante, cette session ne sera pas autorisée à démarrer. Valeur exprimée en Kbits/s. Par exemple, une valeur de 1000 signifie 1 000 Kbits/s. Si vous fournissez une valeur pour ce paramètre, vous ne pouvez pas spécifier de valeur pour le paramètre BWPolicy. Valeur par défaut : si vous indiquez une valeur pour le paramètre AudioBWSessionLimit mais pas pour le paramètre AudioBWLimit, alors ce dernier prend la valeur 0 par défaut. |
AudioBWSessionLimit |
Facultatif |
Chaîne |
Largeur maximale de bande passante allouée par session audio. Valeur exprimée en Kbits/s. La valeur doit être égale ou supérieure à 40. Si vous fournissez une valeur pour ce paramètre, vous ne pouvez pas spécifier de valeur pour le paramètre BWPolicy. Valeur par défaut : si vous indiquez une valeur pour le paramètre AudioBWLimit mais pas pour le paramètre AudioBWSessionLimit, alors ce dernier prend la valeur 175 par défaut. |
BWPolicy |
Facultatif |
Modificateur de liste PS |
Liste d’objets contenant les profils de stratégie de bande passante. Chaque objet de la liste comprend un mode de bande passante (audio ou vidéo), une limite de bande passante et une limite pour la session de bande passante. Si vous affectez une valeur à ce paramètre, vous ne pouvez pas affecter de valeur au paramètre AudioBWLimit, AudioBWSessionLimit, VideoBWLimit ou VideoBWSessionLimit. Les objets de la liste peuvent être créés par la cmdlet New-CsNetworkBWPolicy. |
Description |
Facultatif |
Chaîne |
Description du profil de stratégie de bande passante. Par exemple, vous pouvez utiliser ce paramètre pour clarifier l’utilisation du profil souhaité. |
VideoBWLimit |
Facultatif |
Chaîne |
Quantité maximale de bande passante à allouer pour toutes les connexions vidéo. Si une seule session vidéo dépasse la limite de bande passante vidéo, cette session ne sera pas autorisée à démarrer. Valeur exprimée en Kbits/s. Par exemple, une valeur de 1000 signifie 1 000 Kbits/s. Si vous fournissez une valeur pour ce paramètre, vous ne pouvez pas spécifier de valeur pour le paramètre BWPolicy. Valeur par défaut : si vous indiquez une valeur pour le paramètre VideoBWSessionLimit mais pas pour le paramètre VideoBWLimit, alors ce dernier prend la valeur 0 par défaut. |
VideoBWSessionLimit |
Facultatif |
Chaîne |
Largeur maximale de bande passante allouée par session vidéo. Valeur exprimée en Kbits/s. La valeur doit être égale ou supérieure à 100. Si vous fournissez une valeur pour ce paramètre, vous ne pouvez pas spécifier de valeur pour le paramètre BWPolicy. Valeur par défaut : si vous indiquez une valeur pour le paramètre VideoBWLimit mais pas pour le paramètre VideoBWSessionLimit, alors ce dernier prend la valeur 700 par défaut. |
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.BWPolicyProfileType.
Exemple
-------------------------- Exemple 1 --------------------------
New-CsNetworkBandwidthPolicyProfile -Identity LowBWLimits -AudioBWLimit 2000 -AudioBWSessionLimit 200 -VideoBWLimit 1400 -VideoBWSessionLimit 500
L’exemple 1 crée le profil de stratégie de bandes passante LowBWLimits. Deux stratégies seront affectées à ce nouveau profil : une stratégie audio et une stratégie vidéo (les deux seules stratégies possibles dans Lync Server 2010). La stratégie audio est ajoutée au profil au moyen du paramètre AudioBWLimit pour affecter une limite de 2 000 Kbits/s (dans le cas présent) à toutes les connexions audio et au moyen du paramètre AudioBWSessionLimit pour définir 2 000 Kbits/s comme limite pour les sessions vidéo. La même opération est exécutée pour créer des limites de session vidéo, mais en utilisant les paramètres VideoBWLimit et VideoBWSessionLimit.