Set-CsAnnouncement
上一次修改主题： 2012-03-26
修改现有 Microsoft Lync Server 2010 通知的属性值。当用户拨打一个有效但未分配的电话号码时，将会播放通知。通知可能是一条消息（如“此号码已暂停使用”），或者是繁忙信号。
语法
Set-CsAnnouncement [-Identity <XdsIdentity>] [-AudioFilePrompt <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Language <String>] [-Name <String>] [-TargetUri <String>] [-TextToSpeechPrompt <String>] [-WhatIf [<SwitchParameter>]]
Set-CsAnnouncement [-AudioFilePrompt <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Language <String>] [-Name <String>] [-TargetUri <String>] [-TextToSpeechPrompt <String>] [-WhatIf [<SwitchParameter>]]
详细说明
组织可以拥有未分配给用户或电话，但仍然是可以呼叫的有效号码的电话号码。默认情况下，当有人拨打其中的某个号码时，将收到繁忙信号，并且此呼叫可能会导致向 SIP 客户端返回错误。通过将通知设置应用于未分配的号码，管理员可以选择播放消息、返回繁忙信号或重定向呼叫。此 cmdlet 用于修改这些通知设置。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Set-CsAnnouncement cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsAnnouncement"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
通知的唯一标识符。该值将总是采用格式 <serviceID>/<GUID>，其中 serviceID 是运行通知服务的应用程序服务器的标识，而 GUID 是与这些通知设置关联的全局唯一标识符。例如：ApplicationServer:redmond.litwareinc.com/bef5fa3b-3c97-4af0-abe7-611deee7616c. 由于在命令行中正确输入 GUID 有些困难，因此您很可能会使用 Get-CsAnnouncement cmdlet 来检索通知，然后将它们通过管道传递到 Set-CsAnnouncement cmdlet 进行修改。（有关详细信息，请参阅“示例”部分。） |
Instance |
可选 |
通知 |
对要更改的“通知”对象的引用。此对象的类型必须为 Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement，可通过调用 Get-CsAnnouncement cmdlet 进行检索。 |
Name |
可选 |
字符串 |
为此参数输入值以更改通知的名称。服务中的名称必须是唯一的。 |
AudioFilePrompt |
可选 |
字符串 |
要为通知播放的音频文件的名称。音频文件存储在文件存储中。要将音频文件保存到文件存储中，请使用 Import-CsAnnouncementFile cmdlet。 有效文件类型：WAV 和 WMA |
TextToSpeechPrompt |
可选 |
字符串 |
文本到语音转换 (TTS) 提示。这是将转换为音频并作为通知进行播放的字符串。 如果为单个通知指定了 AudioFilePrompt 和 TextToSpeechPrompt，则将收到警告：音频文件优先，并且将忽略 TTS 提示。 |
Language |
可选 |
字符串 |
播放 TTS 提示时使用的语言。如果为 TextToSpeechPrompt 输入了值，则必须指定此参数。 值作为字符串输入，表示要使用的语言和区域设置。以下是有效值列表，后面括号中的是语言和区域设置：ca-ES（加泰罗尼亚语，加泰罗尼亚）；da-DK（丹麦语，丹麦）；de-DE（德语，德国）；en-AU（英语，澳大利亚）；en-CA（英语，加拿大）；en-GB（英语，英国）；en-IN（英语，印度）；en-US（英语，美国）；es-ES（西班牙语，西班牙）；es-MX（西班牙语，墨西哥）；fi-FI（芬兰语，芬兰）；fr-CA（法语；加拿大）；fr-FR（法语，法国）；it-IT（意大利语，意大利）；ja-JP（日语，日本）；ko-KR（朝鲜语，韩国）；nb-NO（挪威语，博克马尔语，挪威）；nl-NL（荷兰语，荷兰）；pl-PL（波兰语，波兰）；pt-BR（葡萄牙语，巴西）；pt-PT（葡萄牙语，葡萄牙）；ru-RU（俄语，俄罗斯）；sv-SE（瑞典语，瑞典）；zh-CN（中文，中华人民共和国）；zh-HK（中文，香港特别行政区）；zh-TW（中文，台湾） |
TargetUri |
可选 |
字符串 |
播放通知后将呼叫者转接至的 URI。该值必须是 SIP 地址，输入时的格式为 sip:后跟 SIP 地址。例如，sip:kmyer@litwareinc.com。请注意，SIP 地址还可以是电话号码或语音邮件，例如 sip:+14255551212@litwareinc.com;user=phone（适用于电话号码）或者 sip:kmyer@litwareinc.com;opaque=app:voicemail（适用于语音邮件）。 |
Force |
可选 |
开关参数 |
在进行更改前取消可能另外显示的任何确认提示。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement 对象。接受通过管道传递的通知对象的输入。
返回类型
Set-CsAnnouncement 不会返回任何对象或值。此 cmdlet 会修改 Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement 对象的现有实例。
示例
-------------------------- 示例 1 --------------------------
Get-CsAnnouncement | Where-Object {$_.Name -eq "Help Desk Announcement"} | Set-CsAnnouncement -AudioFilePrompt "helpdesk.wav"
示例 1 中显示的命令将一个新的音频文件分配给技术支持通知。为了执行此任务，该命令首先使用不带任何参数的 Get-CsAnnouncement，以便返回当前可用的所有通知的集合。然后，将该集合通过管道传递到 Where-Object cmdlet，后者会挑选 Name 等于 (-eq) "Help Desk Announcement" 的通知。接下来，将该通知通过管道传递到 Set-CsAnnouncement，后者将 AudioFilePrompt 属性的值设置为 helpdesk.wav。
请注意，如果该通知已分配了一个 TextToSpeechPrompt 值，则该命令会生成一条警告，说明 TextToSpeechPrompt 值将被忽略。
-------------------------- 示例 2 --------------------------
Get-CsAnnouncement | Where-Object {$_.Name -eq "Help Desk Announcement"} | Set-CsAnnouncement -TextToSpeechPrompt $Null
在示例 2 中，Help Desk Announcement 通知的 TextToSpeechPrompt 属性设置为一个空值；这样会实际上清除该属性值。为此，该命令首先使用 Get-CsAnnouncement 返回当前可用的所有通知的集合。然后，将该集合通过管道传递到 Where-Object，后者会选择 Name 等于 (-eq) "Help Desk Announcement" 的通知。接下来，将该通知通过管道传递到 SSet-CsAnnouncement cmdlet，后者将 TextToSpeechPrompt 属性设置为一个空值 ($Null)。
-------------------------- 示例 3 --------------------------
Get-CsAnnouncement | Where-Object {$_.Name -eq "Help Desk Announcement"} | Set-CsAnnouncement -TargetUri "sip:kmyer@litwareinc.com;opaque=app:voicemail"
此示例更新名称为 Help Desk Announcement 的通知的 TargetUri。该命令首先使用 Get-CsAnnouncement 返回当前可用的所有通知的集合。然后，将该集合通过管道传递到 Where-Object，后者会选择 Name 等于 (-eq) "Help Desk Announcement" 的通知。接下来，将该通知通过管道传递到 Set-CsAnnouncement cmdlet，后者将 TargetUri 属性设置为一个语音邮件位置 (sip:kmyer@litwareinc.com;opaque=app:voicemail)。