Remove-CsRgsHolidaySet
Dernière rubrique modifiée : 2012-03-23
Supprime 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
Remove-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 congés et les groupes de congés peuvent par la suite être affectés à des workflows Response Group.
La cmdlet Remove-CsRgsHolidaySet permet aux administrateurs de supprimer des groupes de congés Response Group. Par défaut, si vous tentez de supprimer un groupe de congés affecté à un workflow actif, la cmdlet s’arrête temporairement et vous demande de confirmer la suppression du workflow. L’exécution de la commande est interrompue et le groupe de congés n’est pas supprimé tant que vous ne répondez pas à l’invite. Pour ignorer cette invite et supprimer un groupe de congé, même si un workflow actif l’utilise, ajoutez le paramètre Force :
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays" | Remove-CsRgsHolidaySet –Force
Notez que lorsque vous appelez la cmdlet Remove-CsRgsHolidaySet, le groupe tout entier de congés est supprimé et ne peut plus être utilisé. Si vous cherchez uniquement à supprimer un seul congé d’un groupe de congés (par exemple, parce que votre société a finalement décidé de rester ouverte le jour de Thanksgiving), utilisez la cmdlet Set-CsRgsHolidaySet pour supprimer seulement le congé en question.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Remove-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 "Remove-CsRgsHolidaySet"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Instance |
Obligatoire |
Objet Holiday Set |
Référence d’objet pointant sur le groupe de congés à supprimer. Lorsque vous redirigez des objets de workflow vers la cmdlet Remove-CsRgsHolidaySet, vous pouvez ignorer le paramètre Instance. Pour utiliser le paramètre Instance, optez pour des commandes semblables à ce qui suit : $x = Get-CsRgsHolidaySet –Identity ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83 Remove-CsRgsHolidaySet –Instance $x Notez que seul un groupe de congés à la fois peut être supprimé lorsque vous utilisez le paramètre Instance, ce qui signifie que votre référence d’objet ($x) ne peut pas contenir plusieurs objets de groupe de congés. |
Force |
Facultatif |
Paramètre de commutateur |
Force la suppression du groupe de congés. Si vous définissez ce paramètre, le groupe de congés est supprimé sans avertissement, même si un workflow actif l’utilise. Si vous ne le définissez pas, un message vous demande de confirmer la suppression d’un groupe de congés affecté à un workflow actif. |
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 |
Ce paramètre est uniquement fourni à des fins de test. |
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
Remove-CsRgsHolidaySet supprime des instances existantes de l’objet Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet.
Exemple
-------------------------- Exemple 1 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays" | Remove-CsRgsHolidaySet
La commande présentée dans l’exemple 1 supprime le groupe de congés « 2010 Holidays » du service ApplicationServer:atl-cs-001.litwareinc.com. Pour ce faire, la commande appelle d’abord Get-CsRgsHolidaySet avec deux paramètres : Identity (qui définit l’emplacement du groupe de congés) et Name (qui spécifie le nom du groupe). L’objet retourné est ensuite redirigé vers Remove-CsRgsHolidaySet qui supprime le groupe de congés 2010 Holidays.
-------------------------- Exemple 2 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Select-Object Identity -ExpandProperty HolidayList | Where-Object {$_.Name -eq "New Year's Day"} | Remove-CsRgsHolidaySet
La commande ci-dessus supprime tous les groupes de congés dans le service ApplicationServer:atl-cs-001.litwareinc.com qui contient le congé New Year’s Day. Pour exécuter cette tâche, la commande utilise d’abord Get-CsRgsHolidaySet pour retourner la collection de tous les groupes de congés situés dans le service ApplicationServer:atl-cs-001.litwareinc.com. La collection est ensuite redirigée vers la cmdlet Select-Object qui exécute deux tâches : 1) Elle sélectionne la propriété Identity de chaque groupe de congés et 2) « développe » la valeur de la propriété HolidayList. (Lorsque vous développez une valeur, vous retournez les propriétés de l’objet sous-jacent. Dans le cas d’un congé, il s’agit de propriétés comme Name, StartDate et EndDate). Les informations sélectionnées (valeurs de propriété Identity et de congé du groupe de congés) sont ensuite redirigées vers la cmdlet Where-Object qui sélectionne les groupes qui contiennent un congé dont la propriété Name est égale à (-eq) « New Year’s Day ». La collection filtrée des groupes de congés est alors redirigée vers Remove-CsRgsHolidaySet qui supprime chaque groupe de congés qui contient le congé New Year’s Day.
-------------------------- Exemple 3 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Where-Object {$_.HolidayList.Count -lt 5} | Remove-CsRgsHolidaySet
La commande de l’exemple 3 supprime les groupes de congés du service ApplicationServer:atl-cs-001.litwareinc.com auxquels moins de 5 congés sont affectés. 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. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les groupes de congés dans lesquels le nombre de congés affectés ($_.HolidayList.Count) est inférieur à 5. Ces groupes de congés sont ensuite redirigés vers la cmdlet Remove-CsRgsHolidaySet qui les supprime.