Compartilhar via

  • Artigo

New-CsRgsHolidaySet

 

Tópico modificado em: 2012-03-23

Cria um novo conjunto de feriados 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

New-CsRgsHolidaySet -Parent <RgsIdentity> -HolidayList <Collection> -Name <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <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 seus respectivos conjuntos de feriados podem ser atribuídos a fluxos de trabalho do Grupo de Resposta.

O cmdlet New-CsRgsHolidaySet permite configurar novos conjuntos de feriados para uso na sua organização. Observe que, quando se cria um novo conjunto de feriados, deve ser incluído no mínimo um feriado. Cada feriado deve ser criado usando-se o cmdlet New-CsRgsHoliday.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

HolidayList

Obrigatório

Coleção de objetos de feriado

Um ou mais feriados a serem acrescentados ao conjunto de feriados. Os feriados devem ser criados usando-se o cmdlet New-CsRgsHoliday e, em seguida, armazenados em uma referência de objeto. Em seguida, essas referências de objetos são passadas ao parâmetro Holidays, para acrescentar os feriados ao conjunto de feriados. Por exemplo: esse comando cria um feriado denominado Dia da Confraternização Universal e armazena o valor resultante em uma referência do objeto denominada $x:

$x = New-CsRgsHoliday -StartDate "1/1/2011 12:00 AM" -EndDate "1/2/2011 12:00 AM" -Name "Dia da Confraternização Universal"

Observe que o formato usado para especificar datas e horários dependerá das suas opções Regionais e de Idioma. Os exemplos mostrados neste tópico utilizam o inglês dos EUA.

Name

Obrigatório

Cadeia de caracteres

Nome único a ser atribuído ao conjunto de feriados. A combinação entre as propriedades Parent e Name permite identificar de forma exclusiva os conjuntos de feriados, sem ter de consultar o identificador global exclusivo (GUID) do conjunto.

Parent

Obrigatório

Identidade do Rgs

Serviço onde o novo conjunto de feriados será hospedado. Por exemplo: -Parent "service:ApplicationServer:atl-cs-001.litwareinc.com".

InMemory

Opcional

Parâmetro de opção

Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet.

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.

Tipos de Entrada

Nenhuma. New-CsRgsHolidaySet não aceita entradas canalizadas.

Tipos de Retorno

New-CsRgsHolidaySet cria novas instâncias do objeto Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet.

Exemplo

-------------------------- Exemplo 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)

Os comandos mostrados no Exemplo 1 criam um novo conjunto de feriados denominado Feriados 2011 e atribuem um novo feriado a esse conjunto de feriados (Dia da Confraternização Universal). Para realizar essa tarefa, o primeiro comando usa New-CsRgsHoliday para criar um feriado para o Dia da Confraternização Universal. New-CsRgsHoliday admite três parâmetros: StartDate, que indica a data de início do feriado (1/1/2011 0:00), EndDate, que representa a data de término do feriado (2/1/2011 00:00) e Name, usado para armazenar o nome atribuído ao feriado. O objeto de feriado resultante será armazenado na variável $x.

Depois que o novo feriado tiver sido criado na memória, New-CsRgsHolidaySet será empregado para criar um novo conjunto de feriados no serviço ApplicationServer:atl-cs-001.litwareinc.com. Esse conjunto de feriados receberá o nome de Feriados 2011 (-Name "Feriados 2011") e o feriado armazenado na variável $x será atribuído a ele: -HolidayList ($x). Se você desejar atribuir vários feriados ao conjunto de feriados, basta criar os novos feriados, atribuindo cada um deles a uma variável exclusiva. Você poderá então incluir todos os nomes de variáveis como valor do parâmetro passado para HolidayList:

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