New-CsRgsQueue
Dernière rubrique modifiée : 2012-03-23
Crée une file d’attente Response Group. Avec l’application Response Group, les appels sont placés dans une file d’attente et les appelants sont mis en attente jusqu’à ce qu’un agent Response Group puisse répondre.
Syntaxe
New-CsRgsQueue -Parent <RgsIdentity> -Name <String> [-AgentGroupIDList <Collection>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-OverflowAction <CallAction>] [-OverflowCandidate <NewestCall | OldestCall>] [-OverflowThreshold <Nullable>] [-TimeoutAction <CallAction>] [-TimeoutThreshold <Nullable>] [-WhatIf [<SwitchParameter>]]
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 New-CsRgsQueue permet aux administrateurs de créer aisément des files d’attente Response Group.
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-CsRgsQueue : 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-CsRgsQueue"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Parent |
Obligatoire |
RgsIdentity |
Service qui doit héberger la nouvelle file d’attente. Par exemple : -Parent "service:ApplicationServer:atl-cs-001.litwareinc.com". |
Name |
Obligatoire |
Chaîne |
Nom unique à affecter à la file d’attente. La combinaison de la propriété Parent et de la propriété Name permet d’identifier de manière unique les files d’attente Response Group sans que vous ayez à vous référer à leur identificateur global unique (GUID). |
AgentGroupIdList |
Facultatif |
Collection AgentGroup |
Identité des groupes d’agents Response Group à ajouter à la file d’attente. Les identités des groupes d’agents peuvent être extraites à l’aide de la cmdlet Get-CsRgsAgentGroup. Pour plus d’informations, consultez la section Exemples de cette rubrique. Si vous routez un appel vers une file d’attente à laquelle aucun groupe d’agents n’est affecté (ou à laquelle seuls des groupes d’agents dénués d’agents ont été affectés), l’appel en question sera automatiquement déconnecté. |
Description |
Facultatif |
Chaîne |
Permet aux administrateurs de fournir des informations supplémentaires sur la file d’attente Response Group. |
OverflowAction |
Facultatif |
Objet CallAction |
Action à entreprendre si le seuil de saturation est atteint. Vous devez créer le paramètre OverflowAction à l’aide de la cmdlet New-CsRgsCallAction. |
OverflowCandidate |
Facultatif |
Modificateur de liste PS |
Indique l’appel affecté lorsque le seuil de saturation est atteint. La propriété OverflowCandidate doit avoir l’une des deux valeurs suivantes : NewestCall OldestCall La valeur par défaut est NewestCall. |
OverflowThreshold |
Facultatif |
Entier |
Nombre d’appels simultanés pouvant se trouver dans la file d’attente avant le déclenchement de l’action à exécuter en cas de saturation. La valeur OverflowThreshold peut être un entier compris entre 0 et 1 000 inclus. La valeur par défaut est Null, ce qui signifie qu’un nombre illimité d’appels peut se trouver dans la file d’attente à tout moment. |
TimeoutAction |
Facultatif |
Objet CallAction |
Action à entreprendre si le seuil d’expiration est atteint. Vous devez créer le paramètre TimeoutAction à l’aide de la cmdlet New-CsRgsCallAction. |
TimeoutThreshold |
Facultatif |
Entier |
Délai (en secondes) de mise en file d’attente d’un appel avant son expiration. À ce stade, le système exécute l’action définie par le paramètre TimeoutAction. Le seuil d’expiration peut être un entier compris entre 10 et 65 535 secondes (environ 18 heures) inclus. La valeur par défaut est Null, ce qui implique que la file d’attente n’expire jamais. |
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. |
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-CsRgsQueue n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
New-CsRgsQueue crée des instances de l’objet Microsoft.Rtc.Rgs.Management.WritableSettings.Queue.
Exemple
-------------------------- Exemple 1 ------------------------
$x = New-CsRgsCallAction -Action TransferToVoicemailUri -Uri "sip:+14255551298@litwareinc.com"
New-CsRgsQueue -Parent service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" -OverflowCandidate "OldestCall" -OverflowAction $x -OverflowThreshold 25
L’exemple 1 crée une file d’attente Response Group pour le service ApplicationServer:atl-cs-001.litwareinc.com. La première commande de l’exemple utilise la cmdlet New-CsRgsCallAction pour créer une action d’appel pour la file d’attente ; dans cet exemple, à chaque fois que le seuil de saturation est atteint, les appels sont automatiquement transférés vers la messagerie vocale. Pour cette configuration, vous devez définir le paramètre Action sur TransferToVoicemailUri et la propriété URI sur l’URI SIP de messagerie vocale "sip:+14255551298@litwareinc.com".
Une fois l’action d’appel configurée (et stockée dans la variable $x), la cmdlet New-CsRgsQueue est ensuite utilisée pour créer une nouvelle file d’attente Help Desk. En plus de définir le paramètre OverflowAction, cette commande configure les valeurs des propriétés OverflowCandidate et OverflowThreshold.