Set-CsRgsWorkflow
Dernière rubrique modifiée : 2012-03-23
Modifie un workflow Response Group existant. Les workflows déterminent les actions exécutées lorsque l’application Response Group reçoit un appel téléphonique.
Syntaxe
Set-CsRgsWorkflow -Instance <Workflow> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Les workflows constituent peut-être l’élément clé de l’application Response Group. Chaque workflow est associé de manière unique à un numéro de téléphone ; lorsqu’une personne appelle ce numéro, le workflow détermine la manière de traiter l’appel. L’appel, par exemple, peut être transféré vers une série de questions du système de réponse vocale interactive qui demande à l’appelant d’entrer des informations supplémentaires (par exemple, « Appuyez sur 1 pour accéder au support matériel. Appuyez sur 2 pour accéder au support logiciel ».) L’appel peut être également placé dans une file d’attente et l’appelant est mis en attente jusqu’à ce que l’agent puisse répondre à l’appel. La disponibilité des agents pour répondre aux appels dépend également du workflow : les workflows permettent de définir les heures ouvrées (jours de la semaine et heures pendant lesquels les agents sont disponibles pour répondre aux appels) et les congés (jours pendant lesquels aucun agent n’est disponible pour répondre aux appels).
La cmdlet Set-CsRgsWorkflow permet de modifier les propriétés d’un workflow existant. Par exemple, vous pouvez changer le numéro de téléphone d’un workflow, les groupes d’agents associés à un workflow ou encore l’action par défaut à exécuter chaque fois que le workflow est déclenché (à savoir, chaque fois qu’une personne appelle le numéro de téléphone associé au workflow).
Set-CsRgsWorkflow ne modifie pas directement le workflow. Si vous voulez modifier un workflow, vous devez d’abord utiliser Get-CsRgsWorkflow pour créer une référence d’objet à ce workflow, ce qui signifie simplement que vous extrayez le workflow concerné et stockez l’objet retourné dans une variable. Une fois la référence d’objet créée, vous modifiez les propriétés de l’objet en mémoire, puis utilisez Set-CsRgsWorkflow pour écrire ces modifications dans le workflow réel de l’application Response Group. 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 la variable de référence d’objet.
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-CsRgsWorkflow : 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-CsRgsWorkflow"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Instance |
Obligatoire |
Objet Workflow |
Référence d’objet au workflow à modifier de l’application Response Group. Une référence d’objet est généralement extraite en utilisant la cmdlet Get-CsRgsWorkflow et en affectant la valeur retournée à une variable. Par exemple, cette commande retourne une référence d’objet au workflow Help Desk et la stocke dans une variable $x : $x = Get-CsRgsWorkflow service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" Le paramètre Instance est un paramètre positionnel : vous pouvez l’omettre tant que la référence d’objet au workflow correspond au premier paramètre employé dans votre commande. Ceci signifie que les deux commandes suivantes sont identiques d’un point de vue fonctionnel : Set-CsRgsWorkflow –Instance $x Set-CsRgsWorkflow $x |
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 |
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.Rgs.Management.WritableSettings.Workflow. Set-CsRgsWorkflow accepte également les instances redirigées de l’objet workflow Response Group.
Types de retours
Set-CsRgsWorkflow ne retourne ni objet ni valeur. À la place, cette cmdlet modifie les instances existantes de l’objet Microsoft.Rtc.Rgs.Management.WritableSettings.Workflow.
Exemple
-------------------------- Exemple 1 ------------------------
$businessHours = Get-CsRgsHoursOfBusiness service:ApplicationServer:atl-cs-001.litwareinc.com -Name "US Business Hours"
$y = Get-CsRgsWorkflow Service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$y.BusinessHoursId = $businessHours.Identity
Set-CsRgsWorkflow -Instance $y
Les commandes présentées dans l’exemple 1 extraient un ensemble d’heures ouvrées existant et affecte ces heures ouvrées à un workflow appelé Help Desk. Pour ce faire, la première commande de l’exemple utilise la cmdlet Get-CsRgsHoursOfBusiness pour extraire la collection d’heures ouvrées « US Business Hours » à partir du service ApplicationServer:atl-cs-001.litwareinc.com. Ces heures ouvrées sont stockées dans la variable $businessHours.
Une fois les heures ouvrées extraites, la cmdlet Get-CsRgsWorkflow est utilisée pour extraire le workflow Help Desk depuis ApplicationServer:atl-cs-001.litwareinc.com. Cet objet est stocké dans la variable $y.
Dans la troisième commande de l’exemple, la propriété BusinessHoursId du workflow Help Desk est définie sur la collection d’heures ouvrées extraite ; cette opération est exécutée en affectant à BusinessHoursId la valeur Identity de la collection extraite ($businessHours.Identity). Dans la dernière commande, la cmdlet Set-CsRgsWorkflow est utilisée pour écrire ces modifications (à savoir, les nouvelles heures ouvrées) dans le workflow Help Desk dans le service ApplicationServer:atl-cs-001.litwareinc.com. Cette ultime étape est primordiale puisque, à ce stade, toutes les modifications apportées ont eu lieu uniquement en mémoire. Pour enregistrer ces modifications dans le workflow Help Desk, vous devez appeler la cmdlet Set-CsRgsWorkflow et lui transmettre simultanément la référence d’objet ($y) contenant la copie virtuelle du workflow.
-------------------------- Exemple 2 ------------------------
$x = Get-CsRgsWorkflow service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$x.Description = "Workflow for the Redmond Help Desk"
Set-CsRgsWorkflow -Instance $x
L’exemple ci-dessus affecte une nouvelle description au workflow Help Desk stocké dans le service ApplicationServer:atl-cs-001.litwareinc.com. Pour cela, la première commande de l’exemple extrait le workflow spécifié (-Name "Help Desk") et stocke l’objet extrait dans une variable $x. Dans la deuxième commande, une nouvelle description (« Workflow for the Redmond Help Desk ») est ajoutée à la copie virtuelle du workflow Help Desk. Une fois la description modifiée, la troisième commande utilise la cmdlet Set-CsRgsWorkflow pour écrire les modifications dans le workflow Help Desk réel situé dans ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Exemple 3 ------------------------
$musicFile = Get-Content -ReadCount 0 -Encoding Byte C:\MediaFiles\Hold.wav | Import-CsRgsAudioFile -Identity Service:ApplicationServer:atl-cs-001.litwareinc.com -FileName "HelpDeskHoldMusic.wav"
$y = Get-CsRgsWorkflow -Identity Service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$y.CustomMusicOnHoldFile = $musicFile
Set-CsRgsWorkflow -Instance $y
Les commandes de l’exemple 3 importent un nouveau fichier Response Group et affectent ce fichier à un workflow existant. Pour ce faire, la première commande de l’exemple importe le nouveau fichier audio. Cette opération est exécutée en lisant le fichier audio (C:\MediaFiles\Test.wav), octet par octet, à l’aide de la cmdlet Get-Content. Pour garantir la lecture en bonne et due forme du fichier audio, incluez le paramètre ReadCount (défini sur 0) et le paramètre Encoding (défini sur Byte). Une fois le fichier audio lu, les données sont redirigées vers la cmdlet New-CsRgsAudioFile qui crée un nouveau fichier dans ApplicationServer:atl-cs-001.litwareinc.com. Une référence d’objet à ce fichier (nommé HelpDeskHoldMusic.wav) est stockée dans une variable appelée $musicFile.
Une fois le fichier audio créé, la deuxième commande extrait le workflow Help Desk depuis ApplicationServer:atl-cs-001.litwareinc.com en stockant l’objet retourné dans une variable $y. Dans la troisième commande, la propriété CustomMusicOnHoldFile de ce workflow est affectée de la valeur $musicFile, à savoir la variable contenant le fichier audio à peine créé.
Une fois la valeur $musicFile affectée à CustomMusicOnHoldFile, la dernière commande utilise la cmdlet Set-CsRgsWorkflow pour réécrire ces modifications dans le workflow Help Desk.