Remove-CsAnnouncement
上一次修改主题： 2012-03-26
删除现有的 Microsoft Lync Server 2010 通知。当用户拨打一个有效但未分配的电话号码时，将会播放通知。通知可能是一条消息（如“此号码已暂停使用”），或者是繁忙信号。
语法
Remove-CsAnnouncement -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
组织可以拥有未分配给用户或电话，但仍然是可以呼叫的有效号码的电话号码。默认情况下，当有人拨打其中的某个号码时，将收到繁忙信号，并且此呼叫可能会导致向 SIP 客户端返回错误。通过将通知设置应用于未分配的号码，管理员可以选择播放消息、返回繁忙信号或重定向呼叫。此 cmdlet 可删除一个或多个此类通知设置。
如果尝试删除与未分配号码范围相关联的通知，默认情况下，您将收到一个提示，询问是否确实要删除此通知。如果您删除此通知，则该范围的 AnnouncementName 属性会显示为 Null，且呼叫这些号码时不会播放任何通知，将只听见繁忙信号。但是，AnnouncementId 属性值（已删除的通知的 GUID）仍将可见。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Remove-CsAnnouncement cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsAnnouncement"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
要删除的通知的唯一标识符。可以通过以下两种方法之一来提供 Identity 参数的值： - 为要删除的通知输入应用程序服务的 Identity。这将删除配置了给定服务 Identity 的所有通知。例如，ApplicationServer:Redmond.litwareinc.com。 - 输入要删除的单个通知的完整 Identity。该值的格式将始终为 <serviceID>/<GUID>，其中 serviceID 是运行通知服务的应用程序服务器的 Identity，GUID 是与此通知相关联的全局唯一标识符。例如：ApplicationServer:Redmond.litwareinc.com/bef5fa3b-3c97-4af0-abe7-611deee7616c. |
Force |
可选 |
开关参数 |
在进行更改前取消可能另外显示的任何确认提示。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。
返回类型
删除 Microsoft.Rtc.Management.WritableConfig.Settings.AnnouncementServiceSettings.Announcement 对象的现有实例。
示例
-------------------------- 示例 1 --------------------------
Remove-CsAnnouncement -Identity "ApplicationServer:Redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90"
上述命令删除 Identity 为“ApplicationServer:Redmond.litwareinc.com/1951f734-c80f-4fb2-965d-51807c792b90”的通知。由于 Identity 必须唯一，因此此命令最多只会删除一个通知。
-------------------------- 示例 2 --------------------------
Remove-CsAnnouncement -Identity "ApplicationServer:Redmond.litwareinc.com"
在示例 2 中，删除所有已应用于 ApplicationServer:Redmond.litwareinc.com 服务的通知。为执行此操作，调用带有 Identity 参数的 Remove-CsAnnouncement。指定参数值“ApplicationServer:Redmond.litwareinc.com”（不带标识唯一通知的附加 GUID）会删除为指定服务配置的所有通知。