Import-CsRgsAudioFile
Letztes Änderungsdatum des Themas: 2012-03-23
Importiert eine neue Audiodatei, die mit der Reaktionsgruppenanwendung verwendet werden soll.
Syntax
Import-CsRgsAudioFile -Identity <RgsIdentity> -Content <Byte[]> -FileName <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Die Reaktionsgruppenanwendung kann Audiodateien (allerdings nur im WAV- oder WMA-Format) auf mindestens zwei unterschiedliche Arten verwenden. Der Dienst kann beispielsweise jedes Mal, wenn Anrufer in der Warteschleife platziert werden, Musik (oder eine Ansage) wiedergeben. Bei der Reaktionsgruppenanwendung ist gelegentlich eine Interaktion mit den Anrufern erforderlich. Mithilfe des interaktiven Sprachantwortsystems kann der Dienst Anrufern beispielsweise Fragen wie die folgende stellen: "Haben Sie Fragen zu einer aktuellen Bestellung?" Sie können den Dienst diese Fragen mithilfe der Text-zu-Sprache-Technologie vorlesen lassen oder eine Audioaufzeichnung einer tatsächlichen Person wiedergegeben, die die Frage stellt.
Die Audiodateien selbst müssen unabhängig von ihrer Verwendung mit dem Cmdlet Import-CsRgsAudioFile in die Reaktionsgruppenanwendung importiert werden. Sie müssen Import-CsRgsAudioFile jedes Mal ausführen, wenn Sie eine Audiodatei verwenden möchten, selbst wenn diese Datei bereits anderweitig in der Reaktionsgruppenanwendung verwendet wird. Angenommen, Workflow A verwendet eine bestimmte Audiodatei als benutzerdefinierte Wartemusik und Sie möchten dieselbe Audiodatei als benutzerdefinierte Wartemusik für Workflow B verwenden. Auch wenn die Audiodatei bereits von der Reaktionsgruppenanwendung verwendet wird, müssen Sie die Datei dennoch importieren, um sie mit Workflow B verwenden zu können.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Import-CsRgsAudioFile lokal ausführen: RTCUniversalServerAdmins. Sie benötigen auch Schreibzugriff auf den Dateispeicher des Zielcomputers. 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-CsRgsAudioFile"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
Rgs-ID |
ID des Diensts, in den die Audiodatei importiert werden soll. (Hierbei muss es sich um den Dienst handeln, der auch die Reaktionsgruppenanwendung hostet.) Beispiel: -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com". |
Content |
Erforderlich |
Bytearray |
Der aktuelle Inhalt der zu importierenden Audiodatei. Die Eigenschaft "Content" wird durch Aufrufen des Cmdlets Get-Content aufgefüllt. Legen Sie beim Aufrufen von Get-Content den Parameter "Encoding" auf "byte" und den Parameter "ReadCount" auf 0 fest (weitere Informationen finden Sie im Abschnitt "Beispiele"). |
FileName |
Erforderlich |
Zeichenfolge |
Dateiname der zu importierenden Audiodatei. Der Dateiname für die Datei "C:\Media\Welcome.wav" lautet beispielsweise: "Welcome.wav". |
Force |
Optional |
Switch-Parameter |
Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können. |
WhatIf |
Switch-Parameter |
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen. |
|
Confirm |
Switch-Parameter |
Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf. |
Eingabetypen
Keine. Import-CsRgsAudioFile akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Mit "Import-CsRgsAudioFile" werden Instanzen des Objekts "Microsoft.Rtc.Rgs.Management.WritableSettings.AudioFile" erstellt.
Beispiel
-------------------------- Beispiel 1 --------------------------
$x = Import-CsRgsAudioFile -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -FileName "WhileYouWait.wav" -Content (Get-Content C:\Media\WhileYouWait.wav -Encoding byte -ReadCount 0)
$y = Get-CsRgsWorkflow -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "Help Desk Workflow"
$y.CustomMusicOnHoldFile = $x
Set-CsRgsWorkflow $y
Die Befehle in Beispiel 1 importieren eine Audiodatei ("C:\Media\WhileYouWait.wav") und weisen diese dann der Eigenschaft "CustomMusicOnHold" eines Workflows zu. Hierzu verwendet der Befehl zunächst Import-CsRgsAudioFile, um die Audiodatei in die Reaktionsgruppenanwendung für "ApplicationServer:atl-cs-001.litwareinc.com" zu importieren. Neben dem Parameter "Identity" (der die Dienstidentifizierung angibt) wird mit dem Parameter "FileName" der Name der zu importierenden Datei angegeben.
Außerdem wird der Parameter "Content" zum Importieren der Audiodatei verwendet. Der Dateiimport erfolgt durch Aufrufen des Cmdlets Get-Content gefolgt vom Pfad zu der zu importierenden Datei. Bei Get-Content müssen Sie außerdem den Verschlüsselungstyp auf "byte" und den Wert für "ReadCount" auf 0 festlegen. (Die Festlegung von "ReadCount" den Wert 0 stellt sicher, dass die gesamte Datei in einem Arbeitsschritt gelesen wird.) Die importierte Datei wird dann in der Variablen "$x" gespeichert.
Im zweiten Befehl wird mit Get-CsRgsWorkflow ein Objektverweis ("$y") auf den Workflow "Help Desk Workflow" erstellt. Im Anschluss an die Erstellung dieses Objektverweises wird mit Befehl 3 der Wert der Eigenschaft "CustomMusicOnHoldFile" auf "$x" (die Variable, die die importierte Audiodatei enthält) festgelegt. Abschließend schreibt der letzte Befehl im Beispiel diese Änderungen mit Set-CsRgsWorkflow in den tatsächlichen Workflow "Help Desk Workflow". Wenn Sie Set-CsRgsWorkflow nicht aufrufen, sind die Änderungen nur im Arbeitsspeicher vorhanden und gehen verloren, sobald Sie Windows PowerShell beenden oder die Variablen "$x" oder "$y" löschen.