Remove-CsRgsHolidaySet
Tópico modificado em: 2012-03-23
Remove um conjunto de feriados existente do Grupo de Resposta. Um conjunto de feriados do Grupo de Resposta é uma coleção de feriados. Por exemplo: é possível adotar um conjunto de feriados em uma fila de espera nos EUA (um conjunto que pode incluir um feriado em 4 de julho) e um conjunto diferente em uma fila de espera na França. A segunda fila pode definir como feriado o Dia da Bastilha, mas não o 4 de julho.
Sintaxe
Remove-CsRgsHolidaySet -Instance <HolidaySet> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Para proporcionar a melhor experiência possível aos chamadores, o Aplicativo Grupo de Resposta possibilita definir claramente quando os operadores do Grupo de Resposta estão disponíveis ou não para atender às chamadas. Graças ao Aplicativo Grupo de Resposta, é possível definir o horário comercial que indica os dias da semana e os horários do dia em que os operadores estarão disponíveis para atender às chamadas. Por exemplo: se normalmente a sua organização estiver aberta das 09:00 às 17:00, de segunda à sexta-feira, o horário comercial seria configurado de modo a indicar que os operadores estarão disponíveis das 09:00 às 17:00, de segunda à sexta-feira (e, por extensão, que os operadores não estarão disponíveis às 20:00 em uma quinta-feira ou às 14:30 em um domingo, por exemplo).
No entanto, em muitas organizações há exceções à típica semana de trabalho. Por exemplo: nos EUA, uma organização pode estar fechada no Natal ou no Dia de Ação de Graças. Para adaptar-se a esses fechamentos atípicos, o Aplicativo Grupo de Resposta permite designar determinados dias como feriados: dias em que a organização geralmente estaria aberta mas, por qualquer motivo, não está. Cada feriado (criado com o cmdlet New-CsRgsHoliday) é agrupado em conjuntos de feriados. Por exemplo: os feriados nos EUA podem ser agrupados em um conjunto de feriados denominado US_Holidays, enquanto que no Japão, esse conjunto seria denominado Japanese_Holidays. Depois de agrupados, os feriados e conjuntos de feriados podem ser atribuídos a fluxos de trabalho do Grupo de Resposta.
O cmdlet Remove-CsRgsHolidaySet permite que os administradores removam conjuntos de feriados do Grupo de Resposta. Por padrão, se você tentar remover um conjunto de feriados atribuído a um fluxo de trabalho ativo, o cmdlet irá pausar e perguntar se você tem certeza de que deseja excluir o fluxo de trabalho. O comando não continuará e o conjunto de feriados não será removido, até que você responda ao prompt. Para substituir esse prompt e remover um conjunto de feriados, mesmo se este estiver sendo usado por um fluxo de trabalho ativo, adicione o parâmetro Force:
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "Feriados 2010" | Remove-CsRgsHolidaySet –Force
Observe que, quando se chama Remove-CsRgsHolidaySet, todo o conjunto de feriados será removido e não estará mais disponível para uso. Se você deseja remover apenas um único feriado de um grupo de feriados (por exemplo: porque a sua empresa estará aberta no Dia de Ação de Graças), utilize o cmdlet Set-CsRgsHolidaySet, para excluir apenas o feriado especificado.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Remove-CsRgsHolidaySet localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsRgsHolidaySet"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Instance |
Obrigatório |
Objeto de conjunto de feriados |
Referência de objeto que aponta para o conjunto de feriados a ser removido. Ao canalizar objetos de fluxo de trabalho para Remove-CsRgsHolidaySet, é possível omitir o parâmetro Instance. Para usar o parâmetro Instance, use comandos semelhantes a este: $x = Get-CsRgsHolidaySet –Identity ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83 Remove-CsRgsHolidaySet –Instance $x Observe que se pode remover apenas um conjunto de feriados de cada vez quando se usa o parâmetro Instance. Isso significa que a referência de objeto ($x) não pode conter diversos objetos de conjuntos de feriados. |
Force |
Opcional |
Parâmetro de opção |
Força a remoção do conjunto de feriados. Se esse parâmetro estiver presente, o conjunto de feriados será excluído sem aviso, mesmo se for usado por um fluxo de trabalho ativo. Se esse parâmetro não estiver presente, você será solicitado a confirmar a exclusão de qualquer conjunto de feriados atribuído a um fluxo de trabalho ativo. |
WhatIf |
Opcional |
Parâmetro de opção |
Descreve o que aconteceria se o comando fosse executado sem ser executado de fato. |
Confirm |
Opcional |
Parâmetro de opção |
Esse parâmetro tem a finalidade exclusiva de teste. |
Tipos de Entrada
Objeto Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet. Remove-CsRgsHolidaySet aceita instâncias canalizadas do objeto de conjunto de feriados do Grupo de Resposta.
Tipos de Retorno
Remove-CsRgsHolidaySet exclui instâncias existentes do objeto Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet.
Exemplo
-------------------------- Exemplo 1 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays" | Remove-CsRgsHolidaySet
O comando mostrado no Exemplo 1 remove o conjunto de feriados "Feriados 2010" do serviço ApplicationServer:atl-cs-001.litwareinc.com. Para isso, o comando chama primeiramente Get-CsRgsHolidaySet, juntamente com dois parâmetros: o parâmetro Identity (que especifica o local do conjunto de feriados) e o parâmetro Name (que especifica o nome do conjunto). O objeto retornado será então canalizado para Remove-CsRgsHolidaySet, que excluirá o conjunto Feriados 2010.
-------------------------- Exemplo 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
O comando anterior exclui todos os conjuntos de feriados do serviço ApplicationServer:atl-cs-001.litwareinc.com que incluírem o feriado Dia da Confraternização Universal. Para executar essa tarefa, inicialmente o comando usa Get-CsRgsHolidaySet, para retornar uma coleção de todos os conjuntos de feriados localizados no serviço ApplicationServer:atl-cs-001.litwareinc.com. Essa coleção será então canalizada para o cmdlet Select-Object, que efetuará dois procedimentos: 1) seleciona a propriedade Identity de cada conjunto de feriados e 2) "expande" o valor da propriedade HolidayList (quando se expande um valor, retornam-se as propriedades do objeto subjacente. No caso de um feriado, elas incluem propriedades como Name, StartDate e EndDate). As informações selecionadas (a Identidade do conjunto de feriados e os valores de propriedade do feriado) serão então canalizadas para o cmdlet Where-Object, que selecionará os conjuntos que incluírem um feriado cujo Name for igual a (-eq) "Dia da Confraternização Universal". A coleção filtrada de conjuntos de feriados será então canalizada para Remove-CsRgsHolidaySet, que excluirá cada conjunto de feriados que incluir o feriado Dia da Confraternização Universal.
-------------------------- Exemplo 3 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Where-Object {$_.HolidayList.Count -lt 5} | Remove-CsRgsHolidaySet
O comando mostrado no Exemplo 3 exclui qualquer conjunto de feriados do serviço ApplicationServer:atl-cs-001.litwareinc.com que possuir menos de cinco feriados a ele atribuídos. Para isso, inicialmente o comando chama Get-CsRgsHolidaySet, para retornar uma coleção de todos os conjuntos de feriados encontrados em ApplicationServer:atl-cs-001.litwareinc.com. Essa coleção será então canalizada para o cmdlet Where-Object, que selecionará apenas os conjuntos de feriados cujo número de feriados atribuídos ($_.Holidays.Count) for inferior a cinco. Esses conjuntos de feriados serão então canalizados para o cmdlet Remove-CsRgsHolidaySet, que os excluirá.