Import-CsRgsAudioFile
Tópico modificado em: 2012-03-23
Importa um novo arquivo de áudio para uso com o Aplicativo Grupo de Resposta.
Sintaxe
Import-CsRgsAudioFile -Identity <RgsIdentity> -Content <Byte[]> -FileName <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
O Aplicativo Grupo de Resposta pode usar arquivos de áudio (somente nos formatos .WAV ou .WMA) de pelo menos duas maneiras diferentes. Em uma delas, o serviço pode reproduzir música (ou um algum tipo de comunicado) a qualquer momento em que os chamadores forem colocados em espera. Como alternativa, o Aplicativo Grupo de Resposta ocasionalmente "conversa" com os chamadores. Por exemplo: mediante a resposta interativa de voz (IVR), o serviço pode perguntar ao chamador algo como "Você está telefonando a respeito de um pedido existente?" É possível fazer com que o serviço leia tais perguntas usando uma tecnologia de texto em fala ou reproduzir uma gravação em áudio de uma pessoa real fazendo a pergunta.
Independentemente de como você optar por usar os arquivos de áudio, os próprios arquivos devem ser importados para o Aplicativo Grupo de Resposta usando-se o cmdlet Import-CsRgsAudioFile. Observe que o cmdlet Import-CsRgsAudioFile deve ser executado a cada vez que se desejar usar um arquivo de áudio, mesmo se o arquivo já estiver sendo usado em outro local no Aplicativo Grupo de Resposta. Por exemplo: suponha que o Fluxo de trabalho A usa um determinado arquivo de áudio como música de espera padrão e agora você deseja usar o mesmo arquivo de áudio como música de espera personalizada do Fluxo de trabalho B. Embora o arquivo de áudio já esteja sendo usado pelo aplicativo Grupo de Resposta, mesmo assim será necessário importar o arquivo, para poder utilizá-lo com o Fluxo de trabalho B.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Import-CsRgsAudioFile localmente: RTCUniversalServerAdmins. Também é necessário ter acesso de gravação no armazenamento de arquivos do computador de destino. 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 "Import-CsRgsAudioFile"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
Identidade do Rgs |
Identidade do serviço para o qual o arquivo de áudio vai ser importado. (este deve ser o mesmo serviço que hospeda o Aplicativo Grupo de Resposta). Por exemplo: -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com". |
Content |
Obrigatório |
Matriz de bytes |
Conteúdo real do arquivo de áudio sendo importado. A propriedade Content será preenchida chamando-se o cmdlet Get-Content. Ao chamar o cmdlet Get-Content, defina o parâmetro Encoding como byte e o parâmetro ReadCount como 0 (para obter detalhes, consulte a seção Exemplos, neste tópico). |
FileName |
Obrigatório |
Cadeia de caracteres |
Nome do arquivo de áudio sendo importado. Por exemplo, o nome do arquivo cujo caminho for C:\Media\Welcome.wav é: Welcome.wav. |
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 |
Parâmetro de opção |
Solicita confirmação antes da execução do comando. |
Tipos de Entrada
Nenhuma. O cmdlet Import-CsRgsAudioFile não aceita entradas canalizadas.
Tipos de Retorno
Cria novas instâncias do objeto Microsoft.Rtc.Rgs.Management.WritableSettings.AudioFile.
Exemplo
-------------------------- Exemplo 1 ------------------------
$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)
$y = Get-CsRgsWorkflow -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "Help Desk Workflow"
$y.CustomMusicOnHoldFile = $x
Set-CsRgsWorkflow $y
Os comandos mostrados no Exemplo 1 importam um arquivo de áudio (C:\Media\WhileYouWait.wav) e atribuem este arquivo à propriedade CustomMusicOnHold de um fluxo de trabalho. 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.
Ao mesmo tempo, 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.
No segundo comando, o cmdlet Get-CsRgsWorkflow é utilizado para criar uma referência de objeto ($y) ao Fluxo de trabalho Assistência Técnica. Após a criação dessa referência de objeto, o comando 3 define o valor da propriedade CustomMusicOnHoldFile como $x, a variável que contém o arquivo de áudio importado. Finalmente, o último comando no exemplo usa Set-CsRgsWorkflow, para gravar essas alterações no Fluxo de trabalho Assistência Técnica. Se o cmdlet Set-CsRgsWorkflow não for chamado, as modificações existirão somente em memória e desaparecerão assim que se fechar o Windows PowerShell, ou excluir as variáveis $x ou $y.