New-CsBandwidthPolicyServiceConfiguration
Dernière rubrique modifiée : 2012-03-23
Crée une nouvelle configuration de service de stratégie de bande passante.
Syntaxe
New-CsBandwidthPolicyServiceConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-EnableLogging <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LogCleanUpInterval <TimeSpan>] [-MaxLogFileSizeMb <UInt32>] [-MaxTokenLifetime <TimeSpan>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Le contrôle d’admission des appels (Call Admission Control ou CAC) permet de déterminer si les sessions de communication en temps réel, comme les appels audio et vidéo, doivent ou non être autorisées, en fonction des restrictions de bande passante. Lors d’une implémentation Microsoft Lync Server 2010 du service Contrôle d’admission des appels, des régions, des sites et des sous-réseaux sont définis dans un réseau, tout comme les relations et les liens entre ces entités, afin d’établir des contraintes entre ces dernières en matière de bande passante. Le service de stratégie de bande passante est un composant de mise en application de la fonctionnalité CAC au sein du déploiement de Lync Server 2010, permettant de savoir si la quantité de bande passante est suffisante pour passer un appel. Cette cmdlet configure un nouveau service de stratégie de bande passante au niveau du site.
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-CsBandwidthPolicyServiceConfiguration : 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-CsBandwidthPolicyServiceConfiguration"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Obligatoire |
XdsIdentity |
Identificateur unique contenant l’étendue et le nom de la configuration. Cette configuration peut être créée uniquement dans l’étendue Site. L’identité sera donc au format suivant : site:<nom du site>, où <nom du site> correspond au nom du site auquel la configuration s’applique. |
EnableLogging |
Facultatif |
Booléen |
Définissez ce paramètre sur True pour créer des journaux inhérents au service de stratégie de bande passante et détaillant d’éventuelles défaillances du service Contrôle d’admission des appels ou l’état des liens. Valeur par défaut : False |
LogCleanUpInterval |
Facultatif |
TimeSpan |
Laps de temps à l’issue duquel les journaux détaillant les défaillances du service Contrôle d’admission des appels et l’état des liens seront supprimés. Cette valeur doit aller de 1 à 60 jours. La valeur doit être saisie au format jj.hh:mm:ss où « j » représente les jours, « h » les heures, « m » les minutes et « s » les secondes. Valeur par défaut : 10 jours (10.00:00:00) |
MaxLogFileSizeMb |
Facultatif |
UInt32 |
Taille maximale autorisée pour le fichier journal. La valeur de ce paramètre doit être un nombre positif ; il précise la taille du fichier en mégaoctets. Valeur par défaut : 3 (Mo) |
MaxTokenLifetime |
Facultatif |
TimeSpan |
Durée maximale pendant laquelle le jeton émis par le service d’authentification de stratégie de bande passante existera. Cette valeur doit aller de 1 à 24 heures. La valeur doit être saisie au format jj.hh:mm:ss où « j » représente les jours, « h » les heures, « m » les minutes et « s » les secondes. Valeur par défaut : 8 heures (08:00:00) |
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.BandwidthPolicyServiceConfiguration.BandwidthPolicyServiceConfiguration.
Exemple
-------------------------- Exemple 1 --------------------------
New-CsBandwidthPolicyServiceConfiguration -Identity site:Redmond
Cet exemple illustre la création d’une nouvelle configuration de service de stratégie de bande passante sur le site de Redmond (-Identity site:Redmond). Aucun autre paramètre n’est spécifié. Les valeurs par défaut sont donc utilisées pour toutes les valeurs de configuration.
-------------------------- Exemple 2 --------------------------
New-CsBandwidthPolicyServiceConfiguration -Identity site:Dublin -EnableLogging $True -LogCleanupInterval 30.00:00:00
Dans cet exemple, nous créons à nouveau une nouvelle configuration de service de stratégie de bande passante, cette fois sur le site de Dublin (-Identity site:Dublin). Pour ce site, au lieu d’accepter les valeurs par défaut, nous voulons activer la journalisation et définir le nombre de jours maximal qui doit s’écouler avant le nettoyage des journaux à 30 jours. Pour cela, nous transmettons la valeur True ($True) au paramètre EnableLogging, puis la valeur 30.00:00:00 au paramètre LogCleanupInterval. La valeur de LogCleanupInterval est un objet TimeSpan au format jj.hh:mm:ss où « j » représente les jours, « h » les heures, « m » les minutes et « s » les secondes.