Get-CsRgsConfiguration
Dernière rubrique modifiée : 2012-03-23
Retourne des informations sur les paramètres de configuration de l’application Response Group.
Syntaxe
Get-CsRgsConfiguration -Identity <RgsIdentity>
Description détaillée
L’application Response Group vous offre une méthode d’acheminement automatique des appels téléphoniques vers diverses entités, telles que le support technique ou le service clientèle. Lorsqu’une personne appelle un numéro de téléphone donné, l’appel peut être transféré directement vers le groupe d’agents Response Group approprié. Il peut également être routé en premier lieu vers une file d’attente du système de réponse vocale interactive. Dans cette file d’attente, l’appelant doit répondre à une série de questions (par exemple, « Appelez-vous au sujet d’une commande en cours ? »). En fonction des réponses qu’il donne, il peut alors être routé vers la file d’attente Response Group appropriée.
La cmdlet Get-CsRgsConfiguration vous permet de retourner des informations sur le mode de configuration de l’application Response Group. Notez que, par défaut, cette cmdlet retourne uniquement des informations d’une seule instance de l’application Response Group à la fois. Par exemple, si vous disposez de plusieurs installations distinctes de l’application Response Group (une sur le service ApplicationServer:atl-cs-001.litwareinc.com, une autre sur le serviceApplicationServer:dublin-cs-001.litwareinc.com), vous devrez effectuer des appels séparés de la cmdlet Get-CsRgsConfiguration pour retourner des informations sur chacune de ces instances Response Group. Cependant, la section Exemples de cette rubrique décrit un moyen de contourner ce problème.
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-CsRgsConfiguration : RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. 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-CsRgsConfiguration"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
RgsIdentity |
Nom du service sur lequel sont hébergés les paramètres de configuration Response Group (par exemple : -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com"). Si vous n’incluez pas ce paramètre, la cmdlet Get-CsRgsConfiguration vous demandera de fournir une valeur Identity. |
Types d’entrées
Chaîne. Get-CsRgsConfiguration accepte une valeur de chaîne qui représente l’identité des paramètres de configuration Response Group.
Types de retours
Get-CsRgsConfiguration retourne des instances de l’objet Microsoft.Rtc.Rgs.Management.WritableSettings.ServiceSettings.
Exemple
-------------------------- Exemple 1 ------------------------
Get-CsRgsConfiguration -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com"
L’exemple 1 retourne les paramètres de configuration Response Group du service ApplicationServer:atl-cs-001.litwareinc.com. Parce qu’il ne peut y avoir qu’une seule collection de paramètres par service, cette commande retournera toujours un seul élément.
-------------------------- Exemple 2 ------------------------
(Get-CsRgsConfiguration -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com").DisableCallContext
La commande ci-dessus retourne la valeur d’une seule et unique propriété (DisableCallContext) pour les paramètres de configuration Response Group détectés dans le service ApplicationServer:atl-cs-001.litwareinc.com. Pour accomplir cette tâche, la cmdlet Get-CsRgsConfiguration est d’abord utilisée pour extraire toutes les valeurs de propriété des paramètres de configuration Response Group pour le service ApplicationServer:atl-cs-001.litwareinc.com. Notez que cette commande apparaît entre parenthèses pour s’assurer que Windows PowerShell retourne toutes les valeurs de propriété avant d’entreprendre quoi que ce soit.
Une fois toutes les valeurs de propriété retournées, la méthode de « notation par points » standard est adoptée pour afficher la valeur de la propriété DisableCallContext (et uniquement cette valeur). Cette notation se compose de l’objet suivi d’un point, puis du nom de la propriété à afficher. Par exemple, pour afficher la valeur de la propriété AgentRingbackGracePeriod (et seulement la valeur de cette propriété), vous pouvez exécuter la commande suivante :
(Get-CsRgsConfiguration -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com").AgentRingbackGracePeriod.
-------------------------- Exemple 3 ------------------------
Get-CsService -ApplicationServer | Where-Object {$_.Applications -contains "urn:application:RGS"} | ForEach-Object {Get-CsRgsConfiguration -Identity $_.Identity}
La commande présentée dans l’exemple 3 montre comment retourner des informations de configuration Response Group à partir de tous les ordinateurs équipés du service d’application et hébergeant une instance de l’application Response Group. Pour cela, la commande a d’abord recours à la cmdlet Get-CsService et au paramètre ApplicationServer pour récupérer des informations concernant tous les serveurs de l’organisation sur lesquels le service d’application fonctionne. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les serveurs dont la propriété Applications contient l’application "urn:application:RGS" ; cette valeur indique que l’application Response Group est en cours d’exécution sur le serveur.
À leur tour, les serveurs sont redirigés vers la cmdlet ForEach-Object. ForEach-Object récupère ensuite chaque serveur de la collection et, au moyen de la cmdlet Get-CsRgsConfiguration, retourne des informations de configuration Response Group à partir de chaque serveur.