Compartilhar via

  • Artigo

Remove-CsRgsHoursOfBusiness

 

Tópico modificado em: 2012-03-23

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

Remove-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).

É possível criar novos conjuntos de horários comerciais usando-se o cmdlet New-CsRgsHoursOfBusiness; esses conjuntos podem ser removidos posteriormente usando-se o cmdlet Remove-CsRgsHoursOfBusiness. Observe que, quando se chama Remove-CsRgsHoursOfBusiness, todo o conjunto de horários será removido e não estará mais disponível para uso. Se tudo o que você desejar fazer é remover o horário comercial correspondente a um determinado dia (por exemplo: porque a assistência técnica não está mais aberta aos domingos), deve usar Set-CsRgsHoursOfBusiness para remover somente os valores relevantes de uma coleção.

Por padrão, Remove-CsRgsHoursOfBusiness faz uma solicitação caso você tente excluir um conjunto de horários comerciais em uso por um fluxo de trabalho ativo. Essa solicitação pede a sua confirmação da intenção de remover o conjunto. Nenhuma ação será executada enquanto você não responder à solicitação. Para ignorar essa solicitação e excluir silenciosamente conjuntos de horários comerciais, mesmo se estes conjuntos estiverem atribuídos a um fluxo de trabalho ativo, adicione o parâmetro Force. Por exemplo:

Get-CsRgsHoursOfBusiness –Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" | Remove-CsRgsHoursOfBusiness –Force

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Instance

Obrigatório

Objeto de horário comercial

Referência de objeto que aponta para o horário comercial a ser removido. Ao canalizar objetos de fluxo de trabalho para Remove-CsRgsHoursOfBusiness, é possível omitir o parâmetro Instance.

Para usar o parâmetro Instance, use comandos semelhantes a este:

$x = Get-CsRgsHoursOfBusiness –Identity ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83

Remove-CsRgsHoursOfBusiness –Instance $x

Observe que se pode remover apenas um horário comercial de cada vez quando se usa o parâmetro Instance. Isso significa que a referência de objeto ($x) não pode conter diversos objetos de horários comerciais.

Force

Opcional

Parâmetro de opção

Força a exclusão de um conjunto de horários comerciais. Se esse parâmetro estiver presente, o conjunto será excluído sem aviso, mesmo se estiver atribuído atualmente a um fluxo de trabalho ativo. Se esse parâmetro não estiver presente, você será solicitado a confirmar a exclusão de qualquer conjunto de horários comerciais que estiver atribuído a um fluxo de trabalho ativo.

WhatIf

Opcional

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

Tipos de Retorno

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

Exemplo

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

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

O comando mostrado no Exemplo 1 remove todos os conjuntos de horários comerciais localizados no serviço ApplicationServer:atl-cs-001.litwareinc.com. Para fazer isso, o comando chama primeiramente Get-CsRgsHoursOfBusiness, para retornar todos os conjuntos de horários comerciais localizados no serviço ApplicationServer:atl-cs-001.litwareinc.com. Esses conjuntos serão então canalizados para o cmdlet Remove-CsRgsHoursOfBusiness, que excluirá cada conjunto de horários comerciais que lhe for passado.

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

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

No Exemplo 2, um único conjunto de horários comerciais é removido de ApplicationServer:atl-cs-001.litwareinc.com: o conjunto denominado Help Desk Business Hours.

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

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

O comando anterior exclui todos os conjuntos de horários comerciais que possuírem horários comerciais configurados para domingos. Para fazer isso, o comando chama primeiramente Get-CsRgsHoursOfBusiness, para retornar todos os conjuntos de horários comerciais localizados em ApplicationServer:atl-cs-001.litwareinc.com. Esses conjuntos serão então canalizados para o cmdlet Where-Object, que selecionará somente os itens nos quais um dos seguintes critérios for verdadeiro: a propriedade SundayTimeRange1 não é igual a um valor nulo 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 aquele intervalo de tempo). Qualquer conjunto atendendo a pelo menos um desses critérios será então canalizado para o cmdlet Remove-CsRgsHoursOfBusiness, que removerá esse conjunto de horários comerciais.

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

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

O comando mostrado no Exemplo 4 exclui todos os conjuntos personalizados de horários comerciais (ou seja, os conjuntos que não podem ser compartilhados entre fluxos de trabalho). Para executar essa tarefa, o comando chama primeiramente Get-CsRgsHoursOfBusiness, para retornar todos os conjuntos de horários comerciais localizados em ApplicationServer:atl-cs-001.litwareinc.com. Esses dados serão canalizados para o cmdlet Where-Object, que selecionará apenas os conjuntos cuja propriedade Custom for igual a True. Esses conjuntos serão então canalizados para Remove-CsRgsHoursOfBusiness, que os excluirá.