Get-CsAnnouncement
上一次修改主题： 2012-03-23
返回有关配置为在组织中使用的 Microsoft Lync Server 2010 通知的信息。当用户拨打一个有效但未分配的电话号码时，将会播放通知。通知可能是一条消息（如“此号码已暂停使用”），或者是繁忙信号。
语法
Get-CsAnnouncement [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsAnnouncement [-Filter <String>] [-LocalStore <SwitchParameter>]
详细说明
组织可以拥有未分配给用户或电话，但仍然是可以呼叫的有效号码的电话号码。默认情况下，当有人拨打其中的某个号码时，将收到繁忙信号，并且此呼叫可能会导致向 SIP 客户端返回错误。通过将通知设置应用于未分配的号码，管理员可以选择播放消息、返回繁忙信号或重定向呼叫。此 cmdlet 可以检索一个或多个此类通知设置。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsAnnouncement cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAnnouncement"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
要检索的通知的标识符。如果不包含此参数和 Filter 参数，将显示为组织配置的所有通知实例。可以通过以下两种方法之一来提供 Identity 参数的值： - 为要检索的通知输入应用程序服务的 Identity。这将检索配置了给定服务 Identity 的所有通知。例如，ApplicationServer:Redmond.litwareinc.com。 - 输入要检索的单个通知的完整 Identity。该值的格式将始终为 <serviceID>/<GUID>，其中 serviceID 是运行通知服务的应用程序服务器的 Identity，GUID 是与此通知相关联的全局唯一标识符。例如：ApplicationServer:Redmond.litwareinc.com/bef5fa3b-3c97-4af0-abe7-611deee7616c. |
Filter |
可选 |
字符串 |
通过此参数，可以对为组织配置的所有通知的 Identity 执行通配符搜索。使用通配符 (*) 可筛选 Identity 的任何部分。 |
LocalStore |
可选 |
开关参数 |
从中央管理存储的本地副本，而不是从中央管理存储本身检索通知信息。 |
输入类型
无。
返回类型
返回一个或多个 Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Get-CsAnnouncement
示例 1 返回配置为在组织中使用的所有通知。这是通过调用不带任何参数的 Get-CsAnnouncement 来实现的。
-------------------------- 示例 2 --------------------------
Get-CsAnnouncement -Identity "ApplicationServer:redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90"
上述命令返回单个通知：Identity 为 ApplicationServer:redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90 的通知。有关检索特定通知的备选（且可能是更为便捷的）方法，请参考示例 5。
-------------------------- 示例 3 --------------------------
Get-CsAnnouncement -Identity "ApplicationServer:redmond.litwareinc.com"
示例 3 中显示的命令返回有关配置为在 ApplicationServer:redmond.litwareinc.com 服务中使用的所有通知的信息。
-------------------------- 示例 4 --------------------------
Get-CsAnnouncement -Filter "*ApplicationServer:Redmond*"
在示例 4 中，返回配置为在 Redmond 站点（在所有域上）中使用的所有通知的信息。这是通过包含 Filter 参数和筛选器值“*ApplicationServer:Redmond*”来实现的，该筛选器值可将返回数据限制为 Identity 包含字符串值“ApplicationServer:Redmond”的通知。根据定义，这些是配置为在 Redmond 站点中使用的通知。
-------------------------- 示例 5 --------------------------
Get-CsAnnouncement | Where-Object {$_.Name -eq "Welcome Announcement"}
示例 5 说明了一种返回特定通知或通知集的备选方法；在此示例中，返回名为 Welcome Announcement 的所有通知。为执行此操作，首先调用不带任何参数的 Get-CsAnnouncement，以返回组织中使用的所有通知的集合。然后将该集合通过管道传递到 Where-Object cmdlet，后者将挑选出 Name 等于 (-eq)“Welcome Announcement”的通知。
-------------------------- 示例 6 --------------------------
Get-CsAnnouncement -Identity "ApplicationServer:redmond.litwareinc.com" | Where-Object {$_.Name -eq "Welcome Announcement"}
示例 6 与示例 5 类似，但此示例说明了另外一种返回单个通知的方法。我们再次调用 Get-CsAnnouncement，但这次指定 Identity 为 ApplicationServer:redmond.litwareinc.com。这将返回与此服务相关联的所有通知的集合。与在示例 5 中相同，将该集合通过管道传递到 Where-Object cmdlet，后者将挑选出 Name 等于 (-eq)“Welcome Announcement”的通知。由于通知名称在应用程序服务内必须唯一，因此该命令绝不会返回多项。
-------------------------- 示例 7 --------------------------
Get-CsAnnouncement | Where-Object {$_.Name -like "Welcome*"}
与示例 5 类似，此示例也检索所有通知，然后将通知集合通过管道传递到 Where-Object cmdlet。但在示例 5 中，我们在 Where 子句中使用 –eq 运算符，以查找与该名称相同的匹配项。在此示例中，我们使用了 –like 运算符和通配符值，查找以字符串 Welcome 开头的所有通知。
-------------------------- 示例 8 --------------------------
Get-CsAnnouncement | Where-Object {($_.TextToSpeechPrompt -ne $Null) -and ($_.Language -ne "en-US")}
在示例 8 中，返回有关使用文本到语音 (TTS) 转换提示（作为主要通知或作为回退到音频文件的方式），但不使用美国英语作为其语言的所有通知的信息。为完成此任务，该命令首先调用 Get-CsAnnouncement 以返回当前配置的所有通知的集合。然后将此集合通过管道传递到 Where-Object cmdlet，后者将选择 TextToSpeechPrompt 属性不为空（不等于 $Null）且 Language 属性不等于 (-ne) en-US 的所有通知。