Compartilhar via

  • Artigo

Get-CsRgsHoursOfBusiness

 

Tópico modificado em: 2012-03-23

Recupera informações sobre os conjuntos de horários comerciais do Grupo de Resposta configurados para uso na organização. Os conjuntos de horários comerciais são usados para indicar os dias da semana e os horários do dia quando os operadores do Grupo de Resposta estão normalmente disponíveis para atender a chamadas telefônicas.

Sintaxe

Get-CsRgsHoursOfBusiness [-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 estão disponíveis ou não para atender às chamadas. Com o 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).

O cmdlet Get-CsRgsHoursOfBusiness permite recuperar informações sobre os conjuntos de horários comerciais configurados para uso na organização.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

Identidade do Rgs

Representa a Identidade do serviço no qual o conjunto de horários comerciais está hospedado ou a Identidade completa do próprio conjunto. Se for especificada a Identidade do serviço (service:ApplicationServer:atl-cs-001.litwareinc.com, por exemplo), serão retornados todos os conjuntos de horários comerciais hospedados nesse serviço. Se você especificar a Identidade do conjunto, será retornado somente o conjunto de horários comerciais especificado. Observe que a Identidade de um conjunto de horários comerciais consiste na Identidade do serviço seguida de um identificador global exclusivo (GUID). Por exemplo: service:ApplicationServer-1/1987d3c2-4544-489d-bbe3-59f79f530a83.

Uma maneira alternativa de retornar um único conjunto de horários comerciais consiste em especificar a Identidade do serviço e, em seguida, incluir o parâmetro Name e o nome do conjunto. Isso permite recuperar um conjunto de horários comerciais, sem a necessidade de conhecer o GUID atribuído àquele conjunto.

Se for chamado sem nenhum parâmetro, o cmdlet Get-CsRgsHoursOfBusiness retornará todos os conjuntos de horários comerciais configurados para uso na organização.

Name

Opcional

Cadeia de caracteres

Nome exclusivo dado ao conjunto de horários comerciais no momento em que foi criado.

Tipos de Entrada

Nenhuma. O cmdlet Get-CsRgsHoursOfBusiness não aceita entradas canalizadas.

Tipos de Retorno

Retorna instâncias do objeto Microsoft.Rtc.Rgs.Management.WritableSettings.BusinessHours.

Exemplo

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

Get-CsRgsHoursOfBusiness

O Exemplo 1 retorna informações sobre todos os conjuntos de horários comerciais configurados para uso na organização. Isso é feito chamando-se Get-CsRgsHoursOfBusiness, sem qualquer parâmetro.

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

Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com"

O comando mostrado no Exemplo 2 retorna todos os conjuntos de horários comerciais configurados para uso em atl-cs-001.litwareinc.com.

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

Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "Help Desk Business Hours"

O comando anterior retorna um único conjunto de horários comerciais de atl-cs-001.litwareinc.com: o conjunto denominado "Horário Comercial da Assistência Técnica".

-------------------------- Exemplo 4 ------------------------

Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Where-Object {$_.SundayTimeRange1 -ne $Null -or $_.SundayTimeRange2 -ne $Null}

O comando anterior retorna todos os conjuntos de horários comerciais que possuírem horários comerciais configurados para domingos. Para isso, o comando primeiramente chama Get-CsRgsHoursOfBusiness, para retornar todos os conjuntos de horários comerciais localizados em atl-cs-001.litwareinc.com. Esses dados serão então canalizados para Where-Object, que selecionará somente os itens nos quais um dos dois critérios seguintes for verdadeiro: a propriedade SundayTimeRange1 não é igual a um valor nulo e/ou a propriedade SundayTimeRange2 não é igual a um valor nulo. Se uma propriedade do intervalo de tempo não for nula, isso significa que o horário comercial foi configurado para esse período de tempo.

-------------------------- Exemplo 5 ------------------------

Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Where-Object {$_.MondayTimeRange1.OpenTime -le "08:00:00"}

O comando mostrado no Exemplo 5 retorna todos os conjuntos de horários comerciais de atl-cs-001.litwareinc.com, nos quais o horário de abertura da propriedade MondayTimeRange1 for igual (ou anterior) a 08:00. Para isso, o comando primeiramente usa Get-CsRgsHoursOfBusiness, para retornar todos os conjuntos de horários comerciais de atl-cs-001.litwareinc.com. Esses dados serão então canalizados para o cmdlet Where-Object, que selecionará apenas os conjuntos cujo valor da propriedade MondayTimeRange1.OpenTime for menor ou igual a 08:00:00.

-------------------------- Exemplo 6 ------------------------

Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Where-Object {$_.Custom -eq $False}

O comando mostrado no Exemplo 6 retorna todos os conjuntos de horários comerciais públicos; ou seja, os conjuntos que podem ser compartilhados entre fluxos de trabalho. Para isso, o comando primeiramente usa Get-CsRgsHoursOfBusiness, para retornar todos os conjuntos de horários comerciais localizados em atl-cs-001.litwareinc.com. Esses dados serão canalizados para o cmdlet Where-Object, que selecionará apenas os conjuntos cuja propriedade Custom é igual a False.