New-CsRgsTimeRange
Dernière rubrique modifiée : 2012-03-23
Crée une nouvelle période Response Group. Les périodes servent à l’application Response Group pour préciser des heures d’ouverture et de fermeture pour un jour ouvré. Par exemple, si les agents de votre service de support technique sont disponibles uniquement de midi à 17 h le dimanche, il vous faut alors créer une période avec une heure d’ouverture fixée à 12 h et une heure de fermeture à 17 h.
Syntaxe
New-CsRgsTimeRange -CloseTime <Nullable> -OpenTime <Nullable> [-Name <String>]
Description détaillée
L’application Response Group utilise les heures ouvrées collectées pour garder trace des jours de la semaine et des heures au quotidien pendant lesquels les agents sont généralement disponibles pour répondre à des appels téléphoniques. Par exemple, imaginons que votre support technique est ouvert de 7 h 00 à 19 h 00 tous les lundis. Dans ce cas, deux opérations sont à réaliser : utilisez la cmdlet New-CsRgsHoursOfBusiness pour créer une collection d’heures ouvrées pour le support technique, puis modifiez la propriété MondayTimeRange1 pour indiquer que ce service ouvre à 7 h et ferme à 19 h.
La modification d’une collection d’heures ouvrées existante nécessite le recours à la cmdlet Set-CsRgsHoursOfBusiness. En revanche, vous ne pouvez pas utiliser cette cmdlet pour modifier directement une propriété de période (par exemple, la cmdlet Set-CsRgsHoursOfBusiness ne dispose d’aucun paramètre correspondant à la propriété MondayTimeRange1). À la place, toutes les modifications que vous apportez à une collection d’heures ouvrées exigent que vous récupériez cette dernière à l’aide de la cmdlet Get-CsRgsHoursOfBusiness, que ces modifications aient lieu en mémoire seulement, puis que vous utilisiez la cmdlet Set-CsRgsHoursOfBusiness pour les écrire dans la collection d’heures ouvrées elle-même.
Dans la plupart des cas, les changements que vous apportez à une collection d’heures ouvrées impliqueront de changer les heures d’ouverture et/ou de fermeture pour un jour donné (voire plusieurs jours). Pour modifier les heures d’ouverture et de fermeture, vous devez les spécifier à l’aide de la cmdlet New-CsRgsTimeRange. Lorsque vous appelez cette cmdlet, la valeur qui en résulte doit être stockée dans une variable de référence d’objet. Cette variable servira ensuite à définir des heures d’ouverture et de fermeture pendant la période d’heures ouvrées précisée.
Vous devez également faire appel à la cmdlet New-CsRgsTimeRange pour spécifier des heures d’ouverture et de fermeture chaque fois que vous créez une nouvelle collection 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 New-CsRgsTimeRange : 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-CsRgsTimeRange"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
CloseTime |
Obligatoire |
TimeSpan |
Heure du jour à laquelle la période ouvrée se termine. Le paramètre CloseTime doit utiliser le format 24 heures. Par exemple, pour préciser que la période ouvrée débute à 21 h, adoptez ce format : -CloseTime "21:00". |
OpenTime |
Obligatoire |
TimeSpan |
Heure du jour à laquelle la période ouvrée débute. Le paramètre OpenTime doit utiliser le format 24 heures. Par exemple, pour préciser que la période ouvrée débute à 13 h 30, adoptez ce format : -OpenTime "13:30". |
Name |
Facultatif |
Chaîne |
Identificateur unique de la période créée. Le nom est limité à un nombre maximum de 128 caractères. |
Types d’entrées
Aucun. New-CsRgsTimeRange n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
New-CsRgsTimeRange crée des nouvelles instances de l’objet Microsoft.Rtc.Rgs.Management.WritableSettings.TimeRange.
Exemple
-------------------------- Exemple 1 ------------------------
$sundayHours = New-CsRgsTimeRange -Name "Sunday hours" -OpenTime "08:30" -CloseTime "13:30"
$y = Get-CsRgsHoursOfBusiness -Identity Service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Hours"
$y.SundayHours1 = $sundayHours
Set-CsRgsHoursOfBusiness -Instance $y
L’exemple ci-dessus montre comment utiliser la cmdlet New-CsRgsTimeRange pour modifier les propriétés d’un groupe d’heures ouvrées existant. Dans cet exemple, la cmdlet New-CsRgsTimeRange est d’abord appelée dans le but de créer une nouvelle période intitulée « Sunday hours » (heures dominicales). Cette période fixe l’heure d’ouverture à 8 h 30 (08:30) et l’heure de fermeture à 13 h 30 (13:30). La période en mémoire uniquement que vous créez à l’aide de cette commande est stockée dans une variable appelée « $sundayHours ».
Une fois cette période configurée, la deuxième commande de l’exemple utilise la cmdlet Get-CsRgsHoursOfBusiness pour retourner la collection d’heures ouvrées « Help Desk Hours » (stockée dans le service ApplicationServer:atl-cs-001.litwareinc.com). La collection retournée est stockée dans une variable $y.
Une fois la collection extraite, la troisième commande définit la valeur de la propriété SundayHours1 sur $sundayHours, soit la référence d’objet contenant la période que nous venons de créer. Une fois cette commande terminée, la cmdlet Set-CsRgsHoursOfBusiness est utilisée pour écrire ces modifications dans la collection d’heures ouvrées Help Desk Hours. Notez qu’en cas d’échec d’appel de la cmdlet Set-CsRgsHoursOfBusiness, la nouvelle période créée existera en mémoire uniquement et disparaîtra au moment même où vous fermerez Windows PowerShell ou supprimerez la variable $sundayHours. Dans ce cas, la collection d’heures ouvrées Help Desk Hours ne sera jamais mise à jour.
-------------------------- Exemple 2 ------------------------
$sundayHours = New-CsRgsTimeRange -Name "Sunday hours" -OpenTime "08:30" -CloseTime "13:30"
New-CsRgsHoursOfBusiness -Parent Service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Hours" -SundayHours1 $sundayHours
L’exemple 2 explique comment créer une nouvelle période Response Group, puis l’utiliser dans une nouvelle collection d’heures ouvrées. La première commande dévoilée dans cet exemple utilise la cmdlet New-CsRgsTimeRange pour créer une période appelée « Sunday Hours ». La valeur OpenTime de la période est définie à 8 h 30 ("08:30") et la valeur CloseTime à 13 h 30 ("13:30", soit 13 heures et 30 minutes au format 24 heures). L’objet de période qui en résulte est stocké dans une variable appelée « $sundayHours ».
Dans la deuxième commande, la cmdlet New-CsRgsBusinessHours est utilisée en vue de créer une nouvelle collection d’heures ouvrées appelée « Help Desk Hours ». Dans cette commande, la variable $sundayHours spécifie la période pour la propriété SundayHours1.