Import-CsAnnouncementFile

 

Última modificación del tema: 2012-03-23

Importa un archivo de anuncio a la biblioteca de audio del servicio de anuncio.

Sintaxis

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

Descripción detallada

Este cmdlet importa un archivo de audio como una matriz de bytes a la biblioteca de audio del servicio de anuncio. Esto hace que el archivo esté disponible para que se reproduzca como un anuncio para números sin asignar.

Ejecutar este cmdlet importa el archivo de audio a la biblioteca. Una vez importado, el archivo se puede usar en un anuncio si se llama al cmdlet New-CsAnnouncement o al Set-CsAnnouncement y se pasan el nombre del archivo y el servicio asociado como parámetros. En ese momento, se puede llamar al cmdlet New-CsUnassignedNumber o al Set-CsUnassignedNumber para asignar el anuncio a un intervalo de números específico.

Los archivos importados deben ser archivos WAV o WMA.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Import-CsAnnouncementFile de forma local: RTCUniversalServerAdmins. Sin embargo, cualquier usuario con acceso de escritura en el Almacén de archivos del equipo de destino puede ejecutar también el cmdlet. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Import-CsAnnouncementFile"}

Parámetros

Parámetro	Requerido	Tipo	Descripción
Parent	Requerido	Cadena de caracteres	El Id. de servicio del Servidor de aplicaciones en donde se está ejecutando el servicio de anuncio asociado.
FileName	Requerido	Cadena de caracteres	El nombre que desea que tenga el archivo en el Almacén de archivos. Este nombre se usará en el parámetro AudioFilePrompt en la llamada al cmdlet New-CsAnnouncement o al cmdlet Set-CsAnnouncement para asignar el archivo a un anuncio.
Content	Requerido	Byte[]	El contenido del archivo de audio como una matriz de bytes.
Force	Opcional	Parámetro modificador	Suprime los mensajes de confirmación que, de lo contrario, se mostrarían antes de realizar cambios.
WhatIf	Opcional	Parámetro modificador	Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.
Confirm	Opcional	Parámetro modificador	Solicita confirmación antes de ejecutar el comando.

Tipos de entrada

Byte[]. Acepta una matriz de bytes de un archivo de audio. La matriz de bytes se debe transferir como un único registro. Consulte el Ejemplo 3.

Tipos de valores devueltos

Este cmdlet no devuelve un valor.

Ejemplo

-------------------------- Ejemplo 1 ------------------------

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

Estos comandos importan un archivo de audio en el Almacén de archivos del servicio de anuncio. Debido a que los archivos de audio se deben importar como matrices de bytes, primero debemos llamar al cmdlet Get-Content para recuperar el archivo de audio como una matriz de bytes individuales. El cmdlet Get-Content es un cmdlet integrado de Windows PowerShell al que se pasa el nombre (incluida la ruta de acceso) del archivo que deseamos usar para nuestro anuncio. A continuación, se pasa un valor de 0 al parámetro ReadCount, lo que significa que queremos leer el archivo entero de una sola vez. Luego, se pasa un valor de Byte al parámetro Encoding, que le dice a Get-Content que deseamos el contenido del archivo como una matriz de bytes. La matriz se asigna a la variable $a.

En la segunda línea se llama al cmdlet Import-CsAnnouncementFile para importar el archivo. Se pasa el servicio Identity ApplicationServer:redmond.litwareinc.com al parámetro Parent, luego, se pasa un nombre al parámetro FileName (WelcomeMessage.wav). Puede ser cualquier nombre de archivo válido del sistema operativo Windows, pero debe contener una extensión .wav o .wma. Por último, se pasa la variable $a como el valor para que el parámetro Content lea en la matriz de bytes.

-------------------------- Ejemplo 2 ------------------------

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

El Ejemplo 2 es idéntico al Ejemplo 1, salvo que se incluye el comando Get-Content entre paréntesis como un valor para el parámetro Content, en lugar de llamar a ese comando en sí mismo y asignarlo a una variable.

-------------------------- Ejemplo 3 ------------------------

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

El Ejemplo 3 es otra variante del Ejemplo 1. La diferencia en este ejemplo es que en lugar de usar el parámetro Content, primero se llama al cmdlet Get-Content y, a continuación, se transfiere el resultado a Import-CsAnnouncement. Esta es la forma más fiable de importar un archivo de anuncio desde una sesión remota.