Set-CsRgsQueue
Dernière rubrique modifiée : 2012-03-23
Modifie 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
Set-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 X d’appels conservés simultanément dans la file d’attente, ou à des appelants qui ont été mis en attente pendant un nombre X de secondes.
La cmdlet Set-CsRgsQueue permet de modifier une file d’attente Response Group existante. Set-CsRgsQueue ne vous permet pas de modifier directement la file d’attente. Par exemple, la cmdlet ne contient pas de paramètres permettant de modifier le seuil de saturation ou l’action à exécuter en cas de saturation. Pour modifier, si besoin est, une file d’attente, vous devez au préalable créer une référence d’objet à cette file d’attente, et faire appel dans ce cas à la cmdlet Get-CsRgsQueue pour extraire la file d’attente concernée et la stocker dans une variable. Des modifications sont ensuite apportées en mémoire à la file d’attente en affectant de nouvelles valeurs aux propriétés de cette dernière. Une fois toutes les modifications terminées, vous pouvez appeler la cmdlet Set-CsRgsQueue pour écrire les modifications dans la file d’attente Response Group elle-même. Si vous n’appelez pas la cmdlet Set-CsRgsQueue, vos 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-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 "Set-CsRgsQueue"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Instance |
Obligatoire |
Objet Queue |
Référence d’objet à la file d’attente Response Group à modifier. Une référence d’objet est généralement extraite en utilisant la cmdlet Get-CsRgsQueue et en affectant la valeur retournée à une variable. Par exemple, cette commande retourne une référence d’objet à la file d’attente Help Desk et la stocke dans une variable $x : $x = Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" |
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.Queue. Set-CsRgsQueue accepte également les instances redirigées de l’objet file d’attente Response Group.
Types de retours
Set-CsRgsQueue ne retourne aucun objet, ni aucune valeur. À la place, la cmdlet modifie des instances existantes de l’objet Microsoft.Rtc.Rgs.Management.WritableSettings.Queue.
Exemple
-------------------------- Exemple 1 ------------------------
$x = Get-CsRgsQueue -Identity Service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$x.OverflowCandidate = "NewestCall"
Set-CsRgsQueue -Instance $x
Dans l’exemple 1, la propriété OverflowCandidate est modifiée pour la file d’attente Response Group « Help Desk » du service ApplicationServer:atl-cs-001.litwareinc.com. Pour ce faire, la première commande de l’exemple utilise Get-CsRgsQueue pour extraire la file d’attente spécifiée (-Name "Help Desk") du service ApplicationServer:atl-cs-001.litwareinc.com. Les données extraites sont ensuite stockées dans une variable $x.
Une fois la file d’attente extraite, la deuxième commande de l’exemple affecte la valeur NewestCall à la propriété OverflowCandidate de cette file d’attente virtuelle. Une fois la commande exécutée, la dernière commande de l’exemple utilise la cmdlet Set-CsRgsQueue pour écrire les modifications dans la file d’attente Help Desk même. Notez que, à ce stade, les modifications ont eu lieu uniquement en mémoire. Tant que vous n’appelez pas Set-CsRgsQueue, la file d’attente Response Group même n’est pas modifiée dans le service ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Exemple 2 ------------------------
$x = Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Overflow Queue"
$w = New-CsRgsPrompt -TextToSpeechPrompt "Please hold while we transfer your call."
$y = New-CsRgsCallAction -Prompt $w -Action TransferToQueue -QueueID $x.Identity
$z = Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$z.OverflowAction = $y
Set-CsRgsQueue -Instance $z
Les commandes présentées dans l’exemple 2 montrent comment créer une nouvelle action d’appel Response Group et affecter cette action à une file d’attente Response Group existante. Pour exécuter cette tâche, vous devez en premier lieu utiliser la cmdlet Get-CsRgsQueue pour extraire la file d’attente « Help Desk Overflow Queue » du service ApplicationServer:atl-cs-001.litwareinc.com. Les informations sur cette file d’attente sont ensuite stockées dans une variable $x.
Une fois la file d’attente extraite, la cmdlet New-CsRgsPrompt est utilisée pour créer un nouveau message vocal qui est stocké dans une variable appelée $w. Puis, la cmdlet New-CsRgsCallAction est à son tour utilisée pour créer une nouvelle action d’appel. Cette action d’appel est affectée de trois paramètres : Prompt (le message utilisé par l’action d’appel), Action (indique l’action exécutée si la nouvelle action d’appel est déclenchée ; la valeur du paramètre TransferToQueue indique que l’appel est transféré vers une file d’attente Response Group différente) et QueueID qui définit la file d’attente secondaire vers laquelle l’appel est transféré ($x.Identity qui représente l’identité de la file d’attente Help Desk Overflow Queue). Cette nouvelle action d’appel est créée en mémoire, puis stockée dans la variable $y.
La commande suivante extrait la file d’attente à modifier. Dans cet exemple, il s’agit de la file d’attente Help Desk du service ApplicationServer:atl-cs-001.litwareinc.com. Lorsque Get-CsRgsQueue extrait cette file d’attente, l’objet file d’attente est stocké dans la variable $x.
Ceci terminé, vous pouvez affecter la nouvelle action d’appel à la file d’attente Help Desk. Pour ce faire, définissez la valeur de la propriété OverflowAction sur $y, à savoir la variable qui contient la nouvelle action d’appel.
Une fois l’action d’appel définie, la dernière commande de l’exemple appelle la cmdlet Set-CsRgsQueue pour écrire les modifications dans l’instance de la file d’attente Help Desk dans le service ApplicationServer:atl-cs-001.litwareinc.com.