Get-CsRgsHolidaySet
Ultima modifica dell'argomento: 2012-03-23
Restituisce informazioni sugli insiemi di festività di Response Group configurati per l'utilizzo nell'organizzazione. Un insieme di festività di Response Group è una raccolta di festività. Ad esempio, è possibile avere un insieme di festività per una coda relativa agli Stati Uniti (ovvero un insieme che può includere la festività del 4 luglio) e un insieme diverso per una coda relativa alla Francia. Quest'ultima coda può definire una festività in corrispondenza della presa della Bastiglia, ma non in corrispondenza del 4 luglio.
Sintassi
Get-CsRgsHolidaySet [-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.
In molte organizzazioni vi sono tuttavia eccezioni alla settimana lavorativa tipica. Negli Stati Uniti, ad esempio, un'organizzazione può essere chiusa a Natale o durante il Giorno del Ringraziamento. Per gestire tali chiusure atipiche, l'applicazione Response Group consente di designare come festività determinati giorni, ovvero giorni in cui l'organizzazione sarebbe in genere aperta ma che, per qualche ragione, in questo caso non lo è. Le singole festività (create utilizzando il cmdlet New-CsRgsHoliday) sono raccolte in insiemi di festività. Le festività relative agli Stati Uniti, ad esempio, possono essere raccolte in un insieme denominato US_Holidays, mentre le festività relative al Giappone in un insieme denominato Japanese_Holidays. Una volta raccolti, gli insiemi di festività possono essere assegnati ai flussi di lavoro di Response Group.
Il cmdlet Get-CsRgsHolidaySet consente di restituire informazioni sugli insiemi di festività di Response Group configurati per l'utilizzo nell'organizzazione.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Get-CsRgsHolidaySet 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-CsRgsHolidaySet"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
Identità Rgs |
Rappresenta l'identità del servizio in cui è ospitato l'insieme di festività o l'identità completa dell'insieme di festività. Se si specifica l'identità del servizio (ad esempio, service:ApplicationServer:atl-cs-001.litwareinc.com), verranno restituiti tutti gli insiemi di festività ospitati nel servizio. Se si specifica l'identità dell'insieme di festività, verrà restituito solo l'insieme specificato. L'identità di un insieme di festività è costituita dall'identità del servizio seguita da un identificatore univoco globale (GUID), ad esempio service:ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83. Un modo alternativo per restituire un singolo insieme di festività consiste nello specificare l'identità del servizio e nell'includere il parametro Name e il nome dell'insieme di festività. Ciò consente di recuperare un insieme di festività specifico senza conoscere il GUID assegnato all'insieme stesso. Se chiamato senza alcun parametro, Get-CsRgsHolidaySet restituirà una raccolta di tutti gli insiemi di festività configurati per l'utilizzo nell'organizzazione. |
Name |
Facoltativo |
Stringa |
Nome univoco assegnato all'insieme di festività nel momento stesso in cui il gruppo è stato creato. |
Tipi di input
Nessuno. Get-CsRgsHolidaySet non accetta l'input da pipeline.
Tipi restituiti
Get-CsRgsHolidaySet restituisce istanze dell'oggetto Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet.
Esempio
-------------------------- Esempio 1 ------------------------
Get-CsRgsHolidaySet
Il comando precedente restituisce informazioni su tutti gli insiemi di festività configurati per l'utilizzo nell'organizzazione.
-------------------------- Esempio 2 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com"
Il comando mostrato nell'esempio 2 restituisce informazioni su tutti gli insiemi di festività configurati per il servizio ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Esempio 3 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays"
Nell'esempio 3 viene restituito un solo insieme di festività dal servizio ApplicationServer:atl-cs-001.litwareinc.com, ovvero l'insieme denominato "2010 Holidays". Poiché i nomi devono essere univoci per ogni servizio, questo comando non restituirà mai più di un elemento.
-------------------------- Esempio 4 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays"| Select-Object -ExpandProperty HolidayList
Nell'esempio 4 vengono visualizzate informazioni dettagliate sulle festività dell'insieme "2010 Holidays" trovato nel servizio ApplicationServer:atl-cs-001.litwareinc.com. A tale scopo, viene innanzitutto utilizzato il comando Get-CsRgsHolidaySet per recuperare l'insieme di festività specificato. L'insieme viene quindi passato al cmdlet Select-Object, che utilizza il parametro ExpandProperty per visualizzare informazioni dettagliate per ciascuna festività presente nell'insieme.
-------------------------- Esempio 5 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Select-Object Identity -ExpandProperty HolidayList | Where-Object {$_.Name -eq "Christmas Day"} | ForEach-Object {Get-CsRgsHolidaySet -Identity $_.Identity}
Il comando mostrato nell'esempio 5 restituisce l'identità di ciascun insieme di festività presente in ApplicationServer:atl-cs-001.litwareinc.com che include una festività denominata Christmas Day. A tale scopo, nel comando viene innanzitutto chiamato Get-CsRgsHolidaySet per restituire una raccolta di tutti gli insiemi di festività trovati in ApplicationServer:atl-cs-001.litwareinc.com. Questa raccolta viene quindi inviata tramite pipe a Select-Object, che esegue due operazioni, ovvero seleziona la proprietà Identity ed espande la proprietà HolidayList.
Queste due informazioni, Identity e il valore espanso della proprietà HolidayList, vengono quindi inviate tramite pipe al cmdlet Where-Object, che a sua volta seleziona solo gli elementi in cui il nome della festività è uguale a Christmas Day. La raccolta filtrata viene infine inviata tramite pipe al cmdlet ForEach-Object. Tale cmdlet individua ogni identità presente nella raccolta e per ciascuna utilizza Get-CsRgsHolidaySet per recuperare l'insieme di festività corrispondente. Il risultato è un elenco di tutti gli insiemi di festività che includano la festività Christmas Day.