Partager via

  • Article

Set-CsCallParkServiceMusicOnHoldFile

 

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

Modifie le fichier audio qui sera lu aux appelants en attente dans un appel mis en garde.

Syntaxe

Set-CsCallParkServiceMusicOnHoldFile -Service <String> -Content <Byte[]> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Description détaillée

La mise en garde (ou parcage) d’appels est un service qui permet à un utilisateur de « mettre en garde » un appel téléphonique entrant. Le parcage d’un appel a pour effet de transférer ce dernier dans une plage définie et de le mettre immédiatement en attente. En fonction des paramètres de configuration spécifiés pour le service de mise en garde d’appels, une attente musicale peut être proposée à l’appelant pendant le parcage de l’appel. Cette cmdlet vous permet de modifier le fichier audio (attente musicale) qui est lu à un appelant mis en garde pendant qu’il patiente.

L’attente musicale est jouée uniquement si la propriété EnableMusicOnHold du service de mise en garde d’appels a la valeur True. Vous pouvez vérifier cette propriété en appelant la cmdlet Get-CsCpsConfiguration. Vous pouvez définir la propriété soit au moment de créer la configuration du parcage d’appel au moyen de la cmdlet New-CsCpsConfiguration, soit une fois cette configuration créée en appelant la cmdlet Set-CsCpsConfiguration. Par défaut, cette propriété a la valeur True.

Microsoft Lync Server 2010 est fourni avec un fichier de service de mise en garde d’appels par défaut pour l’attente musicale. Le fichier par défaut sera utilisé si vous n’attribuez aucun fichier audio.

Les fichiers audio doivent adopter l’un des formats suivants : Windows Media Audio 9, 44 kHz, 16 bits, Mono, CBR (taux binaire constant) ou 32 Kbits/s.

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

Paramètres

Paramètre Obligatoire Type Description

Service

Obligatoire

ServiceId

L’ID du service où réside le service de mise en garde d’appels (par exemple, ApplicationServer:pool0.litwareinc.com).

Content

Obligatoire

Byte[]

Contenu du fichier audio en octets.

Utilisez la cmdlet Get-Content pour extraire le contenu du fichier audio sous forme d’octets. (Pour plus d’informations, consultez les exemples de cette rubrique.)

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

Byte[]. Accepte la saisie de données transmises via le pipeline d’un tableau d’octets contenant le fichier d’attente musicale.

Types de retours

Cette cmdlet ne retourne aucune valeur.

Exemple

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

$a = Get-Content -ReadCount 0 -Encoding byte "C:\MoHFiles\soothingmusic.wma"
Set-CsCallParkServiceMusicOnHoldFile -Service ApplicationServer:pool0.litwareinc.com -Content $a

Cet exemple définit le fichier SoothingMusic.wma et le désigne comme le fichier audio qui sera lu aux personnes dont les appels ont été mis en garde. La première ligne de cet exemple est un appel à la cmdlet Windows PowerShell intégrée Get-Content. Cette cmdlet lit le contenu d’un fichier et l’affecte, dans le cas présent, à la variable $a. Une valeur 0 est transmise au paramètre ReadCount afin que la cmdlet Get-Content puisse lire immédiatement le fichier tout entier (plutôt que d’essayer de le lire ligne après ligne, ce qui n’est pas possible dans le cas d’un fichier audio). Le paramètre Encoding (codage) est défini avec la valeur « byte » (octet). Ceci indique à la cmdlet Get-Content que le contenu que nous cherchons à lire dans la variable $a est un tableau d’octets et non le fichier audio au format .wma.

La ligne 2 de cet exemple désigne le site auquel le fichier audio est réellement affecté. Il reste à appeler la cmdlet Set-CsCallParkServiceMusicOnHoldFile et à préciser l’ID du service dans lequel le service de mise en garde d’appels est exécuté. Le contenu du fichier audio lu dans la variable $a est ensuite transmis au paramètre Content (contenu). N’oubliez pas que ce contenu doit être affiché en octets.