Compartilhar via

  • Artigo

Set-CsRgsHoursOfBusiness

 

Tópico modificado em: 2012-03-23

Configura um conjunto existente de horários comerciais do Grupo de Resposta. 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

Set-CsRgsHoursOfBusiness -Instance <BusinessHours> [-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).

Os conjuntos de horários comerciais são criados usando-se o cmdlet New-CsRgsHoursOfBusiness. Após a criação desses conjuntos, eles podem ser modificados usando-se o cmdlet Set-CsRgsHoursOfBusiness. Normalmente, isso significará alterar o horário comercial de um ou mais dias da semana. Por exemplo: se a assistência técnica costumava ficar aberta até às 17:00, exceto às sextas-feiras, mas agora fica aberta até às 19:00, será necessário modificar o horário comercial das sextas-feiras. Se a assistência técnica costumava ficar aberta aos sábados, mas agora permanece fechada, também será necessário modificar o horário comercial dos sábados. Para indicar que um grupo não estará disponível em um determinado dia, basta definir o horário comercial daquele dia com um valor nulo: -SundayTimeRange1 $Null.

Ao configurar horários comerciais em um conjunto de horários comerciais, tenha em mente que cada dia da semana possui as propriedades Hours1 e Hours2. Se a assistência técnica ficar aberta das 08:00 às 17:00, será necessário atribuir valores somente à propriedade Hours1 em questão. Entretanto, suponha que a assistência técnica fique aberta das 8:00 às 14:00 e, em seguida abra novamente das 17:00 às 23:00. Nesse caso, você precisa atribuir o intervalo de tempo 8:00 às 14:00 para Hours1 e 17:00 às 23:00 para Hours2.

Observe que Set-CsRgsHoursOfBusiness não modifica diretamente um conjunto de horários comerciais. Em vez disso, utilize Get-CsRgsHoursOfBusiness para criar uma referência de objeto ao conjunto a ser modificado. (quando se cria uma referência de objeto, simplesmente se recupera uma cópia do conjunto de horários comerciais e se armazena essa cópia em uma variável.) Após ter criado uma referência de objeto, você modifica as propriedades deste objeto apenas na memória. Quando as modificações tiverem sido concluídas, utilize Set-CsRgsHoursOfBusiness para gravar as alterações no conjunto de horários comerciais real.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Instance

Obrigatório

objeto BusinessHours

Referência de objeto ao conjunto de horários comerciais a ser modificado. Uma referência de objeto é normalmente recuperada pelo uso do cmdlet Get-CsRgsHoursOfBusiness e pela atribuição do valor retornado a uma variável. Por exemplo: esse comando retorna uma referência de objeto ao conjunto de horários comerciais da Assistência Técnica e armazena esta referência de objeto em uma variável denominada $x:

$x = Get-CsRgsHoursOfBusiness -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

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.BusinessHours. Set-CsRgsHoursOfBusiness aceita instâncias canalizadas do objeto de horários comerciais do Grupo de Resposta.

Tipos de Retorno

Modifica instâncias existentes do objeto Microsoft.Rtc.Rgs.Management.WriteableSettings.BusinessHours.

Exemplo

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

$weekend = New-CsRgsTimeRange -Name "Weekend Hours" -OpenTime "12:00" -CloseTime "17:00"

$x = Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "Help Desk Business Hours"
$x.SaturdayHours1 = $weekend
$x.SundayHours1 = $weekend
Set-CsRgsHoursOfBusiness -Instance $x

O exemplo anterior mostra que se pode atribuir um novo valor de intervalo de tempo para as propriedades SaturdayHours1 e SundayHours1 do conjunto de horários comerciais Horário Comercial da Assistência Técnica. Para fazer isso, o primeiro comando no exemplo utiliza New-CsRgsTimeRange para criar um novo objeto de intervalo de tempo (Horário do Final de Semana) com o horário de abertura 12:00 PM (12:00) e o horário de fechamento 5:00 PM (17:00). Esse objeto é armazenado em uma variável denominada $weekend.

O próximo comando cria uma referência de objeto ($x) ao conjunto de horários comerciais Horário Comercial da Assistência Técnica definido em ApplicationServer:atl-cs-001.litwareinc.com. Quando este comando for encerrado, os comandos 3 e 4 serão usados para definir as propriedades SaturdayHours1 e SundayHours1 com o valor de intervalo de tempo armazenado em $weekend. Finalmente, o último comando no exemplo usa Set-CsRgsHoursOfBusiness, para gravar essas alterações de volta ao conjunto de horários comerciais real.

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

$x = Get-CsRgsHoursOfBusiness -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "Help Desk Business Hours"
$x.SaturdayHours1 = $Null
$x.SaturdayHours2 = $Null

Set-CsRgsHoursOfBusiness -Instance $x

O comando mostrado no Exemplo 2 exclui os valores configurados para as propriedades SaturdayHours1 e SaturdayHours2 no conjunto de horários comerciais Horário Comercial da Assistência Técnica. Para fazer isso, o primeiro comando cria uma referência de objeto ($x) ao conjunto de horários comerciais Horário Comercial da Assistência Técnica definido em ApplicationServer:atl-cs-001.litwareinc.com. Após a criação da referência de objeto, o segundo comando define a propriedade SaturdayHours1 com um valor nulo ($Null). Isso efetivamente apaga qualquer valor anteriormente atribuído a SaturdayHours1. Um comando semelhante a esse é então usado para apagar qualquer valor atribuído anteriormente a SaturdayHours2.

O comando final no exemplo utiliza Set-CsRgsHoursOfBusiness, para gravar essas alterações de volta ao conjunto de horários comerciais real. Quando o comando termina a execução, não haverá mais horários comerciais de Sábado atribuído aos Horários Comerciais da Assistência Técnica.