Get-CsRgsWorkflow
Tópico modificado em: 2012-03-23
Retorna informações sobre os fluxos de trabalho do Grupo de Resposta. Os fluxos de trabalho determinam as ações que serão executadas quando o Aplicativo Grupo de Resposta receber uma chamada telefônica.
Sintaxe
Get-CsRgsWorkflow [-Identity <RgsIdentity>] [-Name <String>]
Descrição Detalhada
Os fluxos de trabalho são, talvez, o principal elemento no Aplicativo Grupo de Resposta. Cada fluxo de trabalho é associado de forma exclusiva a um número de telefone; quando alguém chamar aquele número, o fluxo de trabalho determinará 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 a chamada. A disponibilidade dos operadores para atender chamadas também é determinada pelo fluxo de trabalho: os fluxos de trabalho são usados para configurar o horário comercial (os dias da semana e os horários do dia em que os operadores estão disponíveis para atender chamadas) e feriados (dias em que não há operadores disponíveis para atender chamadas).
O cmdlet Get-CsRgsWorkflow permite retornar informações sobre os fluxos de trabalho 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-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 "Get-CsRgsWorkflow"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
Identidade do Rgs |
Representa a Identidade do serviço onde o fluxo de trabalho do Grupo de Resposta está hospedado ou a Identidade completa do próprio fluxo de trabalho. Se você especificar a Identidade do serviço (por exemplo, service: ApplicationServer:atl-cs-001.litwareinc.com), serão retornados todos os fluxos de trabalho do Grupo de Resposta hospedados naquele serviço. Se você especificar a Identidade do fluxo de trabalho, será retornado somente este fluxo de trabalho do Grupo de Resposta. Observe que a Identidade de um fluxo de trabalho 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 fluxo de trabalho do Grupo de Resposta consiste em especificar a Identidade do serviço e, em seguida, incluir o parâmetro Name, seguido do nome do fluxo de trabalho. Isso permite recuperar um fluxo de trabalho específico, sem ter de conhecer o GUID atribuído àquele fluxo de trabalho. Se for chamado sem nenhum parâmetro, Get-CsRgsWorkflow retornará um conjunto de todos os fluxos de trabalho configurados para uso na organização. |
Name |
Opcional |
Cadeia de caracteres |
Nome exclusivo dado ao fluxo de trabalho do Grupo de Resposta no momento em que foi criado. |
Tipos de Entrada
Nenhuma. Get-CsRgsWorkflow não aceita a entrada canalizada.
Tipos de Retorno
Get-CsRgsWorkflow retorna instâncias do objeto Microsoft.Rtc.Rgs.Management.WritableSettings.Workflow.
Exemplo
-------------------------- Exemplo 1 ------------------------
Get-CsRgsWorkflow
O exemplo anterior retorna informações sobre todos os fluxos de trabalho configurados para uso na organização. Isto é feito chamando-se Get-CsRgsWorkflow sem qualquer parâmetro.
-------------------------- Exemplo 2 ------------------------
Get-CsRgsWorkflow -Identity service:ApplicationServer:atl-cs-001.litwareinc.com
O Exemplo 2 retorna informações sobre todos os fluxos de trabalho do Aplicativo Grupo de Resposta localizados no serviço ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Exemplo 3 ------------------------
Get-CsRgsWorkflow -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Select-Object -ExpandProperty DefaultAction
O comando mostrado no Exemplo 3 exibe informações detalhadas sobre a propriedade DefaultAction de cada fluxo de trabalho do Grupo de Resposta localizado no serviço ApplicationServer:atl-cs-001.litwareinc.com. Para executar essa tarefa, utiliza-se inicialmente Get-CsRgsWorkflow, para retornar informações sobre todos os fluxos de trabalho localizados em ApplicationServer:atl-cs-001.litwareinc.com. Estas informações serão canalizadas para o cmdlet Select-Object, que expandirá o valor armazenado na propriedade DefaultAction. Quando se expande o valor de DefaultAction, exibem-se as propriedades individuais do objeto incorporado armazenado na propriedade DefaultAction.
-------------------------- Exemplo 4 ------------------------
Get-CsRgsWorkflow -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "European Sales Support"
O Exemplo 4 retorna informações sobre um único fluxo de trabalho do Grupo de Resposta: o fluxo de trabalho European Sales Supports, encontrado em ApplicationServer:atl-cs-001.litwareinc.com.
-------------------------- Exemplo 5 ------------------------
Get-CsRgsWorkflow -Identity service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.Language -eq "en-Us"}
O comando mostrado no Exemplo 5 retorna informações sobre todos os fluxos de trabalho do Grupo de Resposta que utilizarem o inglês dos EUA como idioma principal. Para fazer isso, o comando inicialmente chama Get-CsRgsWorkflow, para retornar um conjunto de todos os fluxos de trabalho localizados no serviço ApplicationServer:atl-cs-001.litwareinc.com. Esse conjunto será então canalizado para o cmdlet Where-Object, que seleciona apenas os fluxos de trabalho em que a propriedade Language for igual a Inglês dos EUA (en-US).
-------------------------- Exemplo 6 ------------------------
Get-CsRgsWorkflow service:ApplicationServer:atl-cs-001.litwareinc.com | Where-Object {$_.CustomMusicOnHold -eq $Null}
O comando anterior retorna todos os fluxos de trabalho em ApplicationServer:atl-cs-001.litwareinc.com, nos quais a propriedade CustomMusicOnHold tiver sido definida com um valor nulo. (em outras palavras, o comando retorna informações sobre os fluxos de trabalho aos quais uma música personalizada não foi atribuída.) Para executar essa tarefa, o comando inicialmente usa Get-CsRgsWorkflow, para retornar um conjunto de todos os fluxos de trabalho localizados no serviço ApplicationServer:atl-cs-001.litwareinc.com. Os dados retornados serão então canalizados para Where-Object, que selecionará somente os itens cuja propriedade CustomMusicOnHold for igual a (-eq) um valor nulo.