Set-CsRgsConfiguration
Dernière rubrique modifiée : 2012-03-23
Modifie les paramètres de configuration de l’application Response Group.
Syntaxe
Set-CsRgsConfiguration -Identity <RgsIdentity> [-AgentRingbackGracePeriod <Int16>] [-Confirm [<SwitchParameter>]] [-DefaultMusicOnHoldFile <AudioFile>] [-DisableCallContext <$true | $false>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Set-CsRgsConfiguration -Instance <ServiceSettings> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
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é automatiquement vers le groupe d’agents Response Group approprié. Il peut également être routé 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, soit les informations qu’il demandait lui sont ensuite transmises, soit il est routé vers une file d’attente Response Group.
La cmdlet Set-CsRgsConfiguration vous permet de modifier les propriétés d’une instance de l’application 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 Set-CsRgsConfiguration : 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-CsRgsConfiguration"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
RgsIdentity |
Nom du service qui contient les paramètres de configuration Response Group. Par exemple : -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com." |
Instance |
Facultatif |
Objet ServiceSettings |
Référence d’objet aux paramètres de configuration Response Group à modifier. Une référence d’objet est généralement extraite en utilisant la cmdlet Get-CsRgsConfiguration et en affectant la valeur retournée à une variable. Par exemple, cette commande retourne une référence d’objet aux paramètres de configuration détectés sur le service ApplicationServer:atl-cs-001.litwareinc.com et stocke la référence d’objet en question dans une variable $x : $x = Get-CsRgsConfiguration -Identity service:ApplicationServer:atl-cs-001.litwareinc.com |
AgentRingbackGracePeriod |
Facultatif |
Entier |
Si un agent refuse un appel, AgentRingbackGracePeriod représente le délai en secondes qui s’écoule avant que l’appel soit renvoyé au même agent. La période de grâce peut être définie sur un entier quelconque compris entre 30 et 600 secondes (10 minutes) inclus. La valeur par défaut est de 60 secondes. |
DefaultMusicOnHoldFile |
Facultatif |
Objet AudioFile |
Représente la musique qui, par défaut, est diffusée chaque fois qu’un appelant est mis en attente. La musique par défaut est lue uniquement si un workflow Response Group ne définit pas sa propre musique d’attente. La propriété DefaultMusicOnHoldFile doit être configurée au moyen d’une référence d’objet créée à l’aide de la cmdlet Import-CsRgsAudioFile. Si la propriété DefaultMusicOnHold n’équivaut pas à une valeur Null (valeur par défaut) et si aucune musique d’attente personnalisée n’a été définie pour un workflow, alors la musique d’attente par défaut, automatiquement configurée au moment d’installer Lync Server, sera diffusée chaque fois qu’un appelant est mis en attente. |
DisableCallContext |
Facultatif |
Paramètre de commutateur |
Si la valeur est False (valeur par défaut), chaque agent peut voir le contexte d’un appel (informations telles que le délai d’attente de l’appelant et les questions et réponses du workflow) lors de la réception de ce dernier (ces informations sont visibles dans Microsoft Lync 2010). Si la valeur est True, les informations contextuelles de l’appel ne sont pas envoyées aux agents lors de la réception d’un appel. Notez que le contexte de l’appel est uniquement employé dans les files d’attente du système de réponse vocale interactive. |
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 |
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.ServiceSettings. Set-CsRgsConfiguration accepte les instances transmises via le pipeline de l’objet de paramètres de l’application Response Group.
Types de retours
Set-CsRgsConfiguration ne retourne aucun objet, ni aucune valeur. À la place, cette cmdlet configure les instances existantes de l’objet Microsoft.Rtc.Rgs.Management.WritableSettings.ServiceSettings.
Exemple
-------------------------- Exemple 1 ------------------------
Set-CsRgsConfiguration -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -AgentRingbackGracePeriod 30
La commande présentée dans l’exemple 1 modifie la propriété AgentRingbackGracePeriod des paramètres de configuration de l’application Response Group sur le service ApplicationServer:atl-cs-001.litwareinc.com. Dans cet exemple, AgentRingbackGracePeriod a la valeur 30 secondes.
-------------------------- Exemple 2 ------------------------
Get-CsService -ApplicationServer | Where-Object {$_.Applications -contains "urn:application:RGS"} | ForEach-Object {Set-CsRgsConfiguration -Identity $_.Identity -AgentRingbackGracePeriod 30}
L’exemple 2 modifie la propriété AgentRingbackGracePeriod pour tous les paramètres de configuration Response Group de l’organisation. 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 ordinateurs de l’organisation sur lesquels le service d’application fonctionne. La collection retournée est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les ordinateurs où 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 ordinateurs sont redirigés vers la cmdlet ForEach-Object. ForEach-Object récupère ensuite chaque ordinateur de la collection et, au moyen de la cmdlet Set-CsRgsConfiguration, définit sur 30 secondes la valeur de la propriété AgentRingbackGracePeriod des paramètres de configuration Response Group de l’ordinateur.
-------------------------- Exemple 3 ------------------------
$x = Import-CsRgsAudioFile -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -FileName "WhileYouWait.wav" -Content (Get-Content C:\Media\WhileYouWait.wav -Encoding byte -ReadCount 0)
Set-CsRgsConfiguration -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -DefaultMusicOnHoldFile $x
Les commandes dévoilées dans l’exemple 3 importent un fichier audio (C:\Media\WhileYouWait.wav), puis affectent ce fichier à la propriété DefaultMusicOnHoldFile. Pour exécuter cette tâche, la première commande utilise Import-CsRgsAudioFile pour importer le fichier audio vers l’application Response Group détectée sur ApplicationServer:atl-cs-001.litwareinc.com. Outre le paramètre Identity (qui définit l’emplacement du service), le paramètre FileName est utilisé pour préciser le nom du fichier à importer.
Le paramètre Content, tout aussi important, permet d’importer le fichier audio. L’importation du fichier est réalisée en appelant la cmdlet Get-Content suivie du chemin d’accès au fichier à importer. Get-Content implique également de définir le type de codage sur « byte » et d’affecter la valeur 0 à ReadCount (pour s’assurer que l’ensemble du fichier est lu en une seule fois). Le fichier importé est ensuite stocké dans une variable $x.
Une fois le fichier importé, la cmdlet Set-CsRgsConfiguration est appelée afin de définir la propriété DefaultMusicOnHold sur le fichier audio stocké dans la variable $x.