Compartilhar via

  • Artigo

Set-CsCallParkServiceMusicOnHoldFile

 

Tópico modificado em: 2012-03-26

Modifica o arquivo de áudio que será reproduzido para chamadores que estiverem em espera em uma chamada estacionada.

Sintaxe

Set-CsCallParkServiceMusicOnHoldFile -Service <String> -Content <Byte[]> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

O estacionamento de chamadas é um serviço que permite que um usuário "estacione" uma chamada telefônica recebida. O estacionamento de uma chamada a transfere para um número em um intervalo especificado e imediatamente a coloca em espera. Com base nas definições de configuração especificadas para o serviço Estacionamento de chamadas, a música em espera poderá ser reproduzida ao chamador enquanto a chamada estiver estacionada. Use este cmdlet para modificar o arquivo de áudio (música em espera) que é reproduzido a um chamador estacionado que estiver em espera.

A música de espera será reproduzida somente se a propriedade EnableMusicOnHold do serviço Estacionamento de chamadas tiver sido definida como True. Você pode verificar esta propriedade chamando o Get-CsCpsConfiguration. Você pode definir a propriedade quando a configuração de Estacionamento de Chamada for criada com New-CsCpsConfiguration ou, depois que ela existir, chamando-se Set-CsCpsConfiguration. Esta propriedade é Verdadeira por padrão.

Microsoft Lync Server 2010 é enviado com um arquivo padrão de música em espera do serviço Estacionamento de chamadas. Se você não atribuir um arquivo de áudio, o arquivo padrão será usado.

Os arquivos de áudio devem estar no seguinte formato: Windows Media Audio 9, 44 kHz, 16 bits, Mono, CBR, ou 32 kbps.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Set-CsCallParkServiceMusicOnHoldFile localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet foi atribuído (inclusive qualquer função RBAC personalizada que tenha sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsCallParkServiceMusicOnHoldFile"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Service

Obrigatório

ServiceId

O ID do serviço no qual reside o serviço de Estacionamento de Chamada. Por exemplo: ApplicationServer:pool0.litwareinc.com.

Content

Obrigatório

Byte[]

O conteúdo do arquivo de áudio em formato de bytes.

Use o cmdlet Get-Content para recuperar o conteúdo do arquivo de áudio no formato de bytes. (Para obter detalhes, consulte a seção Exemplos, neste tópico).

Force

Opcional

SwitchParameter

Suprime qualquer aviso de confirmação que, de outra maneira, seria exibido antes de se realizar as alterações.

WhatIf

Opcional

SwitchParameter

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

SwitchParameter

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Byte[]. Aceita entrada canalizada de uma matriz de bytes que contém o arquivo de música de espera.

Tipos de Retorno

Este cmdlet não retorna um valor.

Exemplo

-------------------------- Exemplo 1 --------------------------

$a = Get-Content -ReadCount 0 -Encoding byte "C:\MoHFiles\soothingmusic.wma"
Set-CsCallParkServiceMusicOnHoldFile -Service ApplicationServer:pool0.litwareinc.com -Content $a

Este exemplo define o arquivo SoothingMusic.wma como sendo o arquivo de áudio que será reproduzido para os chamadores cujas chamadas forem estacionadas. A primeira linha deste exemplo é uma chamada ao cmdlet incorporado ao Windows PowerShellGet-Content. Este cmdlet simplesmente lê o conteúdo de um arquivo e o atribui, neste caso, à variável $a. Passamos o valor 0 para o parâmetro ReadCount, de modo que Get-Content leia todo o arquivo de uma só vez (em vez de tentar lê-lo linha por linha, o que não se aplica a um arquivo de áudio). Definimos o parâmetro Codificação para byte. Isto diz ao Get-Content que o conteúdo que desejamos ler na variável $a é uma matriz de byte e não o arquivo de áudio no formato .wma.

A linha 2 neste exemplo é onde realmente atribuímos o arquivo de áudio. Chamamos Set-CsCallParkServiceMusicOnHoldFile e especificamos o ID de serviço no qual estiver sendo executado o serviço Estacionamento de chamadas. Então passamos o conteúdo do arquivo de áudio que lemos na variável $a para o parâmetro Conteúdo (lembre-se de que este conteúdo deve estar no formato de bytes).