Partager via


New-CsMediaConfiguration

 

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

Crée un nouveau regroupement de paramètres multimédias. Ces paramètres peuvent être utilisés pour spécifier des éléments comme le niveau de chiffrement pris en charge et la résolution vidéo maximale autorisée.

Syntaxe

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

Description détaillée

Cette cmdlet crée un nouveau regroupement de paramètres qui définissent les comportements d’actions multimédias spécifiques.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Identificateur unique qui spécifie l’étendue d’application de cette configuration (site ou service). Une configuration au niveau de l’étendue Site serait saisie comme suit site:<nom site>, comme site:Redmond. Un service serait saisi comme suit <rôle serveur>:<nom de domaine complet>, comme MediationServer:pool0.litwareinc.com. La configuration multimédia au niveau de l’étendue globale existera toujours et ne peut être supprimée. Il est donc impossible de créer une nouvelle configuration globale.

Les configurations multimédias au niveau de l’étendue Service ne peuvent être créées que pour le service de conférence A/V, le serveur de médiation et le serveur d’applications.

EnableQoS

Facultatif

Booléen

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

Valeur par défaut : False

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.

Valeur par défaut : False

EncryptionLevel

Facultatif

EncryptionLevel

Niveau de chiffrement entre les entités Unified Communications.

Valeurs valides :

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

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

DoNotSupportEncryption - Le protocole SRTP ne doit pas être utilisé.

Valeur par défaut : RequireEncryption

MaxVideoRateAllowed

Facultatif

MaxVideoRateAllowed

Débit maximal auquel les signaux vidéo seront transférés aux systèmes d’extrémité 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. Les valeurs seront converties dans la casse appropriée lors de la création de la configuration.

Valeur par défaut : VGA600K

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.Media.MediaSettings.

Exemple

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

New-CsMediaConfiguration -Identity site:Redmond1 -EncryptionLevel RequireEncryption

L’exemple 1 utilise New-CsMediaConfiguration pour créer une nouvelle configuration multimédia dont l’identité est site:Redmond1. Cette configuration requiert les deux parties impliquées dans une conversation multimédia pour utiliser le chiffrement. Pour spécifier cette exigence, vous devez ajouter le paramètre EncryptionLevel et définir la valeur du paramètre sur RequireEncryption.

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

New-CsMediaConfiguration -Identity MediationServer:pool0.litwareinc.com -EnableSiren $True

Cet exemple utilise New-CsMediaConfiguration pour créer une nouvelle configuration multimédia dont l’identité est MediationServer:pool0.litwareinc.com. La valeur EnableSiren de cette nouvelle configuration est définie sur True, ce qui signifie que le Siren est activé pour les appels impliquant ce serveur de médiation.