Remove-CsRgsWorkflow
Tópico modificado em: 2012-03-23
Exclui o fluxo de trabalho de um Grupo de Resposta existente. Os fluxos de trabalho determinam as ações que serão executadas quando o Aplicativo Grupo de Resposta receber uma chamada telefônica.
Sintaxe
Remove-CsRgsWorkflow -Instance <Workflow> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Os fluxos de trabalho são um elemento-chave no Aplicativo Grupo de Resposta. Cada fluxo de trabalho é associado de forma exclusiva a um número de telefone; quando alguém chama este número, o fluxo de trabalho determina como a chamada será tratada. Por exemplo: a chamada pode ser roteada para uma série de perguntas de resposta interativa de voz (IVR), que solicitam a inserção, pelo chamador, de informações adicionais ("Pressione 1 para suporte de hardware. Pressione 2 para suporte de software.") Como alternativa, a chamada pode ser colocada em uma fila de espera e o chamador, colocado em espera, até que um operador esteja disponível para atender à chamada. A disponibilidade dos operadores para atender chamadas também é determinada pelo fluxo de trabalho: os fluxos de trabalho são usados para manter o horário comercial (os dias da semana e os horários do dia em que os operadores estão disponíveis para atender às chamadas) e os feriados (dias em que não há operadores disponíveis para atender às chamadas).
O cmdlet New-CsRgsWorkflow permite criar novos fluxos de trabalho. Após a criação desses fluxos de trabalho, eles poderão ser excluídos usando-se Remove-CsRgsWorkflow. Observe que, ao se excluir um fluxo de trabalho, ele será completamente removido do Aplicativo Grupo de Resposta. Se desejar desabilitar temporariamente um fluxo de trabalho, não use Remove-CsRgsWorkflow; em vez disso, use o cmdlet Set-CsRgsWorkflow para desabilitar (e, posteriormente, reabilitar) o fluxo de trabalho.
Se tentar excluir um fluxo de trabalho ativo, Remove-CsRgsWorkflow solicitará que você verifique se realmente deseja excluir esse fluxo de trabalho. Remove-CsRgsWorkflow não executará qualquer ação até que você responda à solicitação. Para ignorar essa solicitação e excluir silenciosamente um fluxo de trabalho ativo, use o parâmetro Force. Por exemplo:
Get-CsRgsWorkflow –Identity "service:ApplicationServer:atl-cs-001.litwareinc.com " | Remove-CsRgsWorkflow –Force
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Remove-CsRgsWorkflow 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-CsRgsWorkflow"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Instance |
Opcional |
objeto Fluxo de trabalho |
Referência de objeto que aponta para o fluxo de trabalho a ser removido. Ao canalizar objetos de fluxo de trabalho para Remove-CsRgsWorkflow, é possível omitir o parâmetro Instance. Para usar o parâmetro Instance, utilize comandos semelhantes a esse: $x = Get-CsRgsWorkflow –Identity ApplicationServer:atl-cs-001.litwareinc.com /1987d3c2-4544-489d-bbe3-59f79f530a83 Remove-CsRgsWorkflow –Instance $x Observe que se pode remover apenas um fluxo de trabalho 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 fluxos de trabalho. |
Force |
Opcional |
Parâmetro de opção |
Força a remoção do fluxo de trabalho. Se esse parâmetro estiver presente, o fluxo de trabalho será excluído sem aviso, mesmo se estiver ativo. Se esse parâmetro não estiver presente, você será solicitado a confirmar a exclusão de qualquer 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.Workflow. O Remove-CsRgsWorkflow aceita instâncias pipelined do objeto de fluxo de trabalho do Grupo de Resposta.
Tipos de Retorno
Remove-CsRgsWorkflow exclui instâncias existentes do objeto Microsoft.Rtc.Rgs.Management.WritableSettings.Workflow.
Exemplo
-------------------------- Exemplo 1 ------------------------
Get-CsRgsWorkflow -Identity Service:ApplicationServer:atl-cs-001.litwareinc.com | Remove-CsRgsWorkflow
O Exemplo 1 remove todos os fluxos de trabalho do Grupo de Resposta do serviço ApplicationServer:atl-cs-001.litwareinc.com. Para fazer isso, o comando inicialmente chama Get-CsRgsWorkflow, para retornar uma coleção de todos os fluxos de trabalho localizados em ApplicationServer:atl-cs-001.litwareinc.com. Essa coleção será então canalizada para Remove-CsRgsWorkflow, que excluirá cada fluxo de trabalho na coleção.
-------------------------- Exemplo 2 ------------------------
Get-CsRgsWorkflow service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk Workflow" | Remove-CsRgsWorkflow
O comando mostrado no Exemplo 2 exclui um único fluxo de trabalho do Grupo de Resposta: o fluxo de trabalho denominado "Fluxo de Trabalho da Assistência Técnica", localizado no serviço ApplicationServer:atl-cs-001.litwareinc.com. Para isso, Get-CsRgsWorkflow é usado inicialmente para retornar o fluxo de trabalho denominado Fluxo de Trabalho da Assistência Técnica do serviço ApplicationServer:atl-cs-001.litwareinc.com. Esse fluxo de trabalho será então canalizado para Remove-CsRgsWorkflow, que o excluirá.
-------------------------- Exemplo 3 ------------------------
Get-CsRgsWorkflow service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.Language -eq "en-us"} | Remove-CsRgsWorkflow
O comando anterior exclui todos os fluxos de trabalho que estiverem no idioma inglês dos Estados Unidos do serviço ApplicationServer:atl-cs-001.litwareinc.com. Para fazer isso, utiliza-se inicialmente Get-CsRgsWorkflow, para recuperar todos os fluxos de trabalho localizados em ApplicationServer:atl-cs-001.litwareinc.com. Esse conjunto será então canalizado para o cmdlet Where-Object, que selecionará apenas os fluxos de trabalho cujo idioma for igual a Inglês dos Estados Unidos (en-us). Esta coleção filtrada será então canalizada para o cmdlet Remove-CsRgsWorkflow, que excluirá cada item nessa coleção.
-------------------------- Exemplo 4 ------------------------
Get-CsRgsWorkflow service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.CustomMusicOnHoldFile -ne $Null} | Remove-CsRgsWorkflow
O comando mostrado no Exemplo 4 exclui todos os fluxos de trabalho do Grupo de Resposta do serviço ApplicationServer:atl-cs-001.litwareinc.com que possuírem um valor configurado para a propriedade CustomMusicOnHoldFile. Para realizar isso, o comando inicialmente usa Get-CsRgsWorkflow, para retornar uma coleção de todos os fluxos de trabalho localizados em ApplicationServer:atl-cs-001.litwareinc.com. Esta coleção será então canalizada para o cmdlet Where-Object, que selecionará apenas os fluxos de trabalho cuja propriedade CustomMusicOnHoldFile não for igual a um valor nulo. (se a propriedade não for igual a um valor nulo, isso significa que uma música personalizada foi definida para esse fluxo de trabalho.) Esta coleção filtrada será então canalizada para Remove-CsRgsWorkflow, que removerá cada item na coleção.