Get-CsRgsWorkflow
Dernière rubrique modifiée : 2012-03-23
Retourne des informations sur les workflows Response Group. Les workflows déterminent les actions exécutées lorsque l’application Response Group reçoit un appel téléphonique.
Syntaxe
Get-CsRgsWorkflow [-Identity <RgsIdentity>] [-Name <String>]
Description détaillée
Les workflows constituent peut-être l’élément clé de l’application Response Group. Chaque workflow est associé de manière unique à un numéro de téléphone ; lorsqu’une personne appelle ce numéro, le workflow détermine la manière de traiter l’appel. L’appel, par exemple, peut être transféré vers une série de questions du système de réponse vocale interactive qui demande à l’appelant d’entrer des informations supplémentaires (« Appuyez sur 1 pour accéder au support matériel. Appuyez sur 2 pour accéder au support logiciel. »). L’appel peut être également placé dans une file d’attente et l’appelant peut être mis en attente jusqu’à ce qu’un agent puisse répondre à l’appel. La disponibilité des agents pour répondre aux appels dépend également du workflow : les workflows permettent de définir les heures ouvrées (jours de la semaine et heures pendant lesquels les agents sont disponibles pour répondre aux appels) et les congés (jours pendant lesquels aucun agent n’est disponible pour répondre aux appels).
La cmdlet Get-CsRgsWorkflow permet de retourner des informations sur les workflows configurés en vue d’une utilisation au sein de votre organisation.
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-CsRgsWorkflow : 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 "Get-CsRgsWorkflow"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
RgsIdentity |
Correspond à l’identité du service où se trouve le workflow Response Group ou l’identité complète du workflow. Si vous spécifiez l’identité du service (par exemple, service:ApplicationServer:atl-cs-001.litwareinc.com), tous les workflows Response Group du service sont retournés. Si vous définissez l’identité du workflow, seul le workflow Response Group est retourné. Notez que l’identité d’un workflow 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 workflow Response Group unique en spécifiant l’identité du service et en incluant le paramètre Name suivi du nom du workflow. Ainsi, vous pouvez extraire un workflow sans connaître l’identificateur global unique qui lui a été affecté. Si vous appelez Get-CsRgsWorkflow sans aucun paramètre, vous obtenez une collection de tous les workflows configurés dans votre organisation. |
Name |
Facultatif |
Chaîne |
Nom unique affecté au workflow Response Group lors de sa création. |
Types d’entrées
Aucun. Get-CsRgsWorkflow n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Get-CsRgsWorkflow retourne des instances de l’objet Microsoft.Rtc.Rgs.Management.WritableSettings.Workflow.
Exemple
-------------------------- Exemple 1 ------------------------
Get-CsRgsWorkflow
L’exemple ci-dessus renvoie des informations sur tous les workflows configurés en vue d’une utilisation au sein de votre organisation. Cette opération est effectuée en appelant la cmdlet Get-CsRgsWorkflow sans aucun paramètre.
-------------------------- Exemple 2 ------------------------
Get-CsRgsWorkflow -Identity service:ApplicationServer:atl-cs-001.litwareinc.com
L’exemple 2 retourne des informations sur tous les workflows de l’application Response Group qui se trouvent dans le service ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Exemple 3 ------------------------
Get-CsRgsWorkflow -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Select-Object -ExpandProperty DefaultAction
La commande de l’exemple 3 affiche des informations détaillées sur la propriété DefaultAction de chaque workflow Response Group détecté sur le service ApplicationServer:atl-cs-001.litwareinc.com. Pour exécuter cette tâche, la cmdlet Get-CsRgsWorkflow est d’abord utilisée pour retourner des informations sur tous les workflows détectés sur ApplicationServer:atl-cs-001.litwareinc.com. Ces informations sont ensuite redirigées vers la cmdlet Select-Object qui développe la valeur stockée dans la propriété DefaultAction. Lorsque vous développez la valeur de DefaultAction, vous affichez les propriétés individuelles de l’objet incorporé stocké dans la propriété DefaultAction.
-------------------------- Exemple 4 ------------------------
Get-CsRgsWorkflow -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "European Sales Support"
L’exemple 4 retourne des informations sur un seul workflow Response Group : le workflow European Sales Supports qui se trouve sur le service ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Exemple 5 ------------------------
Get-CsRgsWorkflow -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.Language -eq "en-Us"}
La commande présentée dans l’exemple 5 retourne des informations sur tous les workflows Response Group dont la langue principale est l’anglais américain. Pour ce faire, la commande appelle Get-CsRgsWorkflow pour retourner une collection de tous les workflows détectés sur le service ApplicationServer:atl-cs-001.litwareinc.com. La collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les workflows dont la propriété Language affiche la valeur en-US (anglais américain).
-------------------------- Exemple 6 ------------------------
Get-CsRgsWorkflow service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.CustomMusicOnHold -eq $Null}
La commande ci-dessus retourne tous les workflows disponibles sur ApplicationServer:atl-cs-001.litwareinc.com, où la propriété CustomMusicOnHold a une valeur Null. (En d’autres termes, la commande retourne des informations sur les workflows auxquels aucune musique personnalisée n’est affectée.) Pour exécuter cette tâche, la commande utilise d’abord Get-CsRgsWorkflow pour retourner une collection de tous les workflows sur le service ApplicationServer:atl-cs-001.litwareinc.com. Les données retournées sont ensuite redirigées vers Where-Object qui sélectionne uniquement les éléments dont la valeur de la propriété CustomMusicOnHold est Null.