New-CsDialInConferencingDtmfConfiguration
Dernière rubrique modifiée : 2012-03-23
Crée une collection de paramètres de signalisation DTMF (Dual Tone Multi-Frequency) utilisés pour les conférences rendez-vous. DTMF permet aux utilisateurs qui prennent part à une conférence de contrôler les paramètres de conférence (tels que l’activation et la désactivation de leur microphone ou le verrouillage et le déverrouillage de la conférence) à l’aide du clavier de leur téléphone.
Syntaxe
New-CsDialInConferencingDtmfConfiguration -Identity <XdsIdentity> [-AdmitAll <String>] [-AudienceMuteCommand <String>] [-CommandCharacter <String>] [-Confirm [<SwitchParameter>]] [-EnableDisableAnnouncementsCommand <String>] [-Force <SwitchParameter>] [-HelpCommand <String>] [-InMemory <SwitchParameter>] [-LockUnlockConferenceCommand <String>] [-MuteUnmuteCommand <String>] [-PrivateRollCallCommand <String>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Microsoft Lync Server 2010 permet aux utilisateurs de prendre part à des conférences en s’y connectant par l’intermédiaire de leur téléphone. Les utilisateurs connectés par téléphone ne peuvent pas visualiser des vidéos ou échanger des messages instantanés avec d’autres participants à la conférence, mais ils peuvent prendre part à la partie audio de la réunion.
Outre le fait de pouvoir participer à une conférence, les utilisateurs peuvent aussi gérer des parties spécifiques de cette conférence par l’intermédiaire du clavier de leur téléphone. (Les paramètres de conférence spécifiques que les utilisateurs peuvent ou ne peuvent pas gérer dépendent de leur rôle : présentateur ou non présentateur.) Par exemple, par défaut, les utilisateurs peuvent appuyer sur la touche 6 de leur clavier pour activer ou désactiver leur microphone. Les participants peuvent visualiser en privé les noms de toutes les personnes qui suivent la réunion, alors que les présentateurs peuvent effectuer des opérations comme activer/désactiver le microphone de tous les participants à la réunion et activer/désactiver l’annonce effectuée à chaque fois que quelqu’un rejoint ou quitte une conférence.
La possibilité de réaliser des sélections comme celles-ci via un clavier de téléphone porte le nom de signalisation DTMF (dual-tone multi-frequency) : si après avoir composé un numéro de téléphone, vous avez suivi des instructions, telles que « Appuyez sur 1 pour Anglais ou appuyez sur 2 pour Espagnol », alors vous avez eu recours à la signalisation DTMF.
Lorsque vous installez Lync Server 2010, une collection globale de paramètres DTMF est automatiquement créée. Outre ces paramètres globaux, vous pouvez utiliser la cmdlet New-CSDialInConferencingDtmfConfiguration pour créer des paramètres personnalisés en fonction de chaque site. Par exemple, vous pouvez créer une collection de paramètres pour le site Redmond (et uniquement pour ce site) qui utilise la touche 4 au lieu de la touche 6 pour activer/désactiver le microphone des participants. Notez que les paramètres que vous configurez pour le site prévalent sur les paramètres configurés globalement. Par conséquent, les utilisateurs du site Redmond utiliseront la touche 4 pour activer/désactiver leur microphone même si les paramètres globaux utilisent la touche 6.
Vous ne pouvez disposer que d’une seule collection de paramètres DTMF et une seule collection globale par site. Par exemple, supposons que vous disposez déjà d’une collection avec l’identité site:Redmond et que vous exécutez cette commande :
New- CSDialInConferencingDtmfConfiguration –Identity site:Redmond
La commande échoue, car la collection site:Redmond existe déjà. Si vous souhaitez modifier les paramètres du site Redmond, utilisez la cmdlet Set-CSDialInConferencingDtmfConfiguration ou supprimez la collection existante, puis créez une nouvelle collection qui utilise l’identité site:Redmond.
Lors de la configuration des valeurs pour les commandes DTMF, gardez deux points à l’esprit. Tout d’abord, vous pouvez uniquement utiliser les touches numériques 0 à 9 et l’astérisque (*) ; toute autre touche disponible sur votre clavier (telle que la touche #) n’est pas autorisée. (Il y a néanmoins une exception à cette règle : CommandCharacter n’accepte que les touches * et #.) Deuxièmement, des touches uniques doivent être affectées aux commandes ; par exemple, la touche 4 ne peut pas être utilisée à la fois pour activer/désactiver votre microphone et pour verrouiller/déverrouiller une conférence. Cela signifie que lorsque vous changez les touches affectées à une commande, vous pouvez être amené à intervertir les touches utilisées par deux commandes différentes. Par exemple, si vous souhaitez affecter la touche 4 à EnableDisableAnnouncementsCommand (valeur par défaut : 9), vous devez dans la même commande affecter la touche 9 à AudienceMuteCommand.
Pour désactiver une commande, définissez sa valeur à Null ($Null).
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-CsDialInConferencingDtmfConfiguration : 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-CsDialInConferencingDtmfConfiguration"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
XdsIdentity |
Identificateur unique à affecter à la nouvelle collection de paramètres de configuration DTMF. Puisque vous ne pouvez créer que de nouvelles collections dans l’étendue du site, l’identité sera toujours le préfixe « site: » suivi du nom de site ; par exemple « site:Redmond ». |
AdmitAll |
Facultatif |
Chaîne |
Indique la touche à utiliser pour autoriser tous les utilisateurs présents dans la salle d’attente à rejoindre immédiatement la conférence. La valeur par défaut est 8. |
AudienceMuteCommand |
Facultatif |
Chaîne |
Indique la touche sur laquelle un présentateur doit appuyer pour activer ou désactiver le microphone de toute autre personne participant à la conférence (toute personne qui n’est pas le présentateur verra son microphone activé ou désactivé). La touche par défaut est 4. |
CommandCharacter |
Facultatif |
Chaîne |
Indique la touche à utiliser au début d’une commande. La touche par défaut est l’astérisque (*). La seule autre valeur autorisée est #. |
EnableDisableAnnouncementsCommand |
Facultatif |
Chaîne |
Indique la touche à utiliser pour activer ou désactiver l’annonce effectuée à chaque fois que quelqu’un rejoint ou quitte la conférence. La touche par défaut est 9. |
HelpCommand |
Facultatif |
Chaîne |
Indique la touche à utiliser pour visualiser en privé une description de toutes les commandes DTMF. La touche par défaut est 1. |
LockUnlockConferenceCommand |
Facultatif |
Chaîne |
Indique la touche à utiliser pour verrouiller ou déverrouiller une conférence. Si une conférence est verrouillée, aucun nouveau participant ne sera autorisé à prendre part à cette conférence, tout du moins tant que la conférence n’a pas été déverrouillée. La touche par défaut est 7. |
MuteUnmuteCommand |
Facultatif |
Chaîne |
Indique la touche à utiliser pour activer ou désactiver votre microphone ; la même touche est utilisée pour basculer entre les deux états. La touche par défaut est 6. |
PrivateRollCallCommand |
Facultatif |
Chaîne |
Indique la touche à utiliser pour visualiser en privé le nom de chaque participant à la conférence. La touche par défaut est 3. |
Force |
Facultatif |
Paramètre de commutateur |
Supprime l’affichage de tous les messages d’erreur récupérable susceptibles d’apparaître lors de l’exécution de la commande. |
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. New-CsDialInConferencingDtmfConfiguration n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Crée de nouvelles instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration
Exemple
-------------------------- Exemple 1 ------------------------
New-CSDialInConferencingDtmfConfiguration -Identity site:Redmond -MuteUnmuteCommand 4 -AudienceMuteCommand 6
La commande illustrée dans l’exemple 1 crée une collection de paramètres de configuration DTMF pour le site Redmond. Dans cet exemple, la propriété MuteUnmuteCommand est définie sur 4 et la propriété AudienceMuteCommand sur 6.
-------------------------- Exemple 2 ------------------------
New-CSDialInConferencingDtmfConfiguration -Identity site:Redmond -AdmitAll $Null
La commande précédente crée une nouvelle collection de paramètres de configuration DTMF pour le site Redmond (site:Redmond). Dans cet exemple, la propriété AdmitAll est désactivée ; pour cela le paramètre –AdmitAll est utilisé et sa valeur est définie sur Null.
-------------------------- Exemple 3 ------------------------
$x = New-CSDialInConferencingDtmfConfiguration -Identity site:Redmond -InMemory
$x.AdmitAll = $Null
$x.MuteUnmuteCommand = 4
$x.AudienceMuteCommand = 6
Set-CSDialInConferencingDtmfConfiguration -Instance $x
L’exemple 3 vous montre comment utiliser le paramètre InMemory pour créer une instance, uniquement en mémoire, d’une collection de paramètres de configuration DTMF, modifier ces paramètres, puis utiliser Set-CSDialInConferencingDtmfConfiguration pour créer une collection avec l’identité site:Redmond. Pour cela, la première commande dans l’exemple crée une instance, uniquement en mémoire, d’une collection de paramètres de configuration DTMF et stocke cette instance dans une variable nommée $x. Ces paramètres existeront uniquement en mémoire ; si vous fermez Windows PowerShell ou supprimez la variable $x, les paramètres disparaîtront et ne seront jamais appliqués au site Redmond.
Les 3 commandes suivantes modifient les propriétés de cette collection de paramètres DTMF « virtuelle » : les commandes 2, 3 et 4 affectent de nouvelles valeurs à AdmitAll, MuteUnmuteCommand et AudienceMuteCommand, respectivement. La dernière commande utilise alors Set-CSDialInConferencingDtmfConfiguration et le paramètre Instance pour transformer les paramètres virtuels stockés dans $x en collection réelle de paramètres configurés pour le site Redmond.