Get-CsRgsHolidaySet
Tópico modificado em: 2012-03-23
Retorna informações sobre os conjuntos de feriados do Grupo de Resposta configurados para uso na organização. 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
Get-CsRgsHolidaySet [-Identity <RgsIdentity>] [-Name <String>]
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 Get-CsRgsHolidaySet permite retornar as informações sobre os conjuntos de feriados do Grupo de Resposta configurados para uso na organização.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Get-CsRgsHolidaySet localmente: RTCUniversalServerAdmins e RTCUniversalReadOnlyAdmins. 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 "Get-CsRgsHolidaySet"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Identity |
Opcional |
Identidade do Rgs |
Representa a Identidade do serviço na qual está hospedado o conjunto de feriados ou a Identidade completa deste. Se você especificar a Identidade do serviço (por exemplo, service:ApplicationServer:atl-cs-001.litwareinc.com), serão retornados todos os conjuntos de feriados hospedados nesse serviço. Se você especificar a Identidade do conjunto de feriados, será retornado somente este conjunto de feriados. Observe que a Identidade de um conjunto de feriados consiste na Identidade do serviço, seguida de um identificador global exclusivo (GUID). Por exemplo: service:ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83. Uma maneira alternativa de retornar um único conjunto de feriados consiste em especificar a Identidade do serviço e, em seguida, incluir o parâmetro Name e o nome do conjunto de feriados. Isso permite recuperar um conjunto de feriados específico, sem ter de conhecer o GUID atribuído àquele conjunto. Se for chamado sem nenhum parâmetro, Get-CsRgsHolidaySet retornará uma coleção de todos os conjuntos de feriados configurados para uso na organização. |
Name |
Opcional |
Cadeia de caracteres |
Nome exclusivo dado ao conjunto de feriados no momento em que o conjunto foi criado. |
Tipos de Entrada
Nenhuma. Get-CsRgsHolidaySet não aceita a entrada canalizada.
Tipos de Retorno
Get-CsRgsHolidaySet retorna instâncias do objeto Microsoft.Rtc.Rgs.Management.WritableSettings.HolidaySet.
Exemplo
-------------------------- Exemplo 1 ------------------------
Get-CsRgsHolidaySet
O comando anterior retorna informações sobre todos os conjuntos de feriados configurados para uso na organização.
-------------------------- Exemplo 2 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com"
O comando mostrado no Exemplo 2 retorna informações sobre todos os conjuntos de feriados configurados para o serviço ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Exemplo 3 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays"
No Exemplo 3, é retornado um único conjunto de feriados do serviço ApplicationServer:atl-cs-001.litwareinc.com: o conjunto com o nome "Feriados 2010". Como os nomes devem ser exclusivos a cada serviço, esse comando nunca poderá retornar mais do que um item.
-------------------------- Exemplo 4 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "2010 Holidays"| Select-Object -ExpandProperty HolidayList
O Exemplo 4 exibe informações detalhadas sobre os feriados encontrados no conjunto de feriados "Feriados 2010" (localizado no serviço ApplicationServer:atl-cs-001.litwareinc.com). Para fazer isso, o comando usa primeiramente Get-CsRgsHolidaySet, para recuperar o conjunto de feriados especificado. Esse conjunto será então passado para o cmdlet Select-Object, que usará o parâmetro ExpandProperty, para mostrar informações detalhadas sobre cada feriado no conjunto.
-------------------------- Exemplo 5 ------------------------
Get-CsRgsHolidaySet -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Select-Object Identity -ExpandProperty HolidayList | Where-Object {$_.Name -eq "Christmas Day"} | ForEach-Object {Get-CsRgsHolidaySet -Identity $_.Identity}
O comando exibido no Exemplo 5 relata a Identidade de cada conjunto de feriados em ApplicationServer:atl-cs-001.litwareinc.com, que inclui um feriado denominado Natal. 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 Select-Object, que efetuará dois procedimentos: ele seleciona a propriedade Identity e expande a propriedade HolidayList.
Essas duas informações – Identity e o valor expandido da propriedade HolidayList – serão canalizadas para o cmdlet Where-Object; por sua vez, Where-Object selecionará os itens cujo nome do feriado for igual a Natal. Finalmente, a coleção filtrada será canalizada para o cmdlet ForEach-Object. Esse cmdlet seleciona cada Identidade na coleção, utilizando Get-CsRgsHolidaySet, para recuperar o conjunto de feriados correspondente. O resultado é uma lista de todos os conjuntos de feriados que incluem o feriado Natal.