Set-CsDialInConferencingDtmfConfiguration
Dernière rubrique modifiée : 2012-03-27
Modifie les paramètres de signalisation DTMF (Dual Tone Multi-Frequency) de la conférence 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
Set-CsDialInConferencingDtmfConfiguration [-Identity <XdsIdentity>] [-AdmitAll <String>] [-AudienceMuteCommand <String>] [-CommandCharacter <String>] [-Confirm [<SwitchParameter>]] [-EnableDisableAnnouncementsCommand <String>] [-Force <SwitchParameter>] [-HelpCommand <String>] [-LockUnlockConferenceCommand <String>] [-MuteUnmuteCommand <String>] [-PrivateRollCallCommand <String>] [-WhatIf [<SwitchParameter>]]
Set-CsDialInConferencingDtmfConfiguration [-AdmitAll <String>] [-AudienceMuteCommand <String>] [-CommandCharacter <String>] [-Confirm [<SwitchParameter>]] [-EnableDisableAnnouncementsCommand <String>] [-Force <SwitchParameter>] [-HelpCommand <String>] [-Instance <PSObject>] [-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 ou 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.
La cmdlet Set-CsDialInConferencingDtmfConfiguration vous permet de modifier les touches utilisées pour déclencher les commandes prises en charge dans une conférence rendez-vous Lync Server 2010.
Si vous modifiez des commandes DTMF, gardez deux points à l’esprit. Tout d’abord, vous pouvez uniquement utiliser les touches numériques 0 à 9 ; toute autre touche disponible sur votre clavier (telle que la touche #) n’est pas autorisée. Il existe une exception à cette règle : le paramètre CommandCharacter vous permet d'utiliser uniquement la touche astérisque (*) ou la touche dièse (#) ; vous ne pouvez pas affecter de valeur numérique au paramètre CommandCharacter. Néanmoins, tous les autres paramètres des commandes n'acceptent que les valeurs numériques.
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 remplacer les touches utilisées par deux différentes commandes. Par exemple, si vous souhaitez affecter la touche 4 à la clé 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 Set-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 "Set-CsDialInConferencingDtmfConfiguration"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
Chaîne |
Indique l’identificateur unique de la collection de paramètres DTMF que vous souhaitez modifier. Pour indiquer les paramètres globaux, utilisez cette syntaxe : -Identity global. Pour spécifier une collection configurée dans l’étendue Site, utilisez une syntaxe similaire à celle-ci : -Identity site:Redmond. Notez que les caractères génériques ne sont pas autorisés pour spécifier une identité. Si ce paramètre n'est pas spécifié, Set-CsDialInConferencingDtmfConfiguration modifiera alors les paramètres DTMF globaux. |
Instance |
Facultatif |
Objet DialInConferencingDtmfConfiguration |
Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles. |
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 désactiver le microphone de toute autre personne participant à la conférence (toute personne qui n’est pas le présentateur verra son microphone 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 la touche dièse (#). |
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 |
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. |
|
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.DialInConferencingSettings.DialInConferencingDtmfConfiguration. Set-CsDialInConferencingDtmfConfiguration accepte les instances transmises via le pipeline de l'objet de configuration DTMF de la conférence rendez-vous.
Types de retours
Set-CsDialInConferencingDtmfConfiguration ne retourne ni valeur, ni objet. Au lieu de cela, la cmdlet configure les instances de l'objet Microsoft.Rtc.Management.WritableConfig.Settings.DialInConferencingSettings.DialInConferencingDtmfConfiguration.
Exemple
-------------------------- Exemple 1 ------------------------
Set-CsDialInConferencingDtmfConfiguration -Identity global -EnableDisableAnnouncementsCommand 4 -AudienceMuteCommand 9
La commande présentée dans l'exemple 1 remplace les touches affectées à la commande pour l'activation et la désactivation des annonces (valeur par défaut : 9) et la commande d’activation et de désactivation du microphone de tous les participants (valeur par défaut : 4) pour les paramètres DTMF globaux. Pour ce faire, deux différents paramètres sont utilisés : EnableDisableAnnoucementsCommand auquel la valeur 4 est attribuée et AudienceMuteCommand auquel la valeur 9 est attribuée. Aucune identité n'étant spécifiée, ces changements affecteront les paramètres DTMF globaux.
-------------------------- Exemple 2 ------------------------
Set-CsDialInConferencingDtmfConfiguration -Identity site:Redmond -EnableDisableAnnouncementsCommand 4 -AudienceMuteCommand 9
La commande présentée dans l’exemple 2 est une variation de la commande présentée dans le premier exemple. Dans ce cas néanmoins; les changements affectent les paramètres DTMF qui ont l’identité site:Redmond.
-------------------------- Exemple 3 ------------------------
Set-CsDialInConferencingDtmfConfiguration -Identity "site:Redmond" -PrivateRollCallCommand $Null
La commande montrée dans l'exemple 3 désactive la commande de liste de présence (capacité à lire une liste de tous les participants à une conférence) pour le site de Redmond. Pour désactiver cette commande, le paramètre PrivateRollCallCommand est inclus, avec la valeur de paramètre $Null. Cela signifie qu'aucune touche du clavier ne sera associée à la commande, ce qui rend la commande indisponible aux utilisateurs.
-------------------------- Exemple 4 ------------------------
Get-CsDialInConferencingDtmfConfiguration -Filter "site:*" | Set-CsDialInConferencingDtmfConfiguration -PrivateRollCallCommand $Null
L’exemple 4 est une variante de l’exemple 3 : dans cet exemple, la commande de liste de présence est désactivée pour tous les paramètres DTMF définis dans l'étendue Site. Pour cela, la commande utilise d'abord Get-CsDialInConferencingDtmfConfiguration et le paramètre Filter pour retourner une collection de tous les paramètres configurés au niveau de l'étendue Site ; la valeur de filtre « site:* » restreint les données retournées aux paramètres dont l'identité commence par les caractères « site: ». Cette collection filtrée est alors redirigée vers Set-CsDialInConferencingDtmfConfiguration qui définit la valeur de la propriété PrivateRollCallCommand sur Null ($Null).