Get-CsRgsAgentGroup
Dernière rubrique modifiée : 2012-03-23
Retourne des informations sur les groupes d’agents Response Group configurés dans votre organisation. 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.
Syntaxe
Get-CsRgsAgentGroup [-Identity <RgsIdentity>] [-Name <String>]
Description détaillée
Lorsqu’une personne appelle un numéro de téléphone associé à l’application Response Group, cette dernière 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 également être intégré dans une file d’attente Response Group où l’appelant est mis en attente jusqu’à ce qu’une personne désignée soit disponible pour répondre à l’appel. 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 et à des tâches similaires : 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 ».
La cmdlet Get-CsRgsAgentGroup permet de retourner des informations sur les groupes d’agents Response Group actuellement utilisés dans votre organisation (y compris des informations sur les utilisateurs affectés à chaque groupe d’agents).
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-CsRgsAgentGroup : 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-CsRgsAgentGroup"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
RgsIdentity |
Correspond soit à l’identité du service où est hébergé le groupe d’agents Response Group, soit à l’identité complète du groupe d’agents même. Si vous précisez l’identité du service (par exemple, service:ApplicationServer:atl-cs-001.litwareinc.com), tous les groupes d’agents hébergés dans le service sont retournés. Si vous spécifiez l’identité du groupe, seul le groupe d’agents défini est retourné. Notez que l’identité d’un groupe d’agents 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 un seul groupe en précisant l’identité du service et en incluant le paramètre Name suivi du nom du groupe d’agents. Ainsi, vous pouvez extraire un groupe d’agents sans connaître l’identificateur global unique qui lui a été affecté. Si vous appelez la cmdlet Get-CsRgsAgentGroup sans aucun paramètre, celle-ci retourne une collection de tous les groupes d’agents configurés en vue d’une utilisation au sein de votre organisation. |
Name |
Facultatif |
Chaîne |
Nom unique affecté au groupe d’agents lors de sa création. |
Types d’entrées
Chaîne. Get-CsRgsAgentGroup accepte une valeur de chaîne qui représente l’identité du groupe d’agents Response Group.
Types de retours
Get-CsRgsAgentGroup retourne des instances de l’objet Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup.
Exemple
-------------------------- Exemple 1 ------------------------
Get-CsRgsAgentGroup
L’exemple 1 retourne tous les groupes d’agents Response Group configurés pour être utilisés dans l’organisation. Cette opération est effectuée en appelant la cmdlet Get-CsRgsAgentGroup sans aucun paramètre.
-------------------------- Exemple 2 ------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com
La commande ci-dessus retourne tous les groupes d’agents Response Group configurés dans le service ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Exemple 3 ------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
La commande de l’exemple 3 retourne un seul groupe d’agents Response Group : le groupe Help Desk détecté dans le service ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Exemple 4 ------------------------
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.RoutingMethod -eq "RoundRobin"}
Dans l’exemple 4, les informations sont retournées pour tous les groupes d’agents Response Group du service ApplicationServer:atl-cs-001.litwareinc.com si ces groupes utilisent la méthode de routage circulaire. Pour exécuter cette tâche, la commande utilise d’abord Get-CsRgsAgentGroup pour retourner une collection de tous les groupes d’agents de ApplicationServer:atl-cs-001.litwareinc.com. La collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les groupes dont la valeur de la propriété RoutingMethod est « RoundRobin ».
-------------------------- Exemple 5 ------------------------
Get-CsRgsAgentGroup -Identity Service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.RoutingMethod -ne "RoundRobin"}
La commande de l’exemple 5 est une variante de celle utilisée dans l’exemple 4. Toutefois, dans ce cas, les informations sont retournées pour 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 exécuter cette tâche, la commande appelle Get-CsRgsAgentGroup pour retourner une collection de tous les groupes d’agents disponibles dans le service ApplicationServer:atl-cs-001.litwareinc.com. La collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les groupes dont la valeur de la propriété RoutingMethod est différente de « RoundRobin ».