.png)
Get-CsRgsAgentGroup
Dernière rubrique modifiée : 2012-08-11
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. Cette applet de commande est une nouveauté de Lync Server 2010.
Get-CsRgsAgentGroup [-Identity <RgsIdentity>] [-Name <String>] [-Owner <RgsIdentity>] [-ShowAll <SwitchParameter>]
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 l’applet de commande Get-CsRgsAgentGroup sans aucun paramètre.
Get-CsRgsAgentGroup
La commande indiquée dans l’exemple 2 retourne tous les groupes d’agents Response Group configurés dans le service ApplicationServer:atl-cs-001.litwareinc.com.
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com
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.
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
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 l’applet de commande Where-Object qui sélectionne uniquement les groupes dont la valeur de la propriété RoutingMethod est « RoundRobin ».
Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.RoutingMethod -eq "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 l’applet de commande Where-Object qui sélectionne uniquement les groupes dont la valeur de la propriété RoutingMethod est différente de « RoundRobin ».
Get-CsRgsAgentGroup -Identity Service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.RoutingMethod -ne "RoundRobin"}
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 ».
L’applet de commande 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 applet de commande : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement l’applet de commande 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 applet de commande 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ètre | Obligatoire | Type | Description |
|---|---|---|---|
| Identity | Facultatif | Microsoft.Rtc.Rgs.Management.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 l’applet de commande 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 | System.String | Nom unique affecté au groupe d’agents lors de sa création. |
| Owner | Facultatif | Microsoft.Rtc.Rgs.Management.RgsIdentity | Nom de domaine complet du pool qui « détient » le groupe d’agents. L’ID du pool propriétaire et l’ID du pool d’un groupe d’agents sont généralement les mêmes. Toutefois, si un groupe doit être temporairement déplacé (par exemple dans le cadre d’une procédure de récupération d’urgence), l’ID du pool change, mais l’ID du propriétaire continue à pointer vers le pool d’origine. |
| ShowAll | Facultatif | System.Management.Automation.SwitchParameter | S’il est présent, affiche tous les groupes d’agents Response Group, y compris les groupes pour lesquels l’ID du pool propriétaire et l’ID du pool sont différents. Par défaut, Get-CsRgsAgentGroup ne retourne que les informations concernant les groupes d’agents pour lesquels l’ID du pool propriétaire et l’ID du pool sont identiques. |
Chaîne. Get-CsRgsAgentGroup accepte une valeur de chaîne qui représente l’identité du groupe d’agents Response Group.
Get-CsRgsAgentGroup retourne des instances de l’objet Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup.
