Remove-CsRgsAgentGroup
Dernière rubrique modifiée : 2012-05-21
Supprime un groupe d’agents Response Group existant. Un groupe d’agents est une collection d’agents affectés à une file d’attente Response Group. Les agents sont les utilisateurs chargés de répondre à des appels adressés à une file d’attente en particulier.
Syntaxe
Remove-CsRgsAgentGroup -Instance <AgentGroup> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Lorsqu’une personne appelle un numéro de téléphone associé à l’application Response Group, le service identifie d’abord le workflow qui correspond au numéro appelé. En fonction de la configuration de ce workflow, l’appel peut être routé vers une série de questions du système de réponse vocale interactive (plusieurs questions sont posées à l’appelant à la suite d’une première question de type « S’agit-il d’une question de support matériel ou de support logiciel ? »). L’appel peut être également placé dans une file d’attente Response Group. Dans ce cas, l’appelant est mis en attente jusqu’à ce qu’une personne désignée soit disponible pour lui répondre. Les personnes désignées pour répondre aux appels sont des agents. Pour parler d’une collection d’agents, on utilisera le terme de « groupe d’agents Response Group ». Les groupes d’agents sont associés à des workflows, puis à des tâches. Par exemple, le personnel du support technique peut être regroupé dans le groupe d’agents « Support technique » tandis que les agents du service clientèle peuvent intervenir dans le cadre d’un groupe d’agents appelé « Service clientèle ».
Les nouveaux groupes d’agents sont créés à l’aide de la cmdlet New-CsRgsAgentGroup. Pour supprimer, si besoin est, un groupe d’agents, appelez la cmdlet Remove-CsRgsAgentGroup. Notez que cette cmdlet supprime l’ensemble du groupe et tous les agents qu’il contient. Si vous souhaitez supprimer un seul agent dans un groupe, utilisez la cmdlet Set-CsRgsAgentGroup.
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-CsRgsAgentGroup : 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-CsRgsAgentGroup"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Instance |
Obligatoire |
Objet AgentGroup |
Référence d’objet pointant sur le groupe d’agents à supprimer. Lorsque vous redirigez des objets de workflow vers la cmdlet Remove-CsRgsAgentGroup, vous pouvez ignorer le paramètre Instance. Pour utiliser le paramètre Instance, optez pour des commandes semblables à ce qui suit : $x = Get-CsRgsAgentGroup –Identity ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83 Remove-CsRgsAgentGroup –Instance $x Notez que seul un groupe d’agents à 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 groupe d’agents. |
Force |
Facultatif |
Paramètre de commutateur |
Force la suppression du groupe d’agents. Si vous définissez ce paramètre, le groupe d’agents est supprimé sans avertissement, même si un workflow actif l’utilise. Si vous ne le définissez pas, un message vous demandera de confirmer la suppression de tous les groupes d’agents utilisé par un 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.AgentGroup. Remove-CsRgsAgentGroup accepte également les instances redirigées de l’objet groupe d’agents Response Group.
Types de retours
Remove-CsRgsAgentGroup supprime les instances existantes de l’objet Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup.
Exemple
-------------------------- Exemple 1 ------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Remove-CsRgsAgentGroup
La commande ci-dessus supprime tous les groupes d’agents Response Group configurés dans le service ApplicationServer:atl-cs-001.litwareinc.com. Pour ce faire, la commande utilise d’abord la cmdlet Get-CsRgsAgentGroup pour retourner tous les groupes d’agents du service ApplicationServer:atl-cs-001.litwareinc.com. Ces groupes sont ensuite redirigés vers la cmdlet Remove-CsRgsAgentGroup qui les supprime.
-------------------------- Exemple 2 ------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" | Remove-CsRgsAgentGroup
Dans l’exemple 2, un seul groupe d’agents Response Group est supprimé : le groupe Help Desk. Pour exécuter cette tâche, la cmdlet Get-CsRgsAgentGroup est utilisée en premier pour retourner le groupe d’agents Help Desk (-Name "Help Desk") du service ApplicationServer:atl-cs-001.litwareinc.com. Ce groupe est ensuite redirigé vers la cmdlet Remove-CsRgsAgentGroup qui supprime le groupe du service.
-------------------------- Exemple 3 ------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.RoutingMethod -ne "RoundRobin"} | Remove-CsRgsAgentGroup
L’exemple 3 supprime tous les groupes d’agents Response Group du service ApplicationServer:atl-cs-001.litwareinc.com qui n’utilisent pas la méthode de routage circulaire. Pour ce faire, la cmdlet Get-CsRgsAgentGroup est d’abord appelée pour retourner une collection de tous les groupes d’agents situés dans le service ApplicationServer:atl-cs-001.litwareinc.com. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les groupes dont la valeur de la propriété RoutingMethod n’est pas égale à (-ne) RoundRobin. La collection filtrée est ensuite redirigée vers la cmdlet Remove-CsRgsAgentGroup qui supprime chaque élément de la collection.