Get-CsBandwidthPolicyServiceConfiguration
Dernière rubrique modifiée : 2012-03-23
Récupère une ou plusieurs configurations de service de stratégie de bande passante.
Syntaxe
Get-CsBandwidthPolicyServiceConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsBandwidthPolicyServiceConfiguration [-Filter <String>] [-LocalStore <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. La cmdlet Get-CsBandwidthPolicyServiceConfiguration récupère les paramètres d’un ou plusieurs services de stratégie de bande passante.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Get-CsBandwidthPolicyServiceConfiguration : RTCUniversalUserAdmins, 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 "Get-CsBandwidthPolicyServiceConfiguration"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
XdsIdentity |
Identificateur unique de la configuration que vous souhaitez récupérer. Cet identificateur consiste en l’étendue (pour la configuration globale), ou encore en l’étendue et le nom (pour une configuration au niveau du site, telle que site:Redmond). |
Filter |
Facultatif |
Chaîne |
Chaîne contenant un ou plusieurs caractères génériques qui seront utilisés pour rechercher la propriété Identity de toutes les configurations de service de stratégie de bande passante, afin de trouver chaque configuration dont la propriété Identity correspond au modèle de caractères génériques. Par exemple, la valeur de filtre site:* retourne toutes les configurations dont les valeurs Identity commencent par la chaîne site: et finissent par n’importe quel ensemble de caractères. |
LocalStore |
Facultatif |
Paramètre de commutateur |
Extrait la configuration du service de stratégie de bande passante depuis le réplica local du magasin central de gestion et non directement du magasin central de gestion. |
Types d’entrées
Aucun.
Types de retours
Retourne un ou plusieurs objets de type Microsoft.Rtc.Management.WritableConfig.Settings.BandwidthPolicyServiceConfiguration.BandwidthPolicyServiceConfiguration.
Exemple
-------------------------- Exemple 1 --------------------------
Get-CsBandwidthPolicyServiceConfiguration
L’exemple 1 récupère toutes les configurations de service de stratégie de bande passante définies dans le déploiement de Microsoft Lync Server 2010.
-------------------------- Exemple 2 --------------------------
Get-CsBandwidthPolicyServiceConfiguration -Identity site:Redmond
Cet exemple récupère la configuration de service de stratégie de bande passante du site Redmond (-Identity site:Redmond).
-------------------------- Exemple 3 --------------------------
Get-CsBandwidthPolicyServiceConfiguration -Filter site:*
Dans cet exemple, nous utilisons le paramètre Filter pour récupérer toutes les configurations de service de stratégie de bande passante définies au niveau du site. Pour ce faire, nous transmettons la valeur site:* au paramètre Filter. Cette tâche recherche la propriété Identity de toutes les configurations de service de stratégie de bande passante pour les valeurs commençant par site: et se terminant par n’importe quels autres caractères. Les configurations au niveau du site ayant des valeurs Identity commençant par site: suivies du nom du site, ce filtre retrouve toutes les configuration de tous les sites.
-------------------------- Exemple 4 --------------------------
Get-CsBandwidthPolicyServiceConfiguration | Where-Object {$_.MaxLogFileSizeMb -gt 4}
L’exemple 4 récupère toutes les configurations de service de stratégie de bande passante permettant aux fichiers journaux d’atteindre des tailles supérieures à quatre Mo. L’exemple commence par appeler la cmdlet Get-CsBandwidthPolicyServiceConfiguration. Comme dans l’exemple 1, cette cmdlet récupère une collection de toutes les configurations définies dans le déploiement de Lync Server. Cette collection est ensuite redirigée vers la cmdlet Where-Object. Where-Object passe la collection en revue, un élément après l’autre. Pour chaque élément de la collection, Where-Object vérifie si la valeur de la propriété MaxLogFileSizeMb est supérieure (-gt) à 4. Si tel est le cas, l’élément continue de faire partie de la collection et il fait également partie de la sortie de commande. Si la valeur de MaxLogFileSizeMb n’est pas supérieure à 4, l’élément est ignoré et ne sera pas retourné.