Partager via


Get-CsRgsHoursOfBusiness

 

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

Extrait des informations sur les collections d’heures ouvrées Response Group définies dans votre organisation. Les collections d’heures ouvrées sont utilisées pour 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

Get-CsRgsHoursOfBusiness [-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).

La cmdlet Get-CsRgsHoursOfBusiness permet d’extraire des informations sur les collections d’heures ouvrées définies 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-CsRgsHoursOfBusiness : 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-CsRgsHoursOfBusiness"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

RgsIdentity

Correspond à l’identité du service où se trouve la collection d’heures ouvrées ou l’identité complète de la collection. Si vous définissez l’identité du service (par exemple, service:ApplicationServer:atl-cs-001.litwareinc.com), toutes les collections d’heures ouvrées hébergées sur ce service sont retournées. Si vous spécifiez l’identité de la collection, seule la collection d’heures ouvrées de travail définie est retournée. Notez que l’identité d’une collection d’heures ouvrées est constituée de l’identité du service suivie de l’identificateur global unique (GUID). Par exemple : service:ApplicationServer-1/1987d3c2-4544-489d-bbe3-59f79f530a83.

Vous pouvez également retourner une seule collection d’heures ouvrées en spécifiant l’identité du service et en incluant le paramètre Name suivi du nom de la collection. Ainsi, vous pouvez extraire une collection d’heures ouvrées sans connaître l’identificateur global unique (GUID) de la collection.

Si vous appelez la cmdlet Get-CsRgsHoursOfBusiness sans aucun paramètre, celle-ci retourne toutes les collections d’heures ouvrées définies dans votre organisation.

Name

Facultatif

Chaîne

Nom unique affecté à la collection d’heures ouvrées lors de sa création.

Types d’entrées

Aucun. Get-CsRgsHoursOfBusiness n’accepte pas la saisie de données transmises via le pipeline.

Types de retours

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

Exemple

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

Get-CsRgsHoursOfBusiness

L’exemple 1 retourne des informations sur toutes les collections d’heures ouvrées définies dans votre organisation. Cette opération est effectuée en appelant la cmdlet Get-CsRgsHoursOfBusiness sans aucun paramètre.

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

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

La commande de l’exemple 2 retourne toutes les collections d’heures ouvrées définies et utilisées sur le service atl-cs-001.litwareinc.com.

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

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

La commande ci-dessus retourne une seule collection d’heures ouvrées à partir du service atl-cs-001.litwareinc.com : la collection appelée « Help Desk Business Hours ».

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

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

La commande ci-dessus retourne toutes les collections 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 l’ensemble des collections d’heures ouvrées détectées sur le service atl-cs-001.litwareinc.com. Ces données sont ensuite redirigées 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 et/ou la propriété SundayTimeRange2 n’a pas une valeur Null. Si une propriété de période n’a pas la valeur Null, cela signifie que des heures ouvrées ont été définies pour cette période.

-------------------------- Exemple 5 ------------------------

Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Where-Object {$_.MondayTimeRange1.OpenTime -le "08:00:00"}

La commande de l’exemple 5 retourne toutes les collections d’heures ouvrées du service atl-cs-001.litwareinc.com dans lequel l’heure d’ouverture de la propriété MondayTimeRange1 est égale (ou antérieure à) 8 h 00. Pour cela, la commande fait d’abord appel à la cmdlet Get-CsRgsHoursOfBusiness pour retourner toutes les collections d’heures ouvrées du service atl-cs-001.litwareinc.com. Ces données sont ensuite redirigées vers la cmdlet Where-Object qui sélectionne les collections dont la valeur de la propriété MondayTimeRange1.OpenTime est inférieure ou égale à 8 h 00 (08:00:00).

-------------------------- Exemple 6 ------------------------

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

La commande de l’exemple 6 retourne toutes les collections d’heures ouvrées publiques, à savoir les collections qui ne peuvent pas être partagées entre les workflows. Pour ce faire, la commande utilise d’abord la cmdlet Get-CsRgsHoursOfBusiness pour retourner l’ensemble des collections d’heures ouvrées détectées sur le service atl-cs-001.litwareinc.com. Ces données sont ensuite redirigées vers la cmdlet Where-Object qui choisit uniquement les collections pour lesquelles la propriété Custom est égale à False.