Get-CsMediaConfiguration
Dernière rubrique modifiée : 2012-03-23
Renvoie des informations sur les paramètres multimédias, notamment sur le niveau de chiffrement pris en charge, la possibilité pour le serveur de médiation d’utiliser le codec vocal Siren dans ses interactions avec des clients Microsoft Lync 2010 et la résolution vidéo maximale autorisée.
Syntaxe
Get-CsMediaConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsMediaConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
Description détaillée
Cette cmdlet extrait un ou plusieurs ensembles de paramètres définissant les interactions multimédias.
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-CsMediaConfiguration : 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-CsMediaConfiguration"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Facultatif |
XdsIdentity |
Identificateur unique de la configuration multimédia que vous souhaitez récupérer. Cet identificateur spécifie l’étendue dans laquelle cette configuration est appliquée (globale, Site ou Service). |
Filter |
Facultatif |
Chaîne |
Ce paramètre filtre les résultats de l’opération Get en fonction de la valeur à caractère générique transmise à ce paramètre. |
LocalStore |
Facultatif |
Paramètre de commutateur |
Récupère les informations sur la configuration multimédia à partir du réplica local du magasin central de gestion et non du magasin central de gestion même. |
Types d’entrées
Aucun.
Types de retours
Get-CsMediaConfiguration renvoie des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings.
Exemple
-------------------------- Exemple 1 --------------------------
Get-CsMediaConfiguration
L’exemple 1 renvoie toutes les configurations multimédias utilisés dans votre organisation. Il suffit pour cela d’appeler la cmdlet Get-CsMediaConfiguration sans aucun paramètre supplémentaire.
-------------------------- Exemple 2 --------------------------
Get-CsMediaConfiguration -Identity site:Redmond1
L’exemple précédent ne renvoie que les configurations multimédias comportant l’identité site:Redmond1. Les identités devant être uniques, la spécification d’une identité garantit que vous ne récupérerez jamais plus d’un élément.
-------------------------- Exemple 3 --------------------------
Get-CsMediaConfiguration -Filter site:*
Dans l’exemple 3, le paramètre Filter permet de retourner toutes les configurations multimédias dans l’étendue Site. La chaîne à caractère générique site:* s’assure que Windows PowerShell renvoie uniquement les configurations multimédias dont les identités commencent par la valeur de chaîne site:.
-------------------------- Exemple 4 --------------------------
Get-CsMediaConfiguration | Where-Object {$_.EncryptionLevel -eq "SupportEncryption"}
Dans cet exemple, Get-CsMediaConfiguration et Where-Object permettent de renvoyer toutes les configurations multimédias prenant en charge (mais ne nécessitant pas) le chiffrement. Pour ce faire, la commande utilise d’abord Get-CsMediaConfiguration pour extraire toutes les configurations multimédias utilisées dans votre organisation. Ces informations sont alors redirigées vers la cmdlet Where-Object, qui applique un filtre limitant les données renvoyées aux configurations dont la propriété EncryptionLevel est égale à (-eq) SupportEncryption.
-------------------------- Exemple 5 --------------------------
Get-CsMediaConfiguration -Filter *:*med*
Cet exemple illustre l’extraction de toutes les configurations multimédias définies pour les sites et services dont les noms incluent la chaîne « med ». Par exemple, cette commande extraira les paramètres de configuration multimédia définis pour le site medford1, le site TwoMedfordPlace et le service MediationServer:redmond.litwareinc.com.
Voir aussi
Autres ressources
New-CsMediaConfiguration
Remove-CsMediaConfiguration
Set-CsMediaConfiguration