Get-CsRgsHolidaySet
Dernière rubrique modifiée : 2012-03-23
Retourne des informations sur les groupes de congés Response Group configurés dans l’organisation. 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
Get-CsRgsHolidaySet [-Identity <RgsIdentity>] [-Name <String>]
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 Get-CsRgsHolidaySet permet de retourner des informations sur les groupes de congés Response Groupe configurés pour être utilisés dans l’organisation.
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-CsRgsHolidaySet : 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-CsRgsHolidaySet"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
RgsIdentity |
Représente soit l’identité du service où se trouve le groupe de congés, soit l’identité complète du groupe de congés. Si vous précisez l’identité du service (par exemple, service:ApplicationServer:atl-cs-001.litwareinc.com), tous les groupes de congés hébergés dans ce service sont retournés. Si vous précisez l’identité du groupe de congés, seul le groupe défini est retourné. Notez que l’identité d’un groupe de congés est constituée de l’identité du service suivie d’un identificateur global unique (GUID). Par exemple : service:ApplicationServer:atl-cs-001.litwareinc.com/1987d3c2-4544-489d-bbe3-59f79f530a83. Vous pouvez également retourner un seul groupe de congés en définissant l’identité du service et en incluant le paramètre Name suivi du nom du groupe de congés. Ainsi, vous pouvez extraire un groupe de congés sans connaître l’identificateur global unique qui lui a été affecté. Si vous appelez la cmdlet Get-CsRgsHolidaySet sans aucun paramètre, elle retourne une collection de tous les groupes de congés configurés en vue d’une utilisation au sein de votre organisation. |
Name |
Facultatif |
Chaîne |
Nom unique affecté au groupe de congés lors de sa création. |
Types d’entrées
Aucun. Get-CsRgsHolidaySet n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Get-CsRgsHolidaySet retourne des instances de l’objet Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet.
Exemple
-------------------------- Exemple 1 ------------------------
Get-CsRgsHolidaySet
L’exemple ci-dessus retourne des informations sur tous les groupes de congés configurés en vue d’une utilisation au sein de votre organisation.
-------------------------- Exemple 2 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com"
La commande présentée dans l’exemple 2 retourne des informations sur tous les groupes de congés du service ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Exemple 3 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays"
Dans l’exemple 3, un seul groupe de congés du service ApplicationServer:atl-cs-001.litwareinc.com est retourné : le groupe appelé « 2010 Holidays ». Parce que les noms doivent être uniques pour chaque service, cette commande retourne toujours un seul élément.
-------------------------- Exemple 4 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays"| Select-Object -ExpandProperty HolidayList
L’exemple 4 affiche des informations détaillées sur les congés stockés dans le groupe de congés 2010 Holidays (dans le service ApplicationServer:atl-cs-001.litwareinc.com). Pour ce faire, la commande utilise d’abord Get-CsRgsHolidaySet pour extraire le groupe de congés spécifié. Ce groupe est ensuite transmis à la cmdlet Select-Object qui utilise le paramètre ExpandProperty pour afficher des informations détaillées sur chaque congé du groupe.
-------------------------- Exemple 5 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Select-Object Identity -ExpandProperty HolidayList | Where-Object {$_.Name -eq "Christmas Day"} | ForEach-Object {Get-CsRgsHolidaySet -Identity $_.Identity}
La commande présentée dans l’exemple 5 indique l’identité de chaque groupe de congés dans le service ApplicationServer:atl-cs-001.litwareinc.com contenant un congé Christmas Day. Pour ce faire, la commande appelle d’abord Get-CsRgsHolidaySet pour retourner une collection de tous les groupes de congés définis dans ApplicationServer:atl-cs-001.litwareinc.com. La collection est ensuite redirigée vers la cmdlet Select-Object qui exécute deux tâches : elle sélectionne la propriété Identity et développe la propriété HolidayList.
Ces deux informations (Identity et la valeur développée de la propriété HolidayList) sont ensuite redirigées vers la cmdlet Where-Object. Where-Object sélectionne alors uniquement les éléments dont le nom de congé est égal à Christmas Day. Pour finir, la collection filtrée est redirigée vers la cmdlet ForEach-Object. Cette cmdlet sélectionne chaque identité dans la collection et, au moyen de la cmdlet Get-CsRgsHolidaySet extrait pour chacune d’elles le groupe de congés correspondant. Cette opération génère la liste de tous les groupes de congés contenant un congé Christmas Day.