Partager via

  • Article

Set-CsMediaConfiguration

 

Dernière rubrique modifiée : 2012-03-26

Modifie une collection existante de paramètres média.

Syntaxe

Set-CsMediaConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-EnableQoS <$true | $false>] [-EnableSiren <$true | $false>] [-EncryptionLevel <SupportEncryption | RequireEncryption | DoNotSupportEncryption>] [-Force <SwitchParameter>] [-MaxVideoRateAllowed <CIF250K | VGA600K | Hd720p15M>] [-WhatIf [<SwitchParameter>]]

Set-CsMediaConfiguration [-Confirm [<SwitchParameter>]] [-EnableQoS <$true | $false>] [-EnableSiren <$true | $false>] [-EncryptionLevel <SupportEncryption | RequireEncryption | DoNotSupportEncryption>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxVideoRateAllowed <CIF250K | VGA600K | Hd720p15M>] [-WhatIf [<SwitchParameter>]]

Description détaillée

La cmdlet modifie la collection de paramètres définissant la configuration média. Ces actions concernent les appels audio et vidéo entre les points de terminaison clients.

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-CsMediaConfiguration : 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-CsMediaConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique des paramètres de configuration multimédia que vous souhaitez modifier. Cet identificateur spécifie l’étendue d’application de cette configuration (globale, site ou service).

Instance

Facultatif

MediaSettings

Instance de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings. Vous pouvez récupérer cet objet en appelant Get-CsMediaConfiguration avec une identité spécifique. Vous pouvez alors attribuer de nouvelles valeurs aux propriétés de l’objet, puis enregistrer ces modifications en transmettant l’objet à Set-CsMediaConfiguration.

EnableQoS

Facultatif

Booléen

QoS surveille la qualité des signaux vocaux sur un réseau.

EnableSiren

Facultatif

Booléen

Par défaut, le serveur de médiation ne négocie pas le Siren en tant que codec possible entre lui et les autres clients Microsoft Lync 2010. Si ce paramètre a la valeur True, le Siren sera inclus comme codec possible pour être utilisé entre le serveur de médiation et les autres clients Lync 2010.

EncryptionLevel

Facultatif

EncryptionLevel

Le niveau de chiffrement entre les entités Unified Communications.

Valeurs valides :

SupportEncryption - Le protocole SRTP (protocole de transport sécurisé en temps réel), si négociable.

RequireEncryption - Le protocole SRTP doit être négocié.

DoNotSupportEncryption - Il ne faut pas utiliser le protocole SRTP.

Cette valeur n’est pas sensible à la casse. (Pour plus d’informations, consultez les exemples de cette rubrique.)

Valeur par défaut : RequireEncryption

MaxVideoRateAllowed

Facultatif

MaxVideoRateAllowed

Débit maximal auquel les signaux vidéo seront transférés aux points de terminaison du client.

Valeurs valides : Hd720p15M, VGA600K, CIF250K

Hd720p15M - Haute définition, avec une résolution de 1280 x 720 et un format d’image 16:9.

VGA600K - VGA, avec une résolution de 640 x 480, 25 i/s avec un format d’image 4:3.

CIF250K - Format vidéo CIF (Common Intermediate Format), 15 i/s avec une résolution de 352 x 288.

Notez que ces valeurs ne sont pas sensibles à la casse. Elles seront converties dans la casse appropriée lors de la création de la configuration. (Pour plus d’informations, consultez les exemples de cette rubrique.)

Valeur par défaut : VGA600K

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.Media.MediaSettings. Accepte la saisie de données transmises via le pipeline pour les objets de configuration multimédia.

Types de retours

Set-CsMediaConfiguration ne retourne ni valeur ni objet. Au lieu de cela, la cmdlet configure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.Media.MediaSettings.

Exemple

-------------------------- Exemple 1 --------------------------

Set-CsMediaConfiguration -Identity site:Redmond1 -MaxVideoRateAllowed hd720p15m

L’exemple ci-dessus modifie la collection de configurations multimédias dont l’identité est site:Redmond1 ; en particulier, la commande définit la propriété MaxVideoRateAllowed sur la valeur Hd720p15M. Veuillez noter que la valeur transmise au paramètre MaxVideoRateAllowed doit être l’une des valeurs spécifiées dans la description du paramètre. Notez également que les valeurs ne sont pas sensibles à la casse. La valeur hd720p15m saisie ici sera automatiquement convertie à la casse appropriée (dans ce cas précis, Hd720p15M).

-------------------------- Exemple 2 --------------------------

Set-CsMediaConfiguration site:Redmond1 -EncryptionLevel donotsupportencryption

Cet exemple modifie la collection de configurations multimédias dont l’identité est site:Redmond1 pour que la valeur de EncryptionLevel soit DoNotSupportEncryption. Veuillez noter que cette valeur n’est pas sensible à la casse. La valeur saisie était donotsupportencryption, mais cette valeur sera acceptée en tant que valeur valide et une casse mixte lui sera automatiquement appliquée (DoNotSupportEncryption).