Partager via

  • Article

Set-CsRgsHoursOfBusiness

 

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

Configure un groupe existant d’heures ouvrées Response Group. Les périodes d’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

Set-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. Une fois ces groupes créés, vous pouvez les modifier au moyen de la cmdlet Set-CsRgsHoursOfBusiness. En règle générale, ceci implique que vous modifiiez les heures ouvrées d’un ou de plusieurs jours de la semaine. Si, par exemple, le support technique restait ouvert jusqu’à 17 h 00 le vendredi et qu’il reste ouvert désormais jusqu’à 19 h 00 ce même jour, vous devez modifier les heures ouvrées du vendredi. S’il était ouvert le samedi mais est à présent fermé ce jour-là, vous devez également modifier les heures ouvrées du samedi. (Pour indiquer qu’un groupe n’est pas disponible un jour en particulier, définissez simplement les heures ouvrées de ce même jour sur une valeur Null : -SundayTimeRange1 $Null.)

Lorsque vous définissez des heures ouvrées dans un groupe d’heures ouvrées, notez que chaque jour de la semaine dispose d’une propriété Hours1 et d’une propriété Hours2. Si le support technique est ouvert entre 8 h 00 et 17  h 00, il suffit d’affecter des valeurs à la propriété Hours1 appropriée. Toutefois, supposons que le support technique soit ouvert entre 8 h 00 et 14 h 00, puis entre 17 h 00 et 23 h 00. Dans ce cas, vous devez affecter la période de 8 h 00 à 14 h 00 à la propriété Hours1 et la période de 17 h 00 à 23 h 00 à la propriété Hours2.

Notez que la cmdlet Set-CsRgsHoursOfBusiness ne modifie pas directement un groupe d’heures ouvrées. Vous devez utiliser à la place la cmdlet Get-CsRgsHoursOfBusiness pour créer une référence d’objet au groupe à modifier. (Lorsque vous créez une référence d’objet, vous extrayez simplement une copie du groupe d’heures ouvrées et stockez la copie dans une variable.) Après avoir créé une référence d’objet, vous modifiez les propriétés de l’objet en mémoire uniquement. Une fois vos modifications terminées, vous utilisez la cmdlet Set-CsRgsHoursOfBusiness pour écrire ces modifications dans le groupe d’heures ouvrées.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Set-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 "Set-CsRgsHoursOfBusiness"}

Paramètres

Paramètre Obligatoire Type Description

Instance

Obligatoire

Objet BusinessHours

Référence d’objet au groupe d’heures ouvrées à modifier. Une référence d’objet est généralement extraite en utilisant la cmdlet Get-CsRgsHoursOfBusiness et en affectant la valeur retournée à une variable. Par exemple, cette commande retourne une référence d’objet au groupe d’heures ouvrées Help Desk et la stocke dans une variable $x :

$x = Get-CsRgsHoursOfBusiness -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk"

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.

WhatIf

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. Set-CsRgsHoursOfBusiness accepte également les instances redirigées de l’objet groupe d’heures ouvrées Response Group.

Types de retours

Modifie des instances existantes de l’objet Microsoft.Rtc.Rgs.Management.WriteableSettings.BusinessHours.

Exemple

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

$weekend = New-CsRgsTimeRange -Name "Weekend Hours" -OpenTime "12:00" -CloseTime "17:00"

$x = Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "Help Desk Business Hours"
$x.SaturdayHours1 = $weekend
$x.SundayHours1 = $weekend
Set-CsRgsHoursOfBusiness -Instance $x

L’exemple ci-dessus montre que vous pouvez affecter une nouvelle période aux propriétés SaturdayHours1 et SundayHours1 du groupe d’heures ouvrées « Help Desk Business Hours ». Pour ce faire, la première commande de l’exemple utilise New-CsRgsTimeRange pour créer un nouvel objet de plage horaire ou période (Weekend Hours) avec une heure d’ouverture fixée à midi (12:00) et une heure de fermeture à 17 h 00 (17:00). Cet objet est stocké dans la variable $weekend.

La commande suivante crée une référence d’objet ($x) au groupe d’heures ouvrées Help Desk Business Hours défini dans le service ApplicationServer:atl-cs-001.litwareinc.com. Lorsque l’exécution de la commande prend fin, les commandes 3 et 4 affectent aux propriétés SaturdayHours1 et SundayHours1 la valeur de période stockée dans la variable $weekend. Enfin, la dernière commande de l’exemple utilise la cmdlet Set-CsRgsHoursOfBusiness pour écrire ces modifications dans le groupe d’heures ouvrées lui-même.

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

$x = Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "Help Desk Business Hours"
$x.SaturdayHours1 = $Null
$x.SaturdayHours2 = $Null

Set-CsRgsHoursOfBusiness -Instance $x

Les commandes présentées dans l’exemple 2 suppriment les valeurs configurées pour les propriétés SaturdayHours1 et SaturdayHours2 dans le groupe d’heures ouvrées « Help Desk Business Hours ». Pour ce faire, la première commande crée une référence d’objet ($x) au groupe d’heures ouvrées Help Desk Business Hours défini dans le service ApplicationServer:atl-cs-001.litwareinc.com. Une fois la référence d’objet créée, la deuxième commande affecte à la propriété SaturdayHours1 une valeur Null ($Null), ce qui permet d’effacer la valeur précédente affectée à la propriété SaturdayHours1. Une commande semblable est ensuite utilisée pour supprimer toute valeur précédente affectée à la propriété SaturdayHours2.

La dernière commande de l’exemple fait appel à la cmdlet Set-CsRgsHoursOfBusiness pour écrire ces modifications dans le groupe d’heures ouvrées. Une fois l’exécution de la commande terminée, plus aucune heure ouvrée du samedi ne sera affectée au groupe Help Desk Business Hours.