Remove-CsRgsQueue
Dernière rubrique modifiée : 2012-03-23
Supprime une file d’attente Response Group existante. Avec l’application Response Group, les appels sont placés dans une file d’attente et les appelants sont mis en attente jusqu’à ce qu’un agent Response Group puisse répondre.
Syntaxe
Remove-CsRgsQueue -Instance <Queue> [-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, l’une des deux actions suivantes est généralement exécutée : l’appel est transféré vers une question à laquelle l’appelant doit répondre pour pouvoir continuer (par exemple « Appuyez sur 1 pour accéder au support matériel ou sur 2 pour accéder au support logiciel ») ou il est placé dans une file d’attente jusqu’à ce qu’un agent puisse y répondre.
Au lieu de disposer d’une seule file d’attente pour tous les appels, l’application Response Group permet de créer plusieurs files d’attente qui peuvent être associées à des workflows et des groupes d’agents Response Group différents. Cela signifie aussi que les files d’attente peuvent répondre différemment à des évènements, par exemple dans le cadre d’un nombre défini d’appels conservés simultanément dans la file d’attente, ou à des appelants qui ont été mis en attente pendant un certain laps de temps.
En plus de créer des files d’attente, vous pouvez supprimer des files d’attente existantes au moyen de la cmdlet Remove-CsRgsQueue conçue dans cet objectif. Notez que, par défaut, un message d’invite apparaît lorsque vous tentez de supprimer une file d’attente affectée à un workflow actif. Le message en question vous demandera de confirmer votre intention de supprimer la file d’attente et Windows PowerShell s’arrêtera provisoirement (la file d’attente ne sera pas supprimée) jusqu’à ce que vous répondiez à l’invite. Pour ignorer l’invite et supprimer les files d’attente utilisées par un workflow actif, ajoutez le paramètre Force. Par exemple :
Get-CsRgsQueue –Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Remove-CsRgsQueue –Force
Remove-CsRgsQueue vérifie toujours si une file d’attente est utilisée par un workflow actif avant de supprimer cette même file. En revanche, la cmdlet ne vérifie pas si la file d’attente est utilisée par une autre file d’attente employée en cas de problèmes de délai d’expiration ou de dépassement de capacité. Il est donc possible de supprimer une file d’attente nécessaire à une autre file d’attente. De ce fait, vous pouvez utiliser la cmdlet Get-CsRgsQueue afin de vérifier les propriétés OverflowAction et TimeoutAction de vos autres files d’attente Response Group avant d’exécuter Remove-CsRgsQueue pour supprimer une file d’attente.
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-CsRgsQueue : 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-CsRgsQueue"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Instance |
Obligatoire |
Objet Queue |
Référence d’objet pointant sur la file d’attente à supprimer. Lorsque vous redirigez des objets de workflow vers la cmdlet Remove-CsRgsQueue, vous pouvez ignorer le paramètre Instance. Pour utiliser le paramètre Instance, optez pour des commandes semblables à ce qui suit : $x = Get-CsRgsQueue –Identity ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83 Remove-CsRgsQueue –Instance $x Notez que seule une file d’attente à la fois peut être supprimée 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 file d’attente. |
Force |
Facultatif |
Paramètre de commutateur |
Force la suppression d’une file d’attente Response Group. Si vous définissez ce paramètre, la file d’attente est supprimée 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 toutes les files d’attente affectées à 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.Queue. Remove-CsRgsQueue accepte également les instances redirigées de l’objet file d’attente Response Group.
Types de retours
Remove-CsRgsQueue supprime les instances existantes de l’objet Microsoft.Rtc.Rgs.Management.WritableSettings.Queue.
Exemple
-------------------------- Exemple 1 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Remove-CsRgsQueue
La commande présentée dans l’exemple 1 supprime toutes les files d’attente Response Group du service ApplicationServer:atl-cs-001.litwareinc.com. Pour exécuter cette tâche, la commande utilise d’abord Get-CsRgsQueue pour retourner une collection de toutes les files d’attente situées dans le service ApplicationServer:atl-cs-001.litwareinc.com. La collection est ensuite redirigée vers Remove-CsRgsQueue qui supprime chaque file d’attente de la collection.
-------------------------- Exemple 2 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Queue" | Remove-CsRgsQueue
Dans l’exemple 2, une seule file d’attente du service Response Group est supprimée : la file d’attente « Help Desk Queue » du service ApplicationServer:atl-cs-001.litwareinc.com. Pour supprimer cette file d’attente, la cmdlet Get-CsRgsQueue est appelée avec les paramètres Identity et Name ; l’unique file d’attente provenant de cet appel est ensuite redirigée vers Remove-CsRgsQueue qui la supprime.
-------------------------- Exemple 3 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.OverflowCandidate -eq "NewestCall"} | Remove-CsRgsQueue
La commande ci-dessus supprime toutes les files d’attente Response Group du service ApplicationServer:atl-cs-001.litwareinc.com si leur propriété OverflowCandidate à la valeur NewestCall. Pour exécuter cette tâche, la cmdlet Get-CsRgsQueue est appelée en premier lieu afin de retourner une collection de toutes les files d’attente Response Group situées 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 files d’attente dont la valeur de la propriété OverflowCandidate est « NewestCall ». La collection filtrée est ensuite redirigée vers Remove-CsRgsQueue qui supprime chaque file d’attente de la collection.