Remove-CsTrustedApplicationEndpoint
上一次修改主题: 2012-03-26
删除受信任的应用程序终结点。
语法
Remove-CsTrustedApplicationEndpoint -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
详细说明
受信任的应用程序终结点是一个 Active Directory 联系人对象,它允许将呼叫路由至受信任的应用程序。此 cmdlet 可从 Active Directory 域服务 (AD DS) 中删除现有的终结点联系人对象。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Remove-CsTrustedApplicationEndpoint cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsTrustedApplicationEndpoint"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
必需 |
UserIdParameter |
要删除的应用程序终结点的标识(联系人的可分辨名称)、SIP 地址或显示名称。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact 对象。接受通过管道传递的受信任应用程序终结点对象的输入。
返回类型
此 cmdlet 不会返回值。它会删除一个类型为 Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact 的对象。
示例
-------------------------- 示例 1 --------------------------
Remove-CsTrustedApplicationEndpoint -Identity "Endpoint 1"
此示例删除 Identity(此例中即显示名称)为 Endpoint 1 的终结点联系人。由于标识必须是唯一的,因此该命令将最多删除一个终结点。
-------------------------- 示例 2 --------------------------
Get-CsTrustedApplicationEndpoint -ApplicationId tapp2 | Remove-CsTrustedApplicationEndpoint
此示例删除与应用程序 tapp2 关联的所有受信任的应用程序终结点。这是通过以下方式实现的:首先调用 Get-CsTrustedApplicationEndpoint 并将 ID tapp2 传递给 ApplicationId 参数。这将返回一个与 tapp2 受信任应用程序关联的终结点集合。然后,将该集合通过管道传递到 Remove-CsTrustedApplicationEndpoint cmdlet,后者会删除集合中的每个终结点。请记住,调用 Get-CsTrustedApplicationEndpoint 时,可从多个池检索应用程序 ID 为 tapp2 的终结点,这将导致此命令从多个池删除受信任应用程序终结点。