Condividi tramite

  • Articolo

New-CsRgsHolidaySet

 

Ultima modifica dell'argomento: 2012-03-23

Crea un nuovo insieme di festività di Response Group. 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

New-CsRgsHolidaySet -Parent <RgsIdentity> -HolidayList <Collection> -Name <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

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 chiusure atipiche, l'applicazione Response Group consente di designare come festività determinati giorni, ovvero giorni in cui l'organizzazione è di solito aperta ma, 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. Dopo essere state raccolte, le festività e gli insiemi corrispondenti possono quindi essere assegnati ai flussi di lavoro di Response Group.

Il cmdlet New-CsRgsHolidaySet consente di configurare nuovi insiemi di festività da utilizzare nell'organizzazione. Quando si crea un nuovo insieme di festività, è necessario includere almeno una festività. Tali singole festività devono essere create utilizzando il cmdlet New-CsRgsHoliday.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet New-CsRgsHolidaySet i membri dei seguenti gruppi: RTCUniversalServerAdmins. 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 "New-CsRgsHolidaySet"}

Parametri

Parametro Obbligatorio Tipo Descrizione

HolidayList

Obbligatorio

Raccolta di oggetti festività

Una o più festività da aggiungere all'insieme di festività. Le festività devono essere create utilizzando il cmdlet New-CsRgsHoliday e quindi archiviate in un riferimento oggetto. Questi riferimenti oggetto vengono quindi passati al parametro Holidays per aggiungere le festività al relativo insieme. Ad esempio, questo comando crea una festività denominata New Year's Day e quindi memorizza il valore risultante in un riferimento oggetto denominato $x:

$x = New-CsRgsHoliday -StartDate "1/1/2011 12:00 AM" -EndDate "1/2/2011 12:00 AM" -Name "New Year's Day"

Si noti che il formato utilizzato per specificare le date e le ore dipenderà dalle impostazioni internazionali e della lingua in uso. Per gli esempi mostrati in questo argomento viene utilizzato il formato dell'inglese americano.

Name

Obbligatorio

Stringa

Nome univoco da assegnare all'insieme di festività. La combinazione della proprietà Parent e della proprietà Name consente di identificare in modo univoco gli insiemi di festività senza dover fare riferimento al relativo identificatore univoco globale (GUID).

Parent

Obbligatorio

Identità Rgs

Il servizio in cui sarà ospitato il nuovo insieme di festività. Ad esempio: -Parent "service:ApplicationServer:atl-cs-001.litwareinc.com".

InMemory

Facoltativo

Parametro opzionale

Crea un riferimento a un oggetto senza eseguire realmente il commit dell'oggetto come modifica permanente. Se si assegna l'output del cmdlet chiamato con questo parametro a una variabile, è possibile apportare modifiche alle proprietà del riferimento all'oggetto e quindi eseguire il commit di queste modifiche chiamando il cmdlet Set- corrispondente.

Force

Facoltativo

Parametro opzionale

Consente di non visualizzare i messaggi relativi agli errori non irreversibili che possono verificarsi durante l'esecuzione del comando.

Tipi di input

Nessuno. New-CsRgsHolidaySet non accetta l'input da pipeline.

Tipi restituiti

New-CsRgsHolidaySet crea nuove istanze dell'oggetto Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet.

Esempio

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

$x = New-CsRgsHoliday -StartDate "1/1/2011 12:00 AM" -EndDate "1/2/2011 12:00 AM" -Name "New Year's Day"
New-CsRgsHolidaySet -Parent "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2011 Holidays" -HolidayList($x)

I comandi mostrati nell'esempio 1 creano un nuovo insieme di festività denominato 2011 Holidays (per le festività del 2011) e quindi assegnano a tale insieme una nuova festività (New Year's Day, ovvero il primo dell'anno). A tale scopo, nel primo comando viene utilizzato New-CsRgsHoliday per creare una festività relativa al primo dell'anno (New Year's Day). New-CsRgsHoliday accetta tre parametri: StartDate che indica la data di inizio della festività (1/1/2011 12:00 AM), EndDate che rappresenta la data di fine della festività (1/2/2011 12:00 AM) e Name che viene utilizzato per archiviare il nome assegnato alla festività. L'oggetto festività risultante viene archiviato nella variabile $j.

Dopo che la nuova festività è stata creata in memoria, viene utilizzato New-CsRgsHolidaySet per creare un nuovo insieme di festività nel servizio ApplicationServer:atl-cs-001.litwareinc.com. All'insieme di festività viene conferito il nome 2011 Holidays (-Name "2011 Holidays") e viene assegnata la festività archiviata nella variabile $x: -HolidayList ($x). Se si desidera assegnare più festività all'insieme di festività, occorre creare nuove festività e assegnare ciascuna di queste a una variabile univoca. È quindi possibile includere tutti questi i nomi di variabili come valore del parametro passato a HolidayList:

-HolidayList($x, $y, $z)