New-CsRgsAgentGroup
Dernière rubrique modifiée : 2012-03-23
Crée un nouveau groupe d’agents Response Group. 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 en particulier.
Syntaxe
New-CsRgsAgentGroup -Parent <RgsIdentity> -Name <String> [-AgentAlertTime <Int16>] [-AgentsByUri <Collection>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-DistributionGroupAddress <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-ParticipationPolicy <Informal | Formal>] [-RoutingMethod <LongestIdle | Serial | Parallel | RoundRobin | Attendant>] [-WhatIf [<SwitchParameter>]]
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 files d’attente et à des tâches similaires : le personnel du support technique peut être regroupé dans le groupe d’agents Help Desk (support technique) tandis que les agents du service clientèle peuvent intervenir dans le cadre d’un groupe d’agents appelé Customer Support (service clientèle).
Si plusieurs groupes sont affectés à une file d’attente, l’application Response Group appellent d’abord tous les agents disponibles du premier groupe affecté à la file en question. Si aucun de ces agents ne répond, l’application appelle en premier tous les agents disponibles du groupe suivant affecté à la file d’attente.
Les nouveaux groupes d’agents sont créés à l’aide de la cmdlet New-CsRgsAgentGroup.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet New-CsRgsAgentGroup : 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 "New-CsRgsAgentGroup"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Name |
Obligatoire |
Chaîne |
Nom unique à attribuer au groupe d’agents. La combinaison de la propriété Parent avec la propriété Name vous permet d’identifier de manière unique les groupes d’agents sans que vous ayez à vous référer à l’identificateur global unique (GUID) du groupe. |
Parent |
Obligatoire |
RgsIdentity |
Service qui doit héberger le nouveau groupe d’agents. Par exemple : -Parent "service:ApplicationServer:atl-cs-001.litwareinc.com". |
AgentAlertTime |
Facultatif |
Entier |
Représente le temps (en secondes) pendant lequel un appel peut rester sans réponse avant d’être automatiquement routé vers l’agent suivant. Le paramètre AgentAlertTime peut avoir comme valeur un entier quelconque compris entre 10 et 600 secondes (10 minutes). La valeur par défaut est de 20 secondes. Remarque : le paramètre AgentAlertTime ne doit pas dépasser 180 secondes, sinon l’application cliente refuse l’appel en raison du dépassement du délai d’attente maximal du temporisateur de transactions SIP. Pour éviter cet incident, réglez la valeur Temps d’alerte à moins de 180 secondes. |
AgentsByUri |
Facultatif |
Collecte des agents |
Permet d’ajouter individuellement des agents à un groupe d’agents. Les nouveaux agents sont identifiés au moyen de leurs adresses SIP. |
Description |
Facultatif |
Chaîne |
Permet aux administrateurs de fournir des informations supplémentaires d’explication sur le groupe d’agents. Par exemple, le champ Description peut renfermer des données sur la personne à contacter au cas où le groupe ne reçoit pas les appels téléphoniques attendus. |
DistributionGroupAddress |
Facultatif |
Chaîne |
Permet d’ajouter tous les membres d’un groupe de distribution à un groupe d’agents. |
ParticipationPolicy |
Facultatif |
Modificateur de liste PS |
Indique ou non si des agents doivent officiellement se connecter au système pour recevoir des appels téléphoniques destiné à leur groupe. Si le paramètre ParticipationPolicy est défini sur Informel (valeur par défaut), aucune connexion n’est requise. Elle est requise si ParticipationPolicy affiche la valeur Formel. |
RoutingMethod |
Facultatif |
Modificateur de liste PS |
Spécifie la méthode adoptée pour le routage des nouveaux appels vers les agents. Le paramètre RoutingMethod doit afficher l’une des valeurs suivantes : LongestIdle : les appels sont routés vers l’agent qui a été inactif (à savoir impliqué dans aucune activité de Microsoft Lync 2010) le plus longtemps. RoundRobin : les appels sont routés vers le prochain agent figurant dans la liste. Serial : les appels sont toujours routés vers le premier agent de la liste et uniquement vers d’autres agents si ce dernier n’est pas disponible ou ne répond pas dans le temps imparti. Parallel : les appels sont routés vers tous les agents en même temps, à l’exception de ceux dont le statut de présence indique qu’ils sont en cours d’appel ou indisponibles pour une autre raison. Attendant : les appels sont routés vers tous les agents en même temps, même si leur statut de présence indique qu’ils sont en cours d’appel ou indisponibles pour une autre raison. La seule exception est lorsqu’un agent a défini sa présence sur Ne pas déranger. La méthode de routage par défaut est la méthode parallèle (valeur Parallel). |
Force |
Facultatif |
GUID |
Supprime l’affichage de tous les messages d’erreur récupérable susceptibles d’apparaître lors de l’exécution de la commande. |
InMemory |
Facultatif |
Paramètre de commutateur |
Crée une référence d’objet sans valider l’objet comme une modification définitive. Si vous affectez à une variable la sortie de cette cmdlet appelée avec ce paramètre, vous pouvez apporter des modifications aux propriétés de la référence d’objet, puis les valider en appelant la cmdlet Set- correspondante. |
Types d’entrées
Aucun. New-CsRgsAgentGroup n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
New-CsRgsAgentGroup crée de nouvelles instances de l’objet Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup.
Exemple
-------------------------- Exemple 1 ------------------------
New-CsRgsAgentGroup -Parent service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Group"
La commande affichée dans l’exemple 1 crée un nouveau groupe d’agents Response Group appelé « Help Desk Group » ; ce nouveau groupe est situé dans le service ApplicationServer:atl-cs-001.litwareinc.com. Pour créer le groupe, la commande appelle la cmdlet New-CsRgsAgentGroup avec les paramètres Parent et Name. Dans cet exemple, aucun autre paramètre de groupe n’est spécifié, ce qui signifie que le groupe utilisera toutes les valeurs par défaut de la propriété. Du fait qu’aucun agent n’est affecté à ce groupe, tous les appels routés vers le nouveau groupe d’agents seront automatiquement déconnectés.
-------------------------- Exemple 2 ------------------------
New-CsRgsAgentGroup -Parent service: ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Group" -AgentsByUri "sip:kenmyer@litwareinc.com","sip:pilarackerman@litwareinc.com"
Dans l’exemple 2, un nouveau groupe d’agents Response Group est créé et deux agents sont simultanément affectés à ce groupe. Pour cela, la commande appelle la cmdlet New-CsRgsAgentGroup avec les paramètres Parent et Name. Cet exemple comprend également le paramètre AgentsByUri accompagné de la valeur "sip:kenmyer@litwareinc.com","sip:pilarackerman@litwareinc.com". Cette valeur est une liste séparée par des virgules des adresses SIP qui sont à ajouter au groupe d’agents.