Artigo
01/15/2015

Import-CsAnnouncementFile

Tópico modificado em: 2012-03-23

Importa um arquivo de comunicado para a biblioteca de áudio do serviço de comunicados.

Sintaxe

Import-CSAnnouncementFile -Parent <String> -Content <Byte[]> -FileName <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Este cmdlet importa um arquivo de áudio como uma matriz de bytes para a biblioteca de áudio do serviço de comunicados. Ele disponibiliza o arquivo para reprodução como um comunicado para números não atribuídos.

A execução desse cmdlet importa o arquivo de áudio para a biblioteca. Depois que tiver sido importado, o arquivo poderá ser usado em um comunicado, chamando-se o cmdlet New-CsAnnouncement ou Set-CsAnnouncement e passando-se o nome do arquivo e o serviço associado como parâmetros. Nesse momento, o cmdlet New-CsUnassignedNumber ou Set-CsUnassignedNumber pode ser chamado para atribuir o comunicado a um intervalo específico de números.

Os arquivos importados devem ser WAV ou WMA.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Import-CsAnnouncementFile localmente: RTCUniversalServerAdmins. No entanto, o cmdlet também pode ser executado por qualquer pessoa com acesso de gravação no Repositório 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-CsAnnouncementFile"}

Parâmetros

Parâmetro	Obrigatório	Digite	Descrição
Parent	Obrigatório	Cadeia de caracteres	O ID de serviço do Servidor de aplicativos no qual estiver em execução o serviço de comunicados associado.
FileName	Obrigatório	Cadeia de caracteres	O nome que se deseja atribuir ao arquivo no Repositório de Arquivos. Utilize esse nome no parâmetro AudioFilePrompt, na chamada para o cmdlet New-CsAnnouncement ou Set-CsAnnouncement, para atribuir o arquivo a um comunicado.
Content	Obrigatório	Byte[]	O conteúdo do arquivo de áudio como uma matriz de bytes.
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 uma matriz de bytes de um arquivo de áudio. A matriz de bytes deve ser canalizada como um único registro. Veja o Exemplo 3.

Tipos de Retorno

Este cmdlet não retorna um valor.

Exemplo

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

$a = Get-Content ".\GreetingFile.wav" -ReadCount 0 -Encoding Byte
Import-CsAnnouncementFile -Parent ApplicationServer:redmond.litwareinc.com -FileName "WelcomeMessage.wav" -Content $a

Esses comandos importam um arquivo de áudio para o Repositório de Arquivos do serviço de comunicados. Como os arquivos de áudio devem ser importados como matrizes de bytes, precisamos inicialmente chamar o cmdlet Get-Content, para recuperar o arquivo de áudio como uma matriz de bytes. Get-Content é um cmdlet interno do Windows PowerShell, para o qual se passa o nome (inclusive o caminho) do arquivo que se deseja usar no comunicado. Em seguida, passamos um valor 0 para o parâmetro ReadCount, o que significa que precisamos ler todo o arquivo de uma só vez. Em seguida, passamos um valor Byte para o parâmetro Encoding, que informa a Get-Content que o conteúdo do arquivo terá o formato de uma matriz de bytes. Atribuímos a essa matriz a variável $a.

Na segunda linha, chama-se Import-CsAnnouncementFile para importar o arquivo. Passamos o serviço Identity ApplicationServer:redmond.litwareinc.com para o parâmetro Parent e, em seguida, passamos um nome para o parâmetro FileName (WelcomeMessage.wav). Este pode ser qualquer nome de arquivo válido ao sistema operacional Windows, mas deve terminar com uma extensão .wav ou .wma. Por fim, passamos a variável $a como o valor para o parâmetro Content a fim de ler nossa matriz de bytes.

-------------------------- Exemplo 2 ------------------------

Import-CsAnnouncementFile -Parent ApplicationServer:redmond.litwareinc.com -FileName "WelcomeMessage.wav" -Content (Get-Content ".\GreetingFile.wav" -ReadCount 0 -Encoding Byte)

O Exemplo 2 é idêntico ao Exemplo 1, exceto pelo fato de incluirmos o comando Get-Content dentro de parênteses como um valor do parâmetro Content, em vez de chamar esse comando individualmente e atribui-lo a uma variável.

-------------------------- Exemplo 3 ------------------------

Get-Content ".\GreetingFile.wav" -ReadCount 0 -Encoding Byte | Import-CsAnnouncementFile -Parent ApplicationServer:redmond.litwareinc.com -FileName "WelcomeMessage.wav"

O Exemplo 3 é uma outra variação do Exemplo 1. A diferença neste exemplo é que em vez de se usar o parâmetro Content, chama-se primeiramente o cmdlet Get-Content e, em seguida canaliza-se o resultado para Import-CsAnnouncement. Esta é a forma mais confiável de importar um arquivo de comunicado em uma sessão remota.

Compartilhar via