Partager via

  • Article

Set-CsRgsHolidaySet

 

Dernière rubrique modifiée : 2012-03-23

Modifie les valeurs des propriétés d’un groupe de congés Response Group existant. Un groupe de congés Response Group est une collection de congés. Par exemple, vous pouvez disposer d’un groupe de congés pour une file d’attente aux États-Unis (qui peut inclure un congé pour le 4 juillet) et d’un autre groupe de congés pour une file d’attente en France. Cette dernière peut définir un congé pour le 14 juillet, mais pas pour le 4 juillet.

Syntaxe

Set-CsRgsHolidaySet -Instance <HolidaySet> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Pour fournir aux appelants un environnement aussi performant que possible, l’application Response Group vous permet de définir clairement les périodes pendant lesquelles les agents Response Group sont disponibles ou non pour répondre aux appels. Avec l’application Response Group, vous pouvez définir des heures ouvrées qui indiquent les jours de la semaine et les heures du jour pendant lesquels les agents sont disponibles pour répondre aux appels. Par exemple, si votre organisation est généralement ouverte de ouverte de 9 h 00 à 17 h 00, du lundi au vendredi, vous devez alors définir les heures ouvrées qui indiquent que les agents sont disponibles de 9 h 00 à 17 h 00 du lundi au vendredi (et, par conséquent, qu’ils ne le sont pas à 8 h 00 un jeudi ou à 14 h 30 un dimanche, par exemple).

Néanmoins, dans la plupart des organisations, il existe des exceptions pour la semaine de travail type. Par exemple, aux États-Unis, une organisation peut être fermée le jour de Noël ou le jour de Thanksgiving. Pour inclure les fermetures non conventionnelles, l’application Response Group permet de définir certains jours comme jours de congé : jours d’ouverture habituels de l’organisation, mais pendant lesquels elle n’est pas ouverte pour une raison donnée. Les congés individuels (créés à l’aide de la cmdlet New-CsRgsHoliday) sont rassemblés dans des groupes de congés. Par exemple, les congés pour les États-Unis peuvent être collectés dans un groupe de congés US_Holidays et ceux du Japon, dans un groupe appelé Japanese_Holidays. Une fois collectés, les groupes de congés peuvent être affectés à des workflows Response Group.

La cmdlet Set-CsRgsHolidaySet permet de modifier un groupe de congés existant. (En règle générale, cela équivaut à ajouter ou supprimer des congés dans le groupe.) La cmdlet Set-CsRgsHolidaySet n’est pas utilisée directement pour modifier un groupe de congés. À la place, une référence d’objet à un groupe de congés existant est créée à l’aide de la cmdlet Get-CsRgsHolidaySet. (Une référence d’objet est une variable qui, dans ce cas, fait référence à un groupe de congés existant.) Les modifications apportées au groupe ont lieu en mémoire, puis la cmdlet Set-CsRgsHolidaySet est utilisée pour écrire les modifications dans le groupe de congés même. Si vous n’appelez pas Set-CsRgsHolidaySet, les modifications existeront uniquement en mémoire et elles seront supprimées dès que vous fermerez Windows PowerShell ou supprimerez la 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-CsRgsHolidaySet : 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-CsRgsHolidaySet"}

Paramètres

Paramètre Obligatoire Type Description

Instance

Obligatoire

Objet HolidaySet

Référence d’objet au groupe de congés Response Group à modifier. Une référence d’objet est généralement extraite en utilisant la cmdlet Get-CsRgsHolidaySet et en affectant la valeur retournée à une variable. Par exemple, cette commande retourne une référence d’objet au groupe de congés Help Desk et la stocke dans une variable $x :

$x = Get-CsRgsHolidaySet -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.HolidaySet. Remove-CsRgsHolidaySet accepte également les instances redirigées de l’objet groupe de congés Response Group.

Types de retours

Set-CsRgsHolidaySet ne retourne aucun objet, ni aucune valeur. À la place, la cmdlet modifie les instances existantes de l’objet Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet.

