Import-CsAnnouncementFile

 

Dernière rubrique modifiée : 2012-03-23

Importe un fichier d’annonce dans la bibliothèque audio du service d’annonce.

Syntaxe

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

Description détaillée

Cette cmdlet importe un fichier audio dans la bibliothèque audio du service d’annonce sous la forme d’un tableau d’octets. Ceci permet de lire le fichier disponible à titre d’annonce pour les numéros non affectés.

À l’aide de cette cmdlet, vous pouvez importer le fichier audio dans la bibliothèque. Une fois le fichier importé, le fichier peut être utilisé dans une annonce en appelant la cmdlet New-CsAnnouncement ou Set-CsAnnouncement et en transmettant le nom du fichier et le service associé en tant que paramètres. À ce stade, il est possible d’appeler la cmdlet New-CsUnassignedNumber ou Set-CsUnassignedNumber pour affecter l’annonce à une plage de numéros spécifique.

Les fichiers importés doivent être des fichiers WAV ou WMA.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Import-CsAnnouncementFile : RTCUniversalServerAdmins. Cependant, n’importe quel utilisateur bénéficiant d’un accès en écriture au magasin de fichiers de l’ordinateur de destination peut faire appel à cette cmdlet. Pour retourner une liste de tous les rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette cmdlet a été affectée (y compris les rôles RBAC personnalisés créés par vos soins), exécutez la commande suivante à l’invite Windows PowerShell :

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

Paramètres

Paramètre	Obligatoire	Type	Description
Parent	Obligatoire	Chaîne	ID de service du serveur d’applications sur lequel le service d’annonce associé est exécuté.
FileName	Obligatoire	Chaîne	Nom que vous souhaitez attribuer au fichier dans le magasin de fichiers. Vous utiliserez ce nom dans le paramètre AudioFilePrompt pour appeler la New-CsAnnouncement ou Set-CsAnnouncement et affecter le fichier à une annonce.
Content	Obligatoire	Byte[]	Contenu du fichier audio sous forme de tableau d’octets.
Force	Facultatif	Paramètre de commutateur	Supprime les invites de confirmation qui s’affichent avant d’effectuer des modifications.
WhatIf	Facultatif	Paramètre de commutateur	Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement.
Confirm	Facultatif	Paramètre de commutateur	Vous demande confirmation avant d’exécuter la commande.

Types d’entrées

Byte[]. Accepte un tableau d’octets d’un fichier audio. Le tableau d’octets doit être redirigé dans un enregistrement unique. Voir l’exemple 3.

Types de retours

Cette cmdlet ne retourne aucune valeur.

Exemple

-------------------------- Exemple 1 ------------------------

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

Ces commandes importent un fichier audio dans le magasin de fichiers du service d’annonce. Puisque les fichiers audio doivent être importés sous la forme de tableaux d’octets, il nous faut avant tout appeler la cmdlet Get-Content afin de récupérer le fichier audio dans un tableau d’octets individuels. Get-Content est une cmdlet intégrée à Windows PowerShell à laquelle nous transmettons le nom (chemin d’accès compris) du fichier que nous voulons utiliser dans notre annonce. Nous transmettons ensuite une valeur égale à 0 au paramètre ReadCount, indiquant ainsi que nous souhaitons lire immédiatement le fichier tout entier. Nous transmettons ensuite la valeur Byte au paramètre Encoding qui indique à Get-Content que nous souhaitons extraire le contenu du fichier sous la forme d’un tableau d’octets. Nous affectons enfin ce tableau à la variable $a.

Dans la deuxième ligne, nous appelons la cmdlet Import-CsAnnouncementFile afin d’importer le fichier. Nous transmettons l’identité ApplicationServer:redmond.litwareinc.com au paramètre Parent, puis un nom au paramètre FileName (WelcomeMessage.wav). Il peut s’agir de n’importe quel nom de fichier système d’exploitation Microsoft Windows valide mais il doit se terminer par l’extension .wav ou .wma. Pour finir, nous transmettons la variable $a comme valeur du paramètre Content à lire dans notre tableau d’octets.

-------------------------- Exemple 2 ------------------------

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

L’exemple 2 est identique à l’exemple 1, à ceci près que nous incluons la commande Get-Content entre parenthèses en tant que valeur du paramètre Content, plutôt que d’appeler cette commande seule et de l’affecter à une variable.

-------------------------- Exemple 3 ------------------------

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

L’exemple 3 est une autre variante de l’exemple 1. La différence ici est, qu’au lieu de faire appel au paramètre Content, nous appelons d’abord la cmdlet Get-Content, puis redirigeons les résultats vers la cmdlet Import-CsAnnouncement. C’est le moyen le plus sûr d’importer un fichier d’annonce depuis une session à distance..