New-CsRgsWorkflow
Tópico modificado em: 2012-03-23
Cria um novo fluxo de trabalho do Grupo de resposta. Os fluxos de trabalho determinam as ações que são executadas quando o Aplicativo Grupo de Resposta recebe uma chamada telefônica.
Sintaxe
New-CsRgsWorkflow -Parent <RgsIdentity> -Name <String> -PrimaryUri <Uri> [-Active <$true | $false>] [-Anonymous <$true | $false>] [-BusinessHoursID <Nullable>] [-Confirm [<SwitchParameter>]] [-CustomMusicOnHoldFile <AudioFile>] [-DefaultAction <CallAction>] [-Description <String>] [-DisplayNumber <String>] [-EnabledForFederation <$true | $false>] [-Force <SwitchParameter>] [-HolidayAction <CallAction>] [-HolidaySetIDList <Collection>] [-InMemory <SwitchParameter>] [-Language <String>] [-LineUri <Uri>] [-NonBusinessHoursAction <CallAction>] [-TimeZone <String>] [-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 poderá 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 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 a chamadas) bem como feriados (dias em que não há operadores disponíveis para atender a chamadas).
Novos fluxos de trabalho são criados usando-se o cmdlet New-CsRgsWorkflow.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet New-CsRgsWorkflow: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsRgsWorkflow"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Name |
Obrigatório |
Cadeia de caracteres |
Nome exclusivo a ser atribuído ao fluxo de trabalho. A combinação entre as propriedades Pai e Nome permite identificar de forma exclusiva os fluxos de trabalho, sem a necessidade de consultar o identificador global exclusivo (GUID) do fluxo de trabalho. |
Parent |
Obrigatório |
Identidade do Rgs |
Serviço no qual o novo fluxo de trabalho será hospedado. Por exemplo: -Parent "service:ApplicationServer:atl-cs-001.litwareinc.com". |
PrimaryUri |
Obrigatório |
Endereço SIP |
Endereço SIP para o fluxo de trabalho. Por exemplo: -PrimaryUri "sip:helpdesk@litwareinc.com". PrimaryUri deve começar com prefixo "sip:". |
Active |
Opcional |
Booleano |
Se for definido como True, o fluxo de trabalho estará ativo e disponível para receber chamadas telefônicas. Se for definido como False (o valor padrão), o fluxo de trabalho não estará disponível para receber chamadas telefônicas. Quando a propriedade Active estiver definida como True, o fluxo de trabalho será validado antes da criação. Por exemplo: o fluxo de trabalho não será criado se não tiver sido especificada uma DefaultAction. Se Active estiver definida como False (ou não estiver configurada), nenhuma validação ocorrerá e o fluxo de trabalho será criado, mesmo se uma DefaultAction não tiver sido especificada. |
Anonymous |
Opcional |
Booleano |
Se estiver definida como True, as identidades dos operadores do Grupo de resposta serão mascaradas sempre que esses operadores atenderem a uma chamada. Se estiver definida como False (o valor padrão), as identidades dos operadores estarão disponíveis para os chamadores. |
BusinessHoursID |
Opcional |
objeto BusinessHours |
Dias da semana e horários do dia em que os operadores do fluxo de trabalho estão disponíveis para atender a chamadas. As identidades dos horários comerciais podem ser recuperadas usando-se o cmdlet Get-CsRgsHoursOfBusiness. |
CustomMusicOnHoldFile |
Opcional |
objeto AudioFile |
Representa a música personalizada a ser tocada quando os chamadores são colocados em espera. (caso não seja definida, os chamadores ouvirão a música padrão quando colocados em espera.) A música personalizada deve ser importada usando-se o cmdlet Import-CsRgsAudioFile. |
DefaultAction |
Obrigatório |
objeto CallAction |
Indica a ação a ser tomada quando um fluxo de trabalho for aberto durante o horário comercial. DefaultAction deve ser definida usando-se o cmdlet New-CsRgsCallAction e deve direcionar a chamada para uma fila ou para uma pergunta. O parâmetro DefaultAction será obrigatório, se o fluxo de trabalho estiver ativo, mas poderá ser omitido, se o fluxo de trabalho estiver inativo. |
Description |
Opcional |
Cadeia de caracteres |
Permite que os administradores adicionem outras informações sobre um fluxo de trabalho do Grupo de Resposta. Por exemplo, a Descrição pode incluir as informações de contato do proprietário do fluxo de trabalho. Esta descrição consta do cartão de contato do Microsoft Lync 2010 correspondente ao fluxo de trabalho. |
DisplayNumber |
Opcional |
Cadeia de caracteres |
Número de telefone do fluxo de trabalho, conforme exibido no Lync 2010. DisplayNumber pode ser formatado de qualquer maneira desejada. Por exemplo: -DisplayNumber "555-1219" -DisplayNumber "1-(425)-555-1219" -DisplayNumber "1.425.555.1219" |
EnabledForFederation |
Opcional |
Booleano |
Indica se o fluxo de trabalho está disponível para usuários de um domínio federado. Se for definido como False, somente usuários dentro da organização terão acesso ao fluxo de trabalho. |
HolidayAction |
Opcional |
objeto CallAction |
Ação a ser executada se uma chamada for recebida em um feriado. HolidayAction deve ser definido usando-se o cmdlet New-CsRgsCallAction. |
HolidaySetIdList |
Opcional |
objeto HolidaySet |
Representa os dias quando os operadores do fluxo de trabalho não estão disponíveis para atender a chamadas. As Identidades do conjunto de feriados podem ser recuperadas usando-se o cmdlet Get-CsRgsHolidaySet. |
Language |
Opcional |
Cadeia de caracteres |
Idioma usado para ler prompts de texto em fala do fluxo de trabalho. O parâmetro de idioma é opcional, desde que o sistema operacional esteja usando um dos idiomas suportados mostrados na lista abaixo. (observe que os idiomas de fala suportados representam um subconjunto de idiomas que podem ser usados no sistema operacional). Se o sistema operacional não estiver usando um idioma suportado, o parâmetro Language torna-se obrigatório e o parâmetro deve especificar o código correspondente a um idioma suportado. Se o sistema operacional estiver usando um idioma não suportado e o cmdlet New-CsRgsWorkflow for executado sem o parâmetro Language, o comando falhará. Por exemplo: suponha que o sistema operacional esteja executando o idioma faroês. Este idioma é suportado pelo sistema operacional Windows, mas não pelo Aplicativo Grupo de Resposta. Portanto, você deve incluir o parâmetro Language e um idioma suportado ao criar um novo fluxo de trabalho. Isso é obrigatório porque se nenhum idioma for especificado, o fluxo de trabalho utilizará o idioma do sistema operacional. No entanto, o idioma poderá ser usado em um fluxo de trabalho apenas se for suportado pelo Aplicativo Grupo de Resposta. O idioma deve ser especificado, usando-se um dos seguintes códigos de idioma: ca-Es – Catalão (Espanha) da-DK – Dinamarquês (Dinamarca) de-DE – Alemão (Alemanha) en-AU – Inglês (Austrália) en-CA – Inglês (Canadá) en-GB – Inglês (Reino Unido) en-IN – Inglês (Índia) en-US – Inglês (EUA) es-ES – Espanhol (Espanha) es-MX – Espanhol (México) fi-FI – Finlandês (Finlândia) fr-CA – Francês (Canadá) fr-FR – Francês (França) it-IT – Italiano (Itália) ja-JP – Japonês (Japão) ko-KR – Coreano (Coreia) nb-NO – Norueguês, Bokmal (Noruega) nl-NL – Holandês (Países Baixos) pl-PL – Polonês (Polônia) pt-BR – Português (Brasil) pt-PT – Português (Portugal) ru-RU – Russo (Rússia) sv-SE – Sueco (Suécia) zh-CN – Chinês (República Popular da China) zh-HK – Chinês (RAE de Hong Kong) zh-TW – Chinês (Taiwan) Por exemplo: -Language "nl-NL". |
LineUri |
Opcional |
Cadeia de caracteres |
Número de telefone do fluxo de trabalho. Deve-se especificar a linha Identificador de recurso uniforme (URI) usando-se o seguinte formato: o TEL: prefixo seguido de um sinal de adição, do código de chamada do país/região, do código de área e do número do telefone (usando apenas dígitos: sem espaços em branco, pontos ou hífens). Por exemplo: -LineUri "TEL:+14255551219" |
NonBusinessHoursAction |
Opcional |
objeto CallAction |
Ação a ser executada se uma chamada for recebida fora do horário comercial do fluxo de trabalho. NonBusinessHoursAction deve ser definido usando-se o cmdlet New-CsRgsCallAction. |
TimeZone |
Opcional |
Cadeia de caracteres |
Informações sobre fuso horário usadas ao se determinar feriados e horário comercial. Por exemplo: -TimeZone "Hora Oficial do Pacífico" |
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. |
InMemory |
Opcional |
Parâmetro de opção |
Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet. |
Tipos de Entrada
Nenhuma. O cmdlet New-CsRgsWorkflow não aceita entradas canalizadas.
Tipos de Retorno
New-CsRgsWorkflow cria novas instâncias do objeto Microsoft.Rtc.Rgs.Management.WritableSettings.Workflow.
Exemplo
-------------------------- Exemplo 1 ------------------------
New-CsRgsWorkflow -Parent service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" -PrimaryUri "sip:helpdesk@litwareinc.com"
O comando anterior cria um novo fluxo de trabalho do serviço ApplicationServer:atl-cs-001.litwareinc.com. Esse fluxo de trabalho recebe o nome Assistência técnica e a atribuição de um URI principal, sip:helpdesk@litwareinc.com.
-------------------------- Exemplo 2 ------------------------Adicione exemplo de código
$prompt = New-CsRgsPrompt -TextToSpeechPrompt "Welcome to the help desk."
$queue = (Get-CsRgsQueue -Identity service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk").Identity
$callAction = New-CsRgsCallAction -Prompt $prompt -Action TransferToQueue -QueueId $queue
New-CsRgsWorkflow -Parent service:ApplicationServer:atl-cs-001.litwareinc.com -Name "Help Desk" -PrimaryUri "sip:helpdesk@litwareinc.com" -DefaultAction $callAction
O comando mostrado no Exemplo 2 cria um novo prompt do fluxo de trabalho e uma ação de chamada. Em seguida, atribui os novos itens a um novo fluxo de trabalho do Grupo de resposta. No primeiro comando, utiliza-se o cmdlet New-CsRgsPrompt para criar um prompt de texto em fala “Welcome to the help desk”. Esse novo prompt é armazenado em uma variável denominada $prompt.
O segundo comando usa o cmdlet Get-CsRgsQueue, para recuperar a Identidade de uma fila do Grupo de resposta existente denominada Assistência técnica. A Identidade retornada será armazenada em uma variável denominada $queue.
O comando 3 então cria uma nova ação de chamada (armazenada em uma variável denominada $callAction), que faz referência tanto ao novo prompt ($prompt) quando à fila de espera recuperada ($queue). Finalmente, o último comando no exemplo cria um novo fluxo de trabalho, denominado Assistência Técnica. Este comando configura o PrimaryUri como sendo sip:helpdesk@litwareinc.com e define o valor da propriedade DefaultAction como sendo a ação de chamada criada na etapa anterior.