Partager via

  • Article

New-CsRgsHolidaySet

 

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

Crée un groupe de congés Response Group. 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

New-CsRgsHolidaySet -Parent <RgsIdentity> -HolidayList <Collection> -Name <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <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 congés et leurs groupes correspondants peuvent par la suite être affectés à des workflows Response Group.

La cmdlet New-CsRgsHolidaySet permet de configurer de nouveaux groupes de congés pour votre organisation. Notez que, lorsque vous créez un groupe de congés, vous devez inclure au moins un congé. Ces congés individuels sont à créer au moyen de la cmdlet New-CsRgsHoliday.

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-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 "New-CsRgsHolidaySet"}

Paramètres

Paramètre Obligatoire Type Description

HolidayList

Obligatoire

Collection d’objets congé

Un ou plusieurs congés à ajouter au groupe de congés. Vous devez créer les congés à l’aide de la cdmlet New-CsRgsHoliday et les stocker dans une référence d’objet. Cette référence d’objet est ensuite transmise au paramètre Holidays pour ajouter les congés au groupe de congés. La commande suivante, par exemple, crée le congé New Year’s Day et stocke la valeur obtenue dans une référence d’objet $x :

$x = New-CsRgsHoliday -StartDate "1/1/2011 12:00 AM" -EndDate "1/2/2011 12:00 AM" -Name "New Year's Day"

Notez que le format adopté pour définir les dates et les heures est fonction de vos paramètres régionaux et de votre langue. Les exemples présentés dans cette rubrique utilisent l’anglais américain.

Name

Obligatoire

Chaîne

Nom unique à affecter au groupe de congés. La combinaison de la propriété Parent et de la propriété Name permet d’identifier de manière unique les groupes de congés sans que vous ayez à vous référer à leur identificateur global unique (GUID).

Parent

Obligatoire

RgsIdentity

Service dans lequel le nouveau groupe de congés sera hébergé. Par exemple : -Parent "service:ApplicationServer:atl-cs-001.litwareinc.com".

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.

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.

Types d’entrées

Aucun. New-CsRgsHolidaySet n’accepte pas la saisie de données transmises via le pipeline.

Types de retours

New-CsRgsHolidaySet crée des instances de l’objet Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet.

Exemple

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

$x = New-CsRgsHoliday -StartDate "1/1/2011 12:00 AM" -EndDate "1/2/2011 12:00 AM" -Name "New Year's Day"
New-CsRgsHolidaySet -Parent "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2011 Holidays" -HolidayList($x)

Les commandes présentées dans l’exemple 1 créent un groupe de congés 2011 et lui affecte un nouveau congé (New Year’s Day). Pour ce faire, la première commande utilise New-CsRgsHoliday pour créer un congé pour le Nouvel An (New Year’s Day). New-CsRgsHoliday accepte trois paramètres : StartDate qui indique la date de début du congé (1/1/2011 12:00 AM), EndDate qui définit la date de fin du congé (1/2/2011 12:00 AM) et Name qui permet de stocker le nom du congé. L’objet congé obtenu est stocké dans la variable $x.

Une fois le nouveau congé créé en mémoire, la cmdlet New-CsRgsHolidaySet est utilisée pour créer un groupe de congés dans le service ApplicationServer:atl-cs-001.litwareinc.com. Ce groupe de congés est appelé 2011 Holidays (-Name "2011 Holidays") et affecté du congé stocké dans la variable $x : -HolidayList ($x). Si vous voulez affecter plusieurs congés au groupe de congés, créez simplement les nouveaux congés en affectant chaque congé à une variable unique. Vous pouvez ensuite inclure tous ces noms de variables comme valeur de paramètre transmise à HolidayList :

-HolidayList($x, $y, $z)