Partager via

  • Article

Remove-CsRgsHoursOfBusiness

 

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

Supprime un groupe d’heures ouvrées Response Group existant. Les heures ouvrées permettent d’indiquer les jours de la semaine et les heures du jour pendant lesquels les agents Response Group sont généralement disponibles pour répondre aux appels.

Syntaxe

Remove-CsRgsHoursOfBusiness -Instance <BusinessHours> [-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).

Vous pouvez créer des groupes d’heures ouvrées à l’aide de la cmdlet New-CsRgsHoursOfBusiness et les supprimer par la suite avec la cmdlet Remove-CsRgsHoursOfBusiness. Notez que lorsque vous appelez la cmdlet Remove-CsRgsHoursOfBusiness, le groupe d’heures tout entier est supprimé et ne peut plus être utilisé. Si vous cherchez à supprimer uniquement les heures ouvrées d’un jour donné (par exemple, parce que le support technique n’est plus ouvert le dimanche), utilisez la cmdlet Set-CsRgsHoursOfBusiness pour supprimer seulement les valeurs concernées d’une collection.

Par défaut, Remove-CsRgsHoursOfBusiness affiche une invite si vous tentez de supprimer un groupe d’heures ouvrées utilisé dans un workflow actif. Cette invite vous demande de confirmer que vous voulez supprimer la collection et aucune action n’est exécutée tant que vous n’y répondez pas. Pour ignorer cette invite et supprimer silencieusement des groupes d’heures ouvrées, même si ces groupes sont affectés à un workflow actif, ajoutez le paramètre Force. Par exemple :

Get-CsRgsHoursOfBusiness –Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Remove-CsRgsHoursOfBusiness –Force

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-CsRgsHoursOfBusiness : 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-CsRgsHoursOfBusiness"}

Paramètres

Paramètre Obligatoire Type Description

Instance

Obligatoire

Objet HoursOfBusiness

Référence d’objet pointant sur le groupe d’heures ouvrées à supprimer. Lorsque vous redirigez des objets de workflow vers la cmdlet Remove-CsRgsHoursOfBusiness, vous pouvez ignorer le paramètre Instance.

Pour utiliser le paramètre Instance, optez pour des commandes semblables à ce qui suit :

$x = Get-CsRgsHoursOfBusiness –Identity ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83

Remove-CsRgsHoursOfBusiness –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 d’heures ouvrées.

Force

Facultatif

Paramètre de commutateur

Force la suppression d’un groupe d’heures ouvrées. Si vous définissez ce paramètre, le groupe est supprimé sans avertissement, même si un workflow actif lui est affecté. Si vous ne le définissez pas, un message vous demande de confirmer la suppression d’un groupe d’heures ouvrées 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

Vous demande confirmation avant d’exécuter la commande.

Types d’entrées

Objet Microsoft.Rtc.Rgs.Management.WritableSettings.BusinessHours. Remove-CsRgsHoursOfBusiness accepte également les instances redirigées de l’objet groupe d’heures ouvrées Response Group.

Types de retours

Supprime des instances existantes de l’objet Microsoft.Rtc.Rgs.Management.WritableSettings.BusinessHours.

Exemple

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

Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Remove-CsRgsHoursOfBusiness

La commande présentée dans l’exemple 1 supprime tous les groupes d’heures ouvrées du service ApplicationServer:atl-cs-001.litwareinc.com. Pour ce faire, la commande appelle d’abord Get-CsRgsHoursOfBusiness pour retourner l’ensemble des groupes d’heures ouvrées situés dans le service ApplicationServer:atl-cs-001.litwareinc.com. Ces groupes sont ensuite redirigés vers la cmdlet Remove-CsRgsHoursOfBusiness qui supprime chacun de ces groupes.

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

Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "Help Desk Business Hours" | Remove-CsRgsHoursOfBusiness

Dans l’exemple 2, un seul groupe d’heures ouvrées est supprimé de ApplicationServer:atl-cs-001.litwareinc.com : la collection appelée « Help Desk Business Hours ».

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

Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Where-Object {$_.SundayTimeRange1 -ne $Null -or $_.SundayTimeRange2 -ne $Null} | Remove-CsRgsHoursOfBusiness

La commande ci-dessus supprime tous les groupes d’heures ouvrées ayant des heures ouvrées définies pour le dimanche. Pour ce faire, la commande appelle d’abord Get-CsRgsHoursOfBusiness pour retourner tous les groupes d’heures ouvrées situés dans le service ApplicationServer:atl-cs-001.litwareinc.com. Ces groupes sont ensuite redirigés vers la cmdlet Where-Object qui sélectionne uniquement les éléments qui répondent à l’un des critères suivants : la propriété SundayTimeRange1 n’a pas une valeur Null ou la propriété SundayTimeRange2 n’a pas une valeur Null. (si une propriété de période n’est pas Null, cela implique que des heures ouvrées sont définies dans cet intervalle de temps.) Si un groupe correspond au minimum à l’un de ces critères, il est redirigé vers la cmdlet Remove-CsRgsHoursOfBusiness qui le supprime.

-------------------------- Exemple 4 ------------------------

Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Where-Object {$_.Custom -eq $True} | Remove-CsRgsHoursOfBusiness -Force

La commande présentée dans l’exemple 4 supprime tous les groupes d’heures ouvrées personnalisés (à savoir, les groupes qu’il n’est pas possible de partager entre des workflows). Pour réaliser cette tâche, la commande utilise d’abord Get-CsRgsHoursOfBusiness pour retourner tous les groupes d’heures ouvrées du service ApplicationServer:atl-cs-001.litwareinc.com. Ces données sont ensuite redirigées vers la cmdlet Where-Object qui choisit uniquement les groupes dont la propriété Custom est égale à True. Ces groupes sont ensuite redirigés vers Remove-CsRgsHoursOfBusiness qui les supprime.