Import-CsRgsAudioFile
上一次修改主题： 2012-03-23
导入新的音频文件，以供响应组应用程序使用。
语法
Import-CsRgsAudioFile -Identity <RgsIdentity> -Content <Byte[]> -FileName <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
响应组应用程序至少可采用两种不同的方式来使用音频文件（仅限 .WAV 或 .WMA 格式）。一种方式是，服务可以在呼叫者处于呼叫等待状态时播放音乐（或某种类型的通知）。此外，响应组应用程序有时还会与呼叫者“交谈”；例如，使用互动语音响应 (IVR)，该服务可能会向呼叫者提出一个问题，如“是否打电话咨询现有订单？”。您可以使用文本到语音转换技术让该服务读取这些问题，也可以播放真人提问的录音。
无论您选择如何使用音频文件，都必须使用 Import-CsRgsAudioFile cmdlet 将文件本身导入响应组应用程序。请注意，每次要使用音频文件时，都必须运行 Import-CsRgsAudioFile，即使响应组应用程序中的其他地方正在使用该文件也是如此。例如，假定工作流 A 使用给定的音频文件作为其自定义呼叫等待音乐，而您现在要将同一个音频文件用作工作流 B 的自定义呼叫等待音乐。即使响应组应用程序正在使用该音频文件，您仍然需要导入该文件才能在工作流 B 中使用。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Import-CsRgsAudioFile cmdlet：RTCUniversalServerAdmins。此外，您还必须具有对目标计算机文件存储的写入权限。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Import-CsRgsAudioFile"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Rgs 标识 |
要导入音频文件的服务的标识。（必须是托管响应组应用程序的同一服务。）例如：-Identity "service:ApplicationServer:atl-cs-001.litwareinc.com"。 |
Content |
必需 |
字节数组 |
要导入的音频文件的实际内容。通过调用 Get-Content cmdlet 填充 Content 属性。调用 Get-Content 时，请将 Encoding 参数设置为 byte，并将 ReadCount 参数设置为 0（有关详细信息，请参阅本主题中的示例部分）。 |
FileName |
必需 |
字符串 |
要导入的音频文件的文件名。例如，文件 C:\Media\Welcome.wav 的文件名为：Welcome.wav。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
|
Confirm |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。Import-CsRgsAudioFile 不接受通过管道传递的输入。
返回类型
创建 Microsoft.Rtc.Rgs.Management.WritableSettings.AudioFile 对象的新实例。
示例
-------------------------- 示例 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
示例 1 中显示的命令导入音频文件 (C:\Media\WhileYouWait.wav)，然后将该文件分配给工作流的 CustomMusicOnHold 属性。为执行此任务，第一个命令使用 Import-CsRgsAudioFile 将音频文件导入 ApplicationServer:atl-cs-001.litwareinc.com 上的响应组应用程序。除了用于指定服务位置的 Identity 参数外，还使用 FileName 参数指定要导入的文件的文件名。
同时，使用 Content 参数导入音频文件。文件导入操作是通过调用 Get-Content cmdlet 后跟要导入的文件的路径来完成的。Get-Content 还要求您将编码类型设置为 byte 并将 ReadCount 设置为 0（将 ReadCount 设置为 0 可确保通过单个操作读入整个文件）。然后，将导入的文件存储在名为 $x 的变量中。
在第二个命令中，使用 Get-CsRgsWorkflow 创建对工作流 Help Desk Workflow 的对象引用 ($y)。创建此对象引用后，第三个命令将 CustomMusicOnHoldFile 属性的值设置为 $x，该变量包含已导入的音频文件。最后，此示例中的最后一个命令使用 Set-CsRgsWorkflow 将这些更改写入实际的工作流 Help Desk Workflow。如果不调用 Set-CsRgsWorkflow，您所做的修改将仅存在于内存中，并将在您关闭 Windows PowerShell 或者删除变量 $x 或 $y 后立即消失。