New-CsRgsHoliday
Dernière rubrique modifiée : 2012-03-23
Crée un congé Response Group. Dans l’application Response Group, un congé est une journée pendant laquelle les agents, affectés à une file d’attente, qui devraient travailler ce jour là, ne travaillent pas et ne sont pas disponibles pour répondre aux appels. Si, par exemple, les employés basés aux États-Unis ne travaillent pas le jour de Thanksgiving, un congé doit être défini pour le 24 novembre 2011.
Syntaxe
New-CsRgsHoliday -EndDate <Nullable> -StartDate <Nullable> [-Name <String>]
Description détaillée
L’application Response Group utilise des collections de jours ouvrés pour définir les jours de la semaine et les heures du jour pendant lesquels les agents sont généralement disponibles pour répondre aux appels téléphoniques. Supposons que votre support technique soit ouvert de 7 h 00 à 19 h 00 tous les lundis. Dans ce cas, vous devez créer une collection de jours ouvrés pour le support technique et définir l’heure d’ouverture à 7 h 00 et l’heure de fermeture à 19 h 00 pour la journée du lundi.
Toutefois, il peut exister des exceptions à la règle selon laquelle le support technique est ouvert pendant ces heures, tous les lundis. Aux États-Unis, par exemple, le 4 juillet est un jour férié. Ainsi donc, le support technique peut ne pas être disponible ce jour là. Pour tenir compte du fait que le support technique ne travaillera pas le lundi 4 juillet 2011, vous devez créer un congé pour cette date et l’ajouter au groupe de congés du support technique.
Pour créer un congé, vous devez utiliser la cmdlet New-CsRgsHoliday. (Notez que le terme « congé » n’est pas nécessairement associé à une célébration ou à des festivités. Il peut s’agir simplement d’un jour pendant lequel les agents ne sont pas disponibles pour répondre aux appels.) La cmdlet New-CsRgsHoliday n’ajoute pas directement un congé à un groupe de congés. Elle crée à la place un congé qui existe uniquement en mémoire. Vous devez par conséquent créer une référence d’objet (telle que $x) qui pointe vers l’instance en mémoire. Une fois le congé créé en mémoire, vous pouvez utiliser la cmdlet Get-CsRgsHolidaySet pour extraire le groupe de congés approprié, et la cmdlet Set-CsRgsHolidaySet pour ajouter le nouveau congé au groupe.
Bien qu’un groupe de congés puisse contenir (et contient généralement) plusieurs congés, ces congés doivent être ajoutés un par un au groupe.
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-CsRgsHoliday : RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. Cependant, parce que cette cmdlet crée un objet en mémoire et, en soi, n’apporte aucune modification au système,elle peut être exécutée par n’importe qui. 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-CsRgsHoliday\b"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Name |
Obligatoire |
Chaîne |
Nom unique qui permet de distinguer le congé des autres congés. |
EndDate |
Obligatoire |
DateTime |
Heure de fin du congé. Le format de la date de fin est fonction de vos paramètres régionaux et de votre langue. Par exemple, aux États-Unis, la date de fin du « 4 juillet 2011 » aura le format suivant : -EndDate "7/5/2011 12:00 AM" qui indique que le congé se termine à minuit le 5 juillet 2011. |
StartDate |
Obligatoire |
DateTime |
Heure de début du congé. Le format de la date de début est fonction de vos paramètres régionaux et de votre langue. Par exemple, aux États-Unis, la date de début du « 4 juillet 2011 » a le format suivant : -StartDate "7/4/2011 12:00 AM" qui indique que le congé commence à minuit le 4 juillet 2011. |
Types d’entrées
Aucun. New-CsRgsHoliday n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
New-CsRgsHoliday crée des instances de l’objet Microsoft.Rtc.Rgs.Management.WritableSettings.Holiday.
Exemple
-------------------------- Exemple 1 ------------------------
$christmasDay = New-CsRgsHoliday -StartDate "12/25/2010 12:00 AM" -EndDate "12/26/2010 12:00 AM" -Name "Christmas Day"
$y = Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays"
$y.HolidayList.Add($christmasDay)
Set-CsRgsHolidaySet -Instance $y
Les commandes de l’exemple 1 montrent comment créer un 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 » qui existe en mémoire et qui est stocké dans la variable $christmasDay. New-CsRgsHoliday utilise trois paramètres : StartDate qui correspond à la date de début du congé (12/25/2010 12:00 AM), -EndDate représentant la date de fin du congé (12/26/2010 12:00 AM) 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 troisième commande utilise la méthode Add pour ajouter le nouveau congé ($christmasDay) à la copie virtuelle du groupe de congés ($y). La dernière commande appelle Set-CsRgsHolidaySet pour écrire les modifications (c'est-à-dire ajouter le nouveau congé) au service ApplicationServer:atl-cs-001.litwareinc.com.