Exemple

-------------------------- Exemple 1 ------------------------

$x = New-CsRgsHoliday -StartDate "12/25/2010" -EndDate "12/26/2010" -Name "Christmas Day"
$y = Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays"
$y.HolidayList.Add($x)
Set-CsRgsHolidaySet -Instance $y

Les commandes présentées dans l’exemple 1 montrent comment créer un nouveau congé (Christmas Day) et affecter ce congé à un groupe de congés existant. Pour ce faire, la première commande de l’exemple utilise la cmdlet New-CsRgsHoliday pour créer un congé (un congé « virtuel » existant seulement en mémoire et stocké dans la variable $x). New-CsRgsHoliday utilise trois paramètres : StartDate qui correspond à la date de début du congé (12/25/2010), EndDate représentant la date de fin du congé (12/26/2010) et Name qui définit le nom unique à attribuer au congé.

Après avoir créé le congé, la deuxième commande utilise Get-CsRgsHolidaySet pour extraire le groupe de congés « 2010 Holidays » du service ApplicationServer:atl-cs-001.litwareinc.com. Ce groupe de congés est stocké dans la variable $y.

La commande 3 utilise la méthode Add pour ajouter le nouveau congé ($x) à la copie virtuelle du groupe de congés ($y). La dernière commande utilise ensuite la cmdlet Set-CsRgsHolidaySet pour écrire ces modifications (c’est-à-dire ajouter le nouveau congé) au service ApplicationServer:atl-cs-001.litwareinc.com.

-------------------------- Exemple 2 ------------------------

$x = Get-CsRgsHolidaySet -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "2010 Holidays"
$y = $x.HolidayList | Where-Object {$_.Name -eq "Christmas Day"}
$x.HolidayList.Remove($y)
Set-CsRgsHolidaySet -Instance $x

Les commandes de l’exemple 2 suppriment un congé (ici Christmas Day) du groupe de congés existant. Pour ce faire, la première commande de l’exemple utilise Get-CsRgsHolidaySet pour extraire le groupe de congés 2010 Holidays (-Name "2010 Holidays") du service ApplicationServer:atl-cs-001.litwareinc.com. Les données extraites sont stockées dans la variable $x.

Dans la deuxième commande, la propriété HolidayList du groupe de congés extrait est redirigée vers la cmdlet Where-Object qui sélectionne le congé dont la valeur de la propriété Name est égale à « Christmas Day ». Ce congé est stocké dans la variable $y.

Une fois le congé Christmas Day extrait, la commande 3 utilise la méthode Remove pour supprimer le congé Christmas Day ($y) du groupe de congés ($x). La dernière commande de l’exemple utilise ensuite la cmdlet Set-CsRgsHolidaySet pour écrire ces modifications (c’est-à-dire supprimer le congé Christmas Day) du groupe de congés 2010 Holidays défini dans le service ApplicationServer:atl-cs-001.litwareinc.com.

-------------------------- Exemple 3 ------------------------

$x = Get-CsRgsHolidaySet -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "2010 Holidays"
$x.HolidayList.Clear()
Set-CsRgsHolidaySet -Instance $x

Les commandes présentées dans l’exemple 3 suppriment tous les congés du groupe de congés 2010 Holidays dans le service ApplicationServer:atl-cs-001.litwareinc.com. Pour ce faire, la première étape de l’exemple utilise Get-CsRgsHolidaySet pour extraire le groupe de congés approprié du service ApplicationServer:atl-cs-001.litwareinc.com. Le groupe de congés est ensuite stocké dans la variable $x.

Une fois le groupe de congés extrait, la méthode Clear est utilisée pour supprimer toutes les valeurs stockées dans la propriété HolidayList. Une fois cette propriété supprimée, la dernière commande de l’exemple utilise la cmdlet Set-CsRgsHolidaySet pour réécrire ces modifications dans le groupe de congés 2010 Holidays.