Import-CsRgsAudioFile
Dernière rubrique modifiée : 2012-03-23
Importe un nouveau fichier audio à utiliser dans l’application Response Group.
Syntaxe
Import-CsRgsAudioFile -Identity <RgsIdentity> -Content <Byte[]> -FileName <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Description détaillée
L’application Response Group peut utiliser des fichiers audio (au format .WAV ou .WMA uniquement) de deux moyens différents au moins. Par exemple, le service peut diffuser une musique (ou une annonce d’un type quelconque) chaque fois que des appelants sont mis en attente. De même, l’application Response Group s'adresse et « parle » aux appelants ; par exemple, via le système de réponse vocale interactive, le service peut poser une question du type « Appelez-vous au sujet d’une commande en cours ? » aux appelants. Vous pouvez demander au service de lire ces questions à l’aide de la technologie de conversion de texte par synthèse vocale (TTS) ou vous pouvez aussi diffuser un enregistrement audio d’une personne chargée de poser la question.
Quelle que soit la manière dont vous décidez d’utiliser les fichiers audio, vous devez importer ces fichiers dans l’application Response Group à l’aide de la cmdlet Import-CsRgsAudioFile. Notez que vous devez exécuter Import-CsRgsAudioFile chaque fois que vous voulez utiliser un fichier audio, même si ce fichier est déjà utilisé ailleurs dans l’application Response Group. Par exemple, supposons que le workflow A exploite un fichier audio en particulier en guise de musique d’attente personnalisée mais que vous souhaitez à présent utiliser ce fichier audio comme musique d’attente personnalisée pour le workflow B. Même si le fichier audio est déjà utilisé par l’application Response Group, vous devez importer le fichier pour pouvoir l’utiliser avec le workflow B.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Import-CsRgsAudioFile : RTCUniversalServerAdmins. Vous devez également disposer d’un accès en écriture au magasin de fichiers d’ordinateurs cibles. 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 "Import-CsRgsAudioFile"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
RgsIdentity |
Identité du service dans lequel le fichier audio est à importer. (Il doit s’agir du même service que celui qui héberge l’application Response Group.) Par exemple : -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com". |
Content |
Obligatoire |
Tableau d’octets |
Contenu du fichier audio à importer. La propriété Content est renseignée en appelant la cmdlet Get-Content. Lors de l’appel de Get-Content, attribuez au paramètre Encoding la valeur « byte » et au paramètre ReadCount la valeur 0 (consultez la section Exemples ci-après de cette rubrique pour plus d’informations). |
FileName |
Obligatoire |
Chaîne |
Nom du fichier audio à importer. Par exemple, le nom du fichier C:\Media\Welcome.wav est : Welcome.wav. |
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. |
WhatIf |
Paramètre de commutateur |
Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement. |
|
Confirm |
Paramètre de commutateur |
Vous demande confirmation avant d’exécuter la commande. |
Types d’entrées
Aucun. Import-CsRgsAudioFile n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Crée des instances de l’objet Microsoft.Rtc.Rgs.Management.WritableSettings.AudioFile.
Exemple
-------------------------- Exemple 1 ------------------------
$x = Import-CsRgsAudioFile -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -FileName "WhileYouWait.wav" -Content (Get-Content C:\Media\WhileYouWait.wav -Encoding byte -ReadCount 0)
$y = Get-CsRgsWorkflow -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "Help Desk Workflow"
$y.CustomMusicOnHoldFile = $x
Set-CsRgsWorkflow $y
Les commandes présentées dans l’exemple 1 importent un fichier audio (C:\Media\WhileYouWait.wav), puis affectent ce fichier à la propriété CustomMusicOnHold d’un workflow. Pour exécuter cette tâche, la première commande utilise Import-CsRgsAudioFile pour importer le fichier audio vers l’application Response Group détectée sur ApplicationServer:atl-cs-001.litwareinc.com. Outre le paramètre Identity (qui définit l’emplacement du service), le paramètre FileName est utilisé pour préciser le nom du fichier à importer.
Le paramètre Content permet simultanément d’importer le fichier audio. L’importation du fichier est réalisée en appelant la cmdlet Get-Content suivie du chemin d’accès au fichier à importer. Get-Content implique également de définir le type de codage sur « byte » et d’affecter la valeur 0 à ReadCount (pour s’assurer que l’ensemble du fichier est lu en une seule fois). Le fichier importé est ensuite stocké dans une variable $x.
Dans la deuxième commande, la cmdlet Get-CsRgsWorkflow permet de créer une référence d’objet ($y) au workflow Help Desk Workflow. Une fois cette référence d’objet créée, la troisième commande définit la propriété CustomMusicOnHold sur la variable $x (qui contient le fichier audio importé). Enfin, la dernière commande de l’exemple utilise la cmdlet Set-CsRgsWorkflow pour écrire ces modifications dans le workflow Help Desk Workflow. Si vous n’appelez pas la cmdlet Set-CsRgsWorkflow, les modifications existeront en mémoire uniquement et disparaîtront au moment même où vous fermerez Windows PowerShell ou supprimerez les variables $x ou $y.