Condividi tramite

  • Articolo

Get-CsRgsHoursOfBusiness

 

Ultima modifica dell'argomento: 2012-03-23

Recupera informazioni sulle raccolte di orari d'ufficio di Response Group configurate per l'utilizzo nell'organizzazione. Le raccolte degli orari d'ufficio sono utilizzate per indicare i giorni della settimana e le ore del giorni in cui gli agenti di Response Group sono in genere disponibili per rispondere alle chiamate telefoniche.

Sintassi

Get-CsRgsHoursOfBusiness [-Identity <RgsIdentity>] [-Name <String>]

Descrizione dettagliata

Allo scopo di garantire ai chiamanti la migliore esperienza di utilizzo possibile, l'applicazione Response Group consente di stabilire chiaramente quando gli agenti di Response Group sono disponibili per rispondere alle chiamate e quando non lo sono. Con l'applicazione Response Group, è infatti possibile definire gli orari d'ufficio, che indicano i giorni della settimana e le ore del giorno in cui gli agenti sono a disposizione per rispondere alle chiamate. Ad esempio, se l'organizzazione è aperta in genere dal lunedì al venerdì dalle 09.00 alle 17.00, sarà possibile configurare gli orari d'ufficio in maniera tale che indichino che gli agenti sono disponibili dal lunedì al venerdì dalle 09.00 alle 17.00 e, di conseguenza, che non sono disponibili il giovedì alle 20.00 o la domenica alle 14.30.

Il cmdlet Get-CsRgsHoursOfBusiness consente di recuperare informazioni sulle raccolte di orari d'ufficio configurate per l'utilizzo nell'organizzazione.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Get-CsRgsHoursOfBusiness i membri dei seguenti gruppi: RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsRgsHoursOfBusiness"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Identità Rgs

Rappresenta l'identità del servizio in cui è ospitata la raccolta degli orari d'ufficio o l'identità completa della stessa raccolta. Se si specifica l'identità del servizio (ad esempio, service:ApplicationServer:atl-cs-001.litwareinc.com), verranno restituite tutte le raccolte di orari d'ufficio ospitate nel servizio. Se si specifica l'identità della raccolta, verrà restituita solo la raccolta di orari d'ufficio specificata. Si noti che l'identità di una raccolta di orari d'ufficio è costituita dall'identità del servizio seguita da un identificatore univoco globale (GUID), ad esempio service:ApplicationServer-1/1987d3c2-4544-489d-bbe3-59f79f530a83.

Un modo alternativo per restituire una raccolta di orari d'ufficio consiste nello specificare l'identità del servizio e nell'includere il parametro Name e il nome della raccolta. Ciò consente di recuperare una specifica raccolta di orari d'ufficio senza conoscere il GUID assegnato alla raccolta stessa.

Se chiamato senza alcun parametro, Get-CsRgsHoursOfBusiness restituirà tutte le raccolte di orari d'ufficio configurate per l'utilizzo nell'organizzazione.

Name

Facoltativo

Stringa

Nome univoco assegnato alla raccolta degli orari d'ufficio nel momento stesso in cui la raccolta è stata creata.

Tipi di input

Nessuno. Get-CsRgsHoursOfBusiness non accetta l'input da pipeline.

Tipi restituiti

Restituisce istanze dell'oggetto Microsoft.Rtc.Rgs.Management.WritableSettings.BusinessHours.

Esempio

-------------------------- Esempio 1 ------------------------

Get-CsRgsHoursOfBusiness

Nell'esempio 1 vengono restituite informazioni su tutte le raccolte di orari d'ufficio configurate per l'utilizzo nell'organizzazione. A tale scopo, viene chiamato Get-CsRgsHoursOfBusiness senza alcun parametro.

-------------------------- Esempio 2 ------------------------

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

Il comando mostrato nell'esempio 2 restituisce tutte le raccolte di orari d'ufficio configurate per l'utilizzo in atl-cs-001.litwareinc.com.

-------------------------- Esempio 3 ------------------------

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

Il comando precedente restituisce una singola raccolta di orari d'ufficio da atl-cs-001.litwareinc.com, ovvero la raccolta con nome "Help Desk Business Hours".

-------------------------- Esempio 4 ------------------------

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

Il comando precedente restituisce tutte le raccolte di orari d'ufficio che hanno orari d'ufficio configurati per la domenica. A tale scopo, nel comando viene innanzitutto chiamato Get-CsRgsHoursOfBusiness per restituire tutte le raccolte di orari d'ufficio trovate in atl-cs-001.litwareinc.com. Questi dati vengono quindi inviati tramite pipe al cmdlet Where-Object, che seleziona solo gli elementi in cui uno dei seguenti criteri è vero: la proprietà SundayTimeRange1 non è uguale a un valore Null e/o la proprietà SundayTimeRange2 non è uguale a un valore Null. Se una proprietà relativa a un intervallo di tempo non è Null, significa che per tale intervallo di tempo sono stati configurati orari d'ufficio.

-------------------------- Esempio 5 ------------------------

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

Il comando mostrato nell'esempio 5 restituisce tutte le raccolte di orari d'ufficio di atl-cs-001.litwareinc.com in cui l'orario di apertura per la proprietà MondayTimeRange1 è uguale o antecedente alle 08.00 (08:00:00). A tale scopo, nel comando viene innanzitutto utilizzato Get-CsRgsHoursOfBusiness per restituire tutte le raccolte di orari d'ufficio di atl-cs-001.litwareinc.com. Questi dati vengono quindi inviati tramite pipe al cmdlet Where-Object, che seleziona solo le raccolte in cui il valore della proprietà MondayTimeRange1.OpenTime è minore o uguale alle 08.00 (08:00:00).

-------------------------- Esempio 6 ------------------------

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

Il comando mostrato nell'esempio 6 restituisce tutte le raccolte di orari d'ufficio pubbliche, ovvero le raccolte che possono essere condivise tra flussi di lavoro. A tale scopo, nel comando viene innanzitutto utilizzato Get-CsRgsHoursOfBusiness per restituire tutte le raccolte di orari d'ufficio trovate in atl-cs-001.litwareinc.com. Questi dati vengono quindi inviati tramite pipe al cmdlet Where-Object, che seleziona solo le raccolte in cui la proprietà Custom è uguale a False.