Get-CsRgsQueue
Dernière rubrique modifiée : 2012-03-23
Extrait des informations sur les files d’attente Response Group utilisées dans votre organisation. Avec l’application Response Group, les appels sont placés dans une file d’attente et les appels sont mis en attente jusqu’à ce qu’un agent Response Group puisse répondre.
Syntaxe
Get-CsRgsQueue [-Identity <RgsIdentity>] [-Name <String>]
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.
La cmdlet Get-CsRgsQueue permet de retourner des informations sur les files d’attente Response Groupe configurées pour être utilisées dans l’organisation.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Get-CsRgsQueue : RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. 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 "Get-CsRgsQueue"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
RgsIdentity |
Correspond à l’identité du service où se trouve la file d’attente Response Group ou l’identité complète de la file d’attente. Si vous précisez l’identité du service (par exemple, service:ApplicationServer:atl-cs-001.litwareinc.com), toutes les files d’attente Response Group hébergées sur ce service sont retournées. Si vous précisez l’identité de la file d’attente, seule la file d’attente Response Group définie est retournée. Notez que l’identité d’une file d’attente est constituée de l’identité du service suivie d’un identificateur global unique (GUID). Par exemple : service:ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83. Vous pouvez également retourner une file d’attente Response Group unique en spécifiant l’identité du service et en incluant le paramètre Name suivi du nom de la file d’attente. Ainsi, vous pouvez extraire une file d’attente Response Group sans connaître l’identificateur global unique qui lui a été affecté. Si vous appelez Get-CsRgsQueue sans aucun paramètre, toutes les files d’attente configurées en vue d’une utilisation au sein de votre organisation sont retournées. |
Name |
Facultatif |
Chaîne |
Nom unique affecté à la file d’attente Response Group lors de sa création. |
Types d’entrées
Chaîne. Get-CsRgsQueue accepte une valeur de chaîne qui représente l’identité de la file d’attente Response Group.
Types de retours
Get-CsRgsQueue retourne des instances de l’objet Microsoft.Rtc.Rgs.Management.WritableSettings.Queue.
Exemple
-------------------------- Exemple 1 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com
La commande ci-dessus retourne des informations sur toutes les files d’attente configurées et utilisées dans l’organisation. Cette opération est effectuée en appelant la cmdlet Get-CsRgsQueue sans aucun paramètre.
-------------------------- Exemple 2 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com
La commande de l’exemple 2 retourne des informations sur toutes les files d’attente Response Group du service ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Exemple 3 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
Dans l’exemple 3, des informations sont retournées pour une seule file d’attente Response Group : la file d’attente « Help Desk » stockée dans le service ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Exemple 4 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Select-Object -ExpandProperty TimeoutAction
La commande de l’exemple 4 affiche des informations détaillées sur la propriété TimeoutAction de chaque file d’attente Response Group dans le service ApplicationServer:atl-cs-001.litwareinc.com. Pour exécuter cette tâche, la cmdlet Get-CsRgsQueue est d’abord utilisée pour retourner des informations sur toutes les files d’attente détectées dans le service ApplicationServer:atl-cs-001.litwareinc.com. Ces informations sont ensuite transmises à la cmdlet Select-Object qui développe la valeur stockée dans la propriété TimeoutAction. Lorsque vous développez la propriété TimeoutAction, les propriétés individuelles de l’objet incorporé qui composent la valeur de propriété apparaissent : Prompt, TargetQuestion, Target, TargetQueueID et TargetUri.
-------------------------- Exemple 5 ------------------------
Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.OverflowCandidate -eq "NewestCall"}
Les commandes ci-dessus retournent des informations sur les files d’attente Response Group du service ApplicationServer:atl-cs-001.litwareinc.com dont la valeur de la propriété OverflowCandidate est NewestCall. Pour accomplir cette tâche, la commande utilise d’abord Get-CsRgsQueue pour retourner une collection de toutes les files d’attente Response Group détectées dans le service spécifié. 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 ».