Remove-CsRgsWorkflow
Dernière rubrique modifiée : 2012-03-23
Supprime 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
Remove-CsRgsWorkflow -Instance <Workflow> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Les workflows sont un é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 (« 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 peut être mis en attente jusqu’à ce qu’un agent puisse répondre à l’appel. La disponibilité des agents pour répondre aux appels dépend également du workflow : les workflows permettent de gérer 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).
Pour créer des workflows, utilisez la cmdlet New-CsRgsWorkflow. Une fois ces workflows créés, vous pouvez les supprimer par la suite à l’aide de la cmdlet Remove-CsRgsWorkflow. Notez que lorsque vous supprimez un workflow, il est complètement supprimé de l’application Response Group. Si vous voulez supprimer temporairement un workflow, n’utilisez pas Remove-CsRgsWorkflow, mais plutôt la cmdlet Set-CsRgsWorkflow pour désactiver (et réactiver par la suite) le workflow.
Si vous tentez de supprimer un workflow actif, Remove-CsRgsWorkflow vous demandera de confirmer la suppression ; Remove-CsRgsWorkflow n’entreprendra rien tant que vous ne répondrez pas à l’invite. Pour ignorer cette invite et supprimer silencieusement un workflow actif, utilisez le paramètre Force. Par exemple :
Get-CsRgsWorkflow –Identity "service:ApplicationServer:atl-cs-001.litwareinc.com " | Remove-CsRgsWorkflow –Force
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Remove-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 "Remove-CsRgsWorkflow"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Instance |
Facultatif |
Objet Workflow |
Référence d’objet pointant sur le workflow à supprimer. Lorsque vous redirigez des objets de workflow vers la cmdlet Remove-CsRgsWorkflow, vous pouvez ignorer le paramètre Instance. Pour utiliser le paramètre Instance, optez pour des commandes semblables à ce qui suit : $x = Get-CsRgsWorkflow –Identity ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83 Remove-CsRgsWorkflow –Instance $x Notez que seul un workflow à la fois peut être supprimé lorsque vous utilisez le paramètre Instance, ce qui signifie que votre référence d’objet ($x) ne peut pas contenir plusieurs objets de workflow. |
Force |
Facultatif |
Paramètre de commutateur |
Force la suppression du workflow. Si vous définissez ce paramètre, le worklflow est supprimé sans avertissement, même si le workflow est actif. Si vous ne le définissez pas, une invite demande de confirmer la suppression du workflow actif. |
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. Remove-CsRgsWorkflow accepte également les instances redirigées de l’objet de workflow Response Group.
Types de retours
Remove-CsRgsWorkflow supprime des instances existantes de l’objet Microsoft.Rtc.Rgs.Management.WritableSettings.Workflow.
Exemple
-------------------------- Exemple 1 ------------------------
Get-CsRgsWorkflow -Identity Service:ApplicationServer:atl-cs-001.litwareinc.com | Remove-CsRgsWorkflow
L’exemple 1 supprime tous les workflows Response Group du service ApplicationServer:atl-cs-001.litwareinc.com. Pour ce faire, la commande appelle d’abord Get-CsRgsWorkflow pour retourner une collection de tous les workflows détectés dans le service ApplicationServer:atl-cs-001.litwareinc.com. Cette collection est ensuite redirigée vers Remove-CsRgsWorkflow qui supprime chaque workflow de la collection.
-------------------------- Exemple 2 ------------------------
Get-CsRgsWorkflow service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Workflow" | Remove-CsRgsWorkflow
La commande de l’exemple 2 supprime un seul workflow Response Group : le workflow « Help Desk Workflow » situé dans le service ApplicationServer:atl-cs-001.litwareinc.com. Pour cela, la cmdlet Get-CsRgsWorkflow est d’abord utilisée pour retourner le workflow Help Desk Workflow du service ApplicationServer:atl-cs-001.litwareinc.com. Ce workflow est ensuite redirigé vers Remove-CsRgsWorkflow qui le supprime.
-------------------------- Exemple 3 ------------------------
Get-CsRgsWorkflow service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.Language -eq "en-us"} | Remove-CsRgsWorkflow
La commande ci-dessus supprime tous les workflows de langue anglaise des États-Unis du service ApplicationServer:atl-cs-001.litwareinc.com. Pour ce faire, la cmdlet Get-CsRgsWorkflow est d’abord utilisée pour extraire tous les workflows du service ApplicationServer:atl-cs-001.litwareinc.com. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les workflows dont la langue affiche la valeur « en-us » (anglais américain). Cette collection filtrée est ensuite redirigée vers la cmdlet Remove-CsRgsWorkflow qui supprime chaque élément de la collection.
-------------------------- Exemple 4 ------------------------
Get-CsRgsWorkflow service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.CustomMusicOnHoldFile -ne $Null} | Remove-CsRgsWorkflow
La commande présentée dans l’exemple 4 supprime tous les workflows Response Group du service ApplicationServer:atl-cs-001.litwareinc.com dont la propriété CustomMusicOnHold est affectée d’une valeur configurée. Pour ce faire, la commande utilise d’abord la cmdlet Get-CsRgsWorkflow pour retourner une collection de tous les workflows du service ApplicationServer:atl-cs-001.litwareinc.com. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les workflows dont la propriété CustomMusicOnHoldFile n’est pas égale à une valeur Null. (Dans ce cas, cela signifie qu’une musique personnalisée a été définie pour le workflow.) La collection filtrée est ensuite redirigée vers Remove-CsRgsWorkflow qui supprime chaque élément de la collection.