Remove-CsRgsHolidaySet
Ultima modifica dell'argomento: 2012-03-23
Rimuove un insieme di festività di Response Group esistente. 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
Remove-CsRgsHolidaySet -Instance <HolidaySet> [-Confirm [<SwitchParameter>]] [-Force <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 tali 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 i relativi insiemi possono essere assegnati ai flussi di lavoro di Response Group.
Il cmdlet Remove-CsRgsHolidaySet consente agli amministratori di rimuovere insiemi di festività di Response Group. Per impostazione predefinita, se si tenta di rimuovere un insieme di festività attualmente assegnato a un flusso di lavoro attivo, il cmdlet sospenderà l'operazione e chiederà se si è certi di voler eliminare il flusso di lavoro. Il comando non proseguirà e l'insieme di festività non verrà rimosso finché non si risponde al prompt. Per non visualizzare il prompt e rimuovere un insieme di festività anche se al momento è utilizzato da un flusso di lavoro attivo, aggiungere il parametro Force:
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "Festività 2010" | Remove-CsRgsHolidaySet –Force
Si noti che, quando si chiama Remove-CsRgsHolidaySet, viene rimosso e non è più disponibile per l'utilizzo l'intero insieme di festività. Se si desidera semplicemente rimuovere una singola festività da un insieme di festività, ad esempio perché alla fine la propria azienda ha deciso di restare aperta il Giorno del ringraziamento, utilizzare Set-CsRgsHolidaySet per rimuovere solo la festività specificata.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Remove-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 "Remove-CsRgsHolidaySet"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Instance |
Obbligatorio |
Oggetto insieme di festività |
Riferimento all'oggetto che punta all'insieme di festività da rimuovere. Quando gli oggetti flusso di lavoro vengono inviati tramite pipe a Remove-CsRgsHolidaySet, è possibile omettere il parametro Instance. Per utilizzare il parametro Instance, sono necessari comandi analoghi al seguente: $x = Get-CsRgsHolidaySet –Identity ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83 Remove-CsRgsHolidaySet –Instance $x Si noti che è possibile rimuovere un solo insieme di festività alla volta quando si utilizza il parametro Instance. Ciò significa che il riferimento all'oggetto ($x) non può contenere più oggetti insieme di festività. |
Force |
Facoltativo |
Parametro opzionale |
Forza la rimozione dell'insieme di festività. Se questo parametro è presente, l'insieme di festività sarà eliminato senza avviso, anche se è utilizzato da un flusso di lavoro attivo. Se questo parametro non è presente, verrà richiesto di confermare l'eliminazione di ogni insieme di festività attualmente assegnato a un flusso di lavoro attivo. |
WhatIf |
Facoltativo |
Parametro opzionale |
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente. |
Confirm |
Facoltativo |
Parametro opzionale |
Questo parametro è utilizzato solo a scopo di test. |
Tipi di input
Oggetto Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet. Remove-CsRgsHolidaySet accetta le istanze da pipeline dell'oggetto insieme di festività di Response Group.
Tipi restituiti
Remove-CsRgsHolidaySet elimina le istanze esistenti dell'oggetto Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet.
Esempio
-------------------------- Esempio 1 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays" | Remove-CsRgsHolidaySet
Il comando mostrato nell'esempio 1 rimuove l'insieme di festività "2010 Holidays" dal servizio ApplicationServer:atl-cs-001.litwareinc.com. A tale scopo, nel comando viene innanzitutto chiamato Get-CsRgsHolidaySet con due parametri: il parametro Identity che specifica la posizione dell'insieme di festività e il parametro Name che specifica il nome dell'insieme. L'oggetto restituito viene quindi inviato tramite pipe a Remove-CsRgsHolidaySet, che elimina l'insieme di festività 2010 Holidays.
-------------------------- Esempio 2 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Select-Object Identity -ExpandProperty HolidayList | Where-Object {$_.Name -eq "New Year's Day"} | Remove-CsRgsHolidaySet
Il comando precedente elimina tutti gli insiemi di festività nel servizio ApplicationServer:atl-cs-001.litwareinc.com che includono la festività del New Year's Day. A tale scopo, nel comando viene innanzitutto utilizzato Get-CsRgsHolidaySet per restituire una raccolta di tutti gli insiemi di festività trovati nel servizio ApplicationServer:atl-cs-001.litwareinc.com. Questa raccolta viene quindi inviata tramite pipe al cmdlet Select-Object, che esegue due operazioni: 1) seleziona la proprietà Identity per ciascun insieme di festività e 2) espande il valore della proprietà HolidayList. Quando si espande un valore, vengono restituite le proprietà dell'oggetto sottostante. Nel caso di una festività, si tratta di proprietà come Name, StartDate ed EndDate. Le informazioni selezionate (l'identità degli insiemi di festività e i valori delle proprietà delle festività) vengono quindi inviate tramite pipe al cmdlet Where-Object, che seleziona gli insiemi che includono una festività il cui nome è uguale a (-eq) "New Year's Day". La raccolta filtrata di insiemi di festività viene quindi inviata tramite pipe a Remove-CsRgsHolidaySet, che elimina ogni insieme di festività che include la festività New Year's Day.
-------------------------- Esempio 3 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Where-Object {$_.HolidayList.Count -lt 5} | Remove-CsRgsHolidaySet
Il comando mostrato nell'esempio 3 elimina dal servizio ApplicationServer:atl-cs-001.litwareinc.com tutti gli insiemi di festività a cui sono state assegnate meno di 5 festività. 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. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo gli insiemi di festività in cui il numero di festività assegnate ($_.Holidays.Count) è minore di 5. Tali insiemi di festività vengono quindi inviati tramite pipe al cmdlet Remove-CsRgsHolidaySet, che li elimina.