Set-CsRgsAgentGroup
Dernière rubrique modifiée : 2012-03-23
Modifie un groupe d’agents Response Group existant. 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
Set-CsRgsAgentGroup -Instance <AgentGroup> [-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, le service 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 ensuite à des tâches : 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).
Les nouveaux groupes d’agents sont créés à l’aide de la cmdlet New-CsRgsAgentGroup. Si vous devez modifier un groupe d’agents après l’avoir créé, utilisez la cmdlet Set-RgsAgentGroup. Vous pouvez utiliser cette cmdlet, entre autres, pour ajouter et supprimer individuellement les agents d’un groupe. Notez que Set-CsRgsAgentGroup ne modifie pas directement les propriétés d’un groupe d’agents. Si vous devez modifier un groupe, vous devez d’abord créer une référence d’objet à ce groupe. Pour ce faire, appelez Get-CsRgsAgentGroup pour extraire le groupe, puis stockez l’objet retourné dans une variable. Une fois la référence d’objet créée, vous pouvez modifier les propriétés du groupe en mémoire. Une fois les modifications effectuées, vous devez appeler Set-CsRgsAgentGroup pour écrire les modifications dans le groupe d’agents Response Group lui-même. Si vous n’appelez pas la cmdlet Set-CsRgsAgentGroup, 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-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 "Set-CsRgsAgentGroup"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Instance |
Obligatoire |
Objet AgentGroup |
Référence d’objet au groupe d’agents Response Group à modifier. Une référence d’objet est généralement extraite en utilisant la cmdlet Get-CsRgsAgentGroup et en affectant la valeur retournée à une variable. Par exemple, cette commande retourne une référence d’objet au groupe d’agents Help Desk et la stocke dans une variable $x : $x = Get-CsRgsAgentGroup -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.AgentGroup. Set-CsRgsAgentGroup accepte également les instances redirigées de l’objet groupe d’agents Response Group.
Types de retours
Set-CsRgsAgentGroup ne retourne aucun objet, ni aucune valeur. En fait, cette cmdlet modifie les instances existantes de l’objet Microsoft.Rtc.Rgs.Management.WritableSettings.AgentGroup.
Exemple
-------------------------- Exemple 1 ------------------------
$x = Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$x.RoutingMethod = "RoundRobin"
Set-CsRgsAgentGroup -Instance $x
Les commandes présentées dans l’exemple 1 modifient la propriété RoutingMethod du groupe d’agents Response Group « Help Desk » (stockée dans le service ApplicationServer:atl-cs-001.litwareinc.com). Pour exécuter cette tâche, la commande utilise d’abord la cmdletGet-CsRgsAgentGroup pour extraire le groupe d’agents Help Desk (-Name "Help Desk") du service ApplicationServer:atl-cs-001.litwareinc.com. Après l’extraction, l’objet groupe d’agents est stocké dans une variable $x.
La commande 2 de l’exemple modifie la valeur de la propriété RoutingMethod. Dans la dernière commande de l’exemple, la cmdlet Set-CsRgsAgentGroup permet d’écrire ces modifications dans le groupe d’agents Help Desk même.
-------------------------- Exemple 2 ------------------------
$x = Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$x.DistributionGroupAddress = "helpdesk@litwareinc.com"
Set-CsRgsAgentGroup -Instance $x
L’exemple 2 montre comment modifier le groupe de distribution affecté à un groupe d’agents Response Group. Cette opération est exécutée en utilisant d’abord Get-CsRgsAgentGroup pour retourner le groupe d’agents à modifier. Dans cet exemple, il s’agit du groupe Help Desk (-Name "Help Desk ") stocké dans le service ApplicationServer:atl-cs-001.litwareinc.com. Lorsque Get-CsRgsAgentGroup retourne ce groupe, l’objet qui en résulte est stocké dans une variable $x.
La deuxième commande de l’exemple affecte une nouvelle valeur (helpdesk@litwareinc.com) à la propriété DistributionGroupAddress. Une fois la nouvelle valeur affectée, la cmdlet Set-CsRgsAgentGroup est utilisée pour écrire les modifications apportées au groupe d’agents Help Desk dans le service ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Exemple 3 ------------------------
$x = Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$x.AgentsByUri.Add("sip:kenmyer@litwareinc.com")
Set-CsRgsAgentGroup -Instance $x
Les commandes de l’exemple 3 ajoutent un nouvel agent au groupe d’agents Response Group « Help Desk ». Pour ce faire, la cmdlet Get-CsRgsAgentGroup est d’abord utilisée pour retourner le groupe d’agents Help Desk (-Name "Help Desk") à partir du service ApplicationServer:atl-cs-001.litwareinc.com. L’objet extrait est stocké dans une variable $x.
Dans la deuxième commande, la méthode Add permet d’ajouter un nouvel agent à la propriété AgentsByUri en définissant l’adresse SIP du nouvel agent ("sip:kenmyer@litwareinc.com"). Dans la commande 3, Set-CsRgsAgentGroup permet d’écrire les modifications (à savoir l’ajout du nouvel agent) dans le groupe Help Desk. Notez que si vous n’appelez pas Set-CsRgsAgentGroup, les modifications ont lieu uniquement en mémoire et ne sont pas appliquées au groupe d’agents lui-même.
-------------------------- Exemple 4 ------------------------
$x = Get-CsRgsAgentGroup -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"
$x.AgentsByUri.Remove("sip:kenmyer@litwareinc.com")
Set-CsRgsAgentGroup -Instance $x
Dans l’exemple 4, un agent est supprimé du groupe d’agents Response Group (Help Desk) dans le service ApplicationServer:atl-cs-001.litwareinc.com. Pour ce faire, la cmdlet Get-CsRgsAgentGroup est d’abord utilisée pour retourner le groupe d’agents Help Desk (-Name "Help Desk") à partir du service ApplicationServer:atl-cs-001.litwareinc.com. L’objet groupe d’agents extrait est stocké dans une variable $x.
Une fois le groupe d’agents extrait, la méthode Remove supprime un agent (l’agent avec l’adresse SIP "sip:kenmyer@litwareinc.com") du groupe. Dans la commande 3, la cmdlet Set-CsRgsAgentGroup est appelée pour écrire les modifications (c’est-à-dire supprimer l’agent) du groupe. Si vous n’appelez pas Set-CsRgsAgentGroup, les modifications seront effectuées en mémoire uniquement et ne seront pas appliquées au groupe d’agents lui-même ; l’agent sera supprimé uniquement si vous appelez Set-CsRgsAgentGroup.