Compartilhar via

  • Artigo

Set-CsRgsHolidaySet

 

Tópico modificado em: 2012-03-23

Modifica os valores da propriedade de 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

Set-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 estarã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 algum 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 serem agrupados, os conjuntos de feriados poderão então ser atribuídos a fluxos de trabalho do Grupo de Resposta.

O cmdlet Set-CsRgsHolidaySet permite modificar um conjunto de feriados existente. (na maioria das vezes, isso significa adicionar feriados ou remover feriados do conjunto.) Set-CsRgsHolidaySet não é usado diretamente para fazer alterações a um conjunto de feriados. Em vez disso, cria-se uma referência de objeto a um conjunto de feriados existente, utilizando-se o cmdlet Get-CsRgsHolidaySet. (uma referência de objeto é simplesmente uma variável que, neste caso, se refere a um conjunto de feriados existente.) São feitas alterações ao conjunto na memória e, em seguida, utiliza-se Set-CsRgsHolidaySet para gravar essas alterações no conjunto de feriados real. Se você não chamar Set-CsRgsHolidaySet, as alterações feitas existirão somente na memória e desaparecerão assim que você fechar o Windows PowerShell ou excluir a referência de objeto.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-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 "Set-CsRgsHolidaySet"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Instance

Obrigatório

objeto HolidaySet

Referência de objeto para que o conjunto de feriados do Grupo de Resposta seja modificado. Uma referência de objeto é normalmente recuperada pelo uso do cmdlet Get-CsRgsHolidaySet e pela atribuição do valor retornado a uma variável. Por exemplo: esse comando retorna uma referência de objeto ao grupo de feriados da Assistência Técnica e armazena esta referência de objeto em uma variável denominada $x:

$x = Get-CsRgsHolidaySet -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Assistência Técnica"

Force

Opcional

Parâmetro de opção

Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando.

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

Solicita confirmação antes da execução do comando.

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

Set-CsRgsHolidaySet não retorna qualquer objeto ou valor. Em vez disso, o cmdlet modifica instâncias existentes do objeto Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet.

Exemplo

-------------------------- Exemplo 1 ------------------------

$x = New-CsRgsHoliday -StartDate "12/25/2010" -EndDate "12/26/2010" -Name "Christmas Day"
$y = Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays"
$y.HolidayList.Add($x)
Set-CsRgsHolidaySet -Instance $y

Os comandos mostrados no Exemplo 1 criam um novo feriado (Natal) e o atribuem a um conjunto de feriados existente. Para fazer isso, o primeiro comando no exemplo usa o cmdlet New-CsRgsHoliday, para criar um novo feriado (um feriado "virtual" que existe apenas na memória), que é armazenado na variável $x. New-CsRgsHoliday usa três parâmetros: StartDate, que representa a data de início do feriado (25/12/2010), EndDate, que representa a data de término do feriado (26/12/2010) e Name, que representa o nome exclusivo a ser dado ao feriado.

Após a criação do novo feriado, o segundo comando usa Get-CsRgsHolidaySet para recuperar o conjunto de feriados "Feriados 2010" do serviço ApplicationServer:atl-cs-001.litwareinc.com. Esse conjunto de feriados é armazenado na variável $y.

O Comando 3 usa o método Adicionar para acrescentar o novo feriado ($x) à cópia virtual do conjunto de feriados ($y). O comando final usa então Set-CsRgsHolidaySet para gravar essas alterações (e adicionar o novo feriado) ao serviço ApplicationServer:atl-cs-001.litwareinc.com.

-------------------------- Exemplo 2 ------------------------

$x = Get-CsRgsHolidaySet -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "2010 Holidays"
$y = $x.HolidayList | Where-Object {$_.Name -eq "Christmas Day"}
$x.HolidayList.Remove($y)
Set-CsRgsHolidaySet -Instance $x

Os comandos no Exemplo 2 removem um feriado (neste caso, o Natal) de um conjunto de feriados existente. Para realizar essa tarefa, o primeiro comando no exemplo usa Get-CsRgsHolidaySet, para recuperar o conjunto de feriados Feriados 2010 (-Name "Feriados 2010") do serviço ApplicationServer:atl-cs-001.litwareinc.com. Os dados recuperados são armazenados em uma variável denominada $x.

No segundo comando, a propriedade HolidayList do conjunto de feriados recuperado é canalizada para o cmdlet Where-Object, que seleciona o feriado cuja propriedade name for igual a "Natal". Esse único feriado é armazenado na variável $y.

Após a recuperação do feriado Natal, o comando 3 usa o método Remover, para remover o feriado Natal ($y) do conjunto de feriados ($x). Em seguida, o comando final no exemplo usa Set-CsRgsHolidaySet, para gravar essas alterações (remover o feriado Natal) do conjunto de feriados Feriados 2010, em ApplicationServer:atl-cs-001.litwareinc.com.

-------------------------- Exemplo 3 ------------------------

$x = Get-CsRgsHolidaySet -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "2010 Holidays"
$x.HolidayList.Clear()
Set-CsRgsHolidaySet -Instance $x

Os comandos mostrados no Exemplo 3 excluem todos os feriados do conjunto de feriados Feriados 2010 do serviço ApplicationServer:atl-cs-001.litwareinc.com. Para fazer isso, o primeiro comando no exemplo usa Get-CsRgsHolidaySet, para recuperar o conjunto de feriados apropriado de ApplicationServer:atl-cs-001.litwareinc.com. Esse conjunto de feriados é então armazenado em uma variável denominada $x.

Após a recuperação do conjunto de feriados, o método Limpar é usado para remover todos os valores armazenados na propriedade HolidayList. Após a limpeza dessa propriedade, o comando final no exemplo usa o cmdlet Set-CsRgsHolidaySet, para gravar essas alterações de volta no conjunto de feriados Feriados 2010.