New-CsRgsHoliday
Tópico modificado em: 2012-03-23
Cria um novo feriado do Grupo de Resposta. No Aplicativo Grupo de Resposta, um feriado representa um dia em que os operadores atribuídos a uma fila de espera, que normalmente estariam trabalhando naquele dia, não estarão trabalhando e não estarão disponíveis para atender a chamadas. Por exemplo: se os operadores com base nos EUA receberem folga no Dia de Ação de Graças, seria configurado um feriado em 24 de novembro de 2011.
Sintaxe
New-CsRgsHoliday -EndDate <Nullable> -StartDate <Nullable> [-Name <String>]
Descrição Detalhada
O Aplicativo Grupo de Resposta usa conjuntos de horários comerciais para indicar os dias da semana e os horários do dia nos quais os operadores estão normalmente disponíveis para atender a chamadas telefônicas. Por exemplo, suponha que, geralmente, a assistência técnica esteja provida de pessoal das 7:00 às 19:00 todas as segundas-feiras. Nesse caso, você criaria um conjunto de horários comerciais para a assistência técnica e configuraria a hora de abertura como sendo 07:00 e a hora de fechamento como sendo 19:00 em uma segunda-feira típica.
Entretanto, pode haver exceções à regra que diz que a assistência técnica é provida de pessoal todas as segundas-feiras das 07:00 às 19:00. Por exemplo, nos EUA, o dia 4 de julho é um feriado; consequentemente, a equipe de assistência técnica pode não estar disponível neste dia. Para justificar o fato de que a assistência técnica não estará funcionando na segunda-feira, 4 de julho de 2011, é necessário criar um feriado nesta data e adicioná-lo ao conjunto de feriados da assistência técnica.
Para criar um feriado, é preciso usar o cmdlet New-CsRgsHoliday. (observe que um "feriado" não precisa envolver algum tipo de celebração ou festividade; em vez disso, um feriado é simplesmente um dia em que os operadores não estarão disponíveis para atender o telefone.) New-CsRgsHoliday não adiciona diretamente um feriado a um conjunto de feriados. Em vez disso, o cmdlet cria um novo feriado que existe apenas na memória. Por isso, é necessário criar uma referência de objeto (como $x) que aponte para essa instância da memória. Após a criação do feriado na memória, utilize o cmdlet Get-CsRgsHolidaySet, para recuperar o conjunto relevante de feriados, e o cmdlet Set-CsRgsHolidaySet, para acrescentar o novo feriado àquele conjunto.
Embora um conjunto de feriados possa conter (e normalmente contém) vários feriados, esses feriados devem ser adicionados ao conjunto um de cada vez.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet New-CsRgsHoliday localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins e RTCUniversalReadOnlyAdmins. No entanto, como esse cmdlet cria um objeto na memória e, isoladamente, não faz alterações ao sistema, ele pode ser executado por qualquer pessoa. 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-CsRgsHoliday\b"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Name |
Obrigatório |
Cadeia de caracteres |
Nome exclusivo usado para diferenciar o feriado de outros feriados. |
EndDate |
Obrigatório |
DataHora |
Data de término do feriado. O formato da data de término dependerá de Opções Regionais e de Idioma. Por exemplo: nos EUA a data de término do feriado de 4 de julho de 2011 seria formatada desta forma: -EndDate "7/5/2011 12:00 AM", indicando que o feriado termina à 0:00 de 5 de julho de 2011. |
StartDate |
Obrigatório |
DataHora |
Data de início do feriado. O formato da data de início dependerá de Opções Regionais e de Idioma. Por exemplo: nos EUA, a data de início do feriado de 4 de julho de 2011 seria formatada desta forma: -StartDate "7/4/2011 12:00 AM", indicando que o feriado começa à 0:00 de 4 de julho de 2011. |
Tipos de Entrada
Nenhuma. New-CsRgsHoliday não aceita a entrada canalizada.
Tipos de Retorno
New-CsRgsHoliday cria novas instâncias do objeto Microsoft.Rtc.Rgs.Management.WritableSettings.Holiday.
Exemplo
-------------------------- Exemplo 1 ------------------------
$christmasDay = New-CsRgsHoliday -StartDate "12/25/2010 12:00 AM" -EndDate "12/26/2010 12:00 AM" -Name "Christmas Day"
$y = Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays"
$y.HolidayList.Add($christmasDay)
Set-CsRgsHolidaySet -Instance $y
Os comandos exibidos no Exemplo 1 mostram como você pode criar um novo feriado (Christmas Day) e atribuir este feriado 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 e é armazenado na variável $christmasDay. New-CsRgsHoliday usa três parâmetros: StartDate, que representa a data de início do feriado (25/12/2010 0:00), EndDate, que representa a data de término do feriado (26/12/2010 00:00) 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 "2010 Holidays" 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 ($christmasDay) à cópia virtual do conjunto de feriados ($y). O comando final chama então Set-CsRgsHolidaySet, para gravar as alterações (ou seja, para adicionar o novo feriado) ao serviço ApplicationServer:atl-cs-001.litwareinc.com.