Import-CsAnnouncementFile

Syntax

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

Detaillierte Beschreibung

Dieses Cmdlet importiert eine Audiodatei als Bytearray in die Audiobibliothek des Ankündigungsdiensts. Dadurch steht die Datei für die Wiedergabe als Ansage für nicht zugewiesene Nummern zur Verfügung.

Beim Ausführen dieses Cmdlets wird die Audiodatei in die Bibliothek importiert. Nach dem Import der Datei kann diese für eine Ansage genutzt werden, indem das Cmdlet New-CsAnnouncement oder Set-CsAnnouncement aufgerufen wird und der Dateiname und dazugehörige Dienst als Parameter übergeben werden. Anschließend kann das Cmdlet New-CsUnassignedNumber oder Set-CsUnassignedNumber aufgerufen werden, um die Ansage einem bestimmten Nummernbereich zuzuweisen.

Importierte Dateien müssen das WAV- oder WMA-Format haben.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Import-CsAnnouncementFile lokal ausführen: RTCUniversalServerAdmins. Das Cmdlet kann jedoch auch von anderen Personen mit Schreibzugriff auf den Zielcomputer von Dateispeicher ausgeführt werden. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):

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

Parameter

Eingabetypen

Byte[]. Akzeptiert ein Bytearray aus einer Audiodatei. Das Bytearray muss als einzelner Datensatz weitergeleitet werden. Siehe Beispiel 3.

Rückgabetypen

Dieses Cmdlet gibt keinen Wert zurück.

Beispiel

-------------------------- Beispiel 1 --------------------------

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

Über diese Befehle wird eine Audiodatei in den Dateispeicher des Ankündigungsdiensts importiert. Da Audiodateien als Bytearrays importiert werden müssen, muss zunächst das Cmdlet Get-Content zum Abrufen der Audiodatei als ein Array einzelner Bytes aufgerufen werden. Get-Content ist ein vordefiniertes Windows PowerShell-Cmdlet, an das der Name (samt Pfad) der Datei übergeben wird, die für die Ansage verwendet werden soll. Als Nächstes wird der Wert 0 an den Parameter "ReadCount" übergeben, der angibt, dass die gesamte Datei auf einmal gelesen werden soll. Anschließend wird an den Parameter "Encoding" der Wert "Byte" übergeben, der dem Cmdlet Get-Content angibt, dass der Inhalt der Datei als Bytearray angefordert wird. Dieses Array wird dann der Variablen "$a" zugewiesen.

In der zweiten Zeile wird das Cmdlet Import-CsAnnouncementFile aufgerufen, um die Datei tatsächlich zu importieren. Zunächst wird der Dienst mit dem Identitätswert "ApplicationServer:redmond.litwareinc.com" an den Parameter "Parent" und danach ein Name an den Parameter "FileName" (WelcomeMessage.wav) übergeben. Dies kann ein beliebiger im Windows-Betriebssystem gültiger Dateiname sein, der allerdings die Erweiterung WAV oder WMA haben muss. Schließlich wird die Variable "$a" an den Parameter "Content" übergeben, damit das Bytearray eingelesen wird.

-------------------------- Beispiel 2 --------------------------

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

Beispiel 2 ist nahezu identisch mit Beispiel 1, doch wird hier der Befehl Get-Content in Klammern als Wert an den Parameter "Content" übergeben, anstatt dass dieser Befehl eigenständig aufgerufen und einer Variablen zugewiesen wird.

-------------------------- Beispiel 3 --------------------------

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

Beispiel 3 ist eine weitere Variante von Beispiel 1. Der Unterschied bei diesem Beispiel besteht darin, dass anstelle des Parameters "Content" zunächst das Cmdlet Get-Content aufgerufen wird und die Ergebnisse anschließend an Import-CsAnnouncement weitergeleitet werden. Dies ist die zuverlässigste Möglichkeit des Imports einer Ankündigungsdatei aus einer Remotesitzung.