Set-CsRgsConfiguration
Tópico modificado em: 2012-03-23
Modifica as definições de configuração do Aplicativo Grupo de Resposta.
Sintaxe
Set-CsRgsConfiguration -Identity <RgsIdentity> [-AgentRingbackGracePeriod <Int16>] [-Confirm [<SwitchParameter>]] [-DefaultMusicOnHoldFile <AudioFile>] [-DisableCallContext <$true | $false>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Set-CsRgsConfiguration -Instance <ServiceSettings> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
O Aplicativo Grupo de Resposta permite rotear automaticamente chamadas telefônicas para entidades, como uma linha de assistência técnica ou atendimento ao cliente. Quando alguém chama um número de telefone designado, a chamada pode ser automaticamente roteada para o conjunto apropriado de operadores do Grupo de Resposta. Como alternativa, a chamada pode ser roteada para uma fila de espera de resposta interativa de voz (IVR). Nessa fila de espera, uma série de perguntas seriam feitas ao chamador (por exemplo: "Você está telefonando a respeito de um pedido existente?") e então, com base nas respostas às perguntas, ele receberia a informação solicitada ou seria direcionado para um operador do Grupo de Resposta.
O cmdlet Set-CsRgsConfiguration permite modificar as propriedades de uma instância do Aplicativo Grupo de Resposta.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-CsRgsConfiguration 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-CsRgsConfiguration"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Identity |
Opcional |
Identidade do Rgs |
Nome do serviço que hospeda as definições de configuração do Grupo de Resposta. Por exemplo: -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com." |
Instance |
Opcional |
objeto ServiceSettings |
Referência de objeto para que as definições de configuração do Grupo de Resposta sejam modificadas. Uma referência de objeto é normalmente recuperada ao se usar o cmdlet Get-CsRgsConfiguration e atribuir o valor retornado a uma variável. Por exemplo: esse comando retorna uma referência de objeto às definições de configuração localizadas no serviço ApplicationServer:atl-cs-001.litwareinc.com e armazena a referência de objeto em uma variável denominada $x: $x = Get-CsRgsConfiguration -Identity service:ApplicationServer:atl-cs-001.litwareinc.com |
AgentRingbackGracePeriod |
Opcional |
Inteiro |
Se um operador recusar uma chamada, AgentRingbackGracePeriod representará a quantidade de tempo (em segundos) que pode passar até que a chamada retorne ao mesmo operador. O período de cortesia pode ser definido como um valor inteiro entre 30 e 600 segundos (10 minutos), inclusive. O valor padrão é 60 segundos. |
DefaultMusicOnHoldFile |
Opcional |
objeto AudioFile |
Representa a música que, por padrão, será executada a qualquer momento em que um chamador for colocado em espera. A música padrão é executada somente se um fluxo de trabalho do Grupo de Resposta não tiver definido sua própria música de espera. A propriedade DefaultMusicOnHoldFile deve ser configurada usando-se uma referência de objeto criada por meio do cmdlet Import-CsRgsAudioFile. Se DefaultMusicOnHold tiver valor nulo (o valor padrão) e se um fluxo de trabalho não tiver definido uma música personalizada de espera, a música de espera padrão será automaticamente configurada quando o Lync Server for instalado e será executada sempre que um chamador for colocado em espera. |
DisableCallContext |
Opcional |
Parâmetro de opção |
Se ele for definido como False (o valor padrão), cada operador poderá ver o contexto da chamada (informações como o tempo de espera do chamador ou as perguntas e respostas do fluxo de trabalho) a qualquer momento em que uma chamada for recebida (essas informações estarão visíveis no Microsoft Lync 2010). Se ele for definido como True, as informações de contexto de chamada não serão retransmitidas para os operadores quando uma chamada for recebida. Observe que o contexto da chamada só será usado com filas IVR. |
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.ServiceSettings. O cmdlet Set-CsRgsConfiguration aceita instâncias canalizadas do objeto de definições do Aplicativo Grupo de Resposta.
Tipos de Retorno
O cmdlet Set-CsRgsConfiguration não retorna qualquer objeto ou valor. Em vez disso, o cmdlet configura instâncias existentes do objeto Microsoft.Rtc.Rgs.Management.WritableSettings.ServiceSettings.
Exemplo
-------------------------- Exemplo 1 ------------------------
Set-CsRgsConfiguration -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -AgentRingbackGracePeriod 30
O comando mostrado no Exemplo 1 modifica a propriedade AgentRingbackGracePeriod correspondente às definições de configuração do Aplicativo Grupo de Resposta, localizadas no serviço ApplicationServer:atl-cs-001.litwareinc.com. Neste exemplo, AgentRingbackGracePeriod é definido como 30 segundos.
-------------------------- Exemplo 2 ------------------------
Get-CsService -ApplicationServer | Where-Object {$_.Applications -contains "urn:application:RGS"} | ForEach-Object {Set-CsRgsConfiguration -Identity $_.Identity -AgentRingbackGracePeriod 30}
O Exemplo 2 modifica a propriedade AgentRingbackGracePeriod de todas as definições de configuração do Grupo de Resposta da organização. Para isso, o comando primeiramente usa o cmdlet Get-CsService e o parâmetro ApplicationServer para retornar informações sobre todos os computadores na organização que estiverem executando o Serviço de aplicativos. A coleção retornada será então canalizada para o cmdlet Where-Object, que escolherá apenas os computadores cuja propriedade Applications contiver o aplicativo "urn:application:RGS"; este valor indica que o Aplicativo Grupo de Resposta está sendo executado no servidor.
Por sua vez, estes computadores serão canalizados para o cmdlet ForEach-Object. O cmdlet ForEach-Object tratará todos os computadores da coleção e utilizará o cmdlet Set-CsRgsConfiguration, para definir como 30 segundos o valor da propriedade AgentRingbackGracePeriod das definições de configuração do Grupo de Resposta do computador.
-------------------------- Exemplo 3 ------------------------
$x = Import-CsRgsAudioFile -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -FileName "WhileYouWait.wav" -Content (Get-Content C:\Media\WhileYouWait.wav -Encoding byte -ReadCount 0)
Set-CsRgsConfiguration -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -DefaultMusicOnHoldFile $x
Os comandos mostrados no Exemplo 3 importam um arquivo de áudio (C:\Media\WhileYouWait.wav) e atribuem este arquivo à propriedade DefaultMusicOnHoldFile. Para realizar essa tarefa, o primeiro comando utiliza Import-CsRgsAudioFile, para importar o arquivo de áudio para o Aplicativo Grupo de Resposta localizado em ApplicationServer:atl-cs-001.litwareinc.com. Além do parâmetro Identity (que especifica o local do serviço), utiliza-se o parâmetro FileName para especificar o nome do arquivo que está sendo importado.
Igualmente importante, utiliza-se o parâmetro Content para importar o arquivo de áudio. A importação do arquivo é realizada chamando-se o cmdlet Get-Content, seguido do caminho do arquivo que estiver sendo importado. O cmdlet Get-Content também exige que o tipo de codificação seja definido como byte e ReadCount como 0 (a definição de ReadCount como 0 garante que todo o arquivo seja lido em uma única operação). O arquivo importado será então armazenado em uma variável denominada $x.
Depois da importação do arquivo, chama-se o cmdlet Set-CsRgsConfiguration, para definir a propriedade DefaultMusicOnHold com o arquivo de áudio armazenado em $x.