Set-CsBandwidthPolicyServiceConfiguration
Dernière rubrique modifiée : 2012-03-27
Modifie la configuration d’un service de stratégie de bande passante existant.
Syntaxe
Set-CsBandwidthPolicyServiceConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-EnableLogging <$true | $false>] [-Force <SwitchParameter>] [-LogCleanUpInterval <TimeSpan>] [-MaxLogFileSizeMb <UInt32>] [-MaxTokenLifetime <TimeSpan>] [-WhatIf [<SwitchParameter>]]
Set-CsBandwidthPolicyServiceConfiguration [-Confirm [<SwitchParameter>]] [-EnableLogging <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 modifie la configuration d’un service de stratégie de bande passante existant.
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-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 "Set-CsBandwidthPolicyServiceConfiguration"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
XdsIdentity |
Identificateur unique de la configuration que vous souhaitez modifier. Cet identificateur se compose de l’étendue (pour la configuration globale) ou de l’étendue et d’un nom (pour une configuration au niveau du site, telle que site:Redmond). |
Instance |
Facultatif |
BandwidthPolicyServiceConfiguration |
Référence à un objet de configuration du service de stratégie de bande passante. Cet objet doit être de type BandwidthPolicyServiceConfiguration et peut être récupéré en appelant la cmdlet Get-CsBandwidthPolicyServiceConfiguration. |
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. |
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. Par exemple, 20 jours se traduiraient de la manière suivante : 20.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 et précise la taille du fichier en mégaoctets. Par exemple, pour autoriser le fichier journal à atteindre une taille maximale de 10 mégaoctets, entrez la valeur 10. |
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. Par exemple, la valeur renvoyée pour 12 heures serait 12:00:00. |
Force |
Facultatif |
Paramètre de commutateur |
Supprime les invites de confirmation qui s’affichent avant d’effectuer des modifications. |
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.BandwidthPolicyServiceConfiguration.BandwidthPolicyServiceConfiguration. Accepte la saisie de données transmises via le pipeline pour les objets de configuration du service de stratégie de bande passante.
Types de retours
Cette cmdlet ne retourne aucune valeur. Elle modifie un objet de type Microsoft.Rtc.Management.WritableConfig.Settings.BandwidthPolicyServiceConfiguration.BandwidthPolicyServiceConfiguration.
Exemple
-------------------------- Exemple 1 --------------------------
Set-CsBandwidthPolicyServiceConfiguration -Identity site:Redmond -EnableLogging $true -MaxTokenLifetime 3:00:00 -LogCleanUpInterval 5.00:00:00
Cet exemple modifie la configuration du service de stratégie de bande passante du site de Redmond (-Identity site:Redmond). La configuration est modifiée dans le but d’activer la journalisation et de redéfinir la durée de vie maximale d’un jeton à trois heures et à cinq jours le nombre de jours devant s’écouler avant le nettoyage du journal. Tout ceci peut se faire au moyen d’une seule commande. Pour activer la journalisation, le paramètre EnableLogging est défini sur True ($true). Le paramètre MaxTokenLifetime reçoit ensuite une valeur 3:00:00, soit trois heures. Enfin, le paramètre LogCleanUpInterval reçoit une valeur 5.00:00:00, c’est-à-dire cinq jours.