Set-CsTrustedApplication
上一次修改主题: 2012-03-26
修改受信任应用程序的设置。
语法
Set-CsTrustedApplication [-Identity <ExternalApplicationIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Port <Int32>] [-WhatIf [<SwitchParameter>]]
详细说明
受信任应用程序是第三方开发的应用程序,向其授予受信任状态以使其作为 Microsoft Lync Server 2010 的一部分运行,但它不是产品的内置部分。通过此 cmdlet 可修改运行应用程序的外部服务所使用的端口号。
使用此 cmdlet 修改受信任应用程序时,必须提供 Identity 参数的值。Identity 是托管应用程序的池的完全限定域名 (FQDN) 后跟左斜线 (/) 再跟应用程序 ID。例如 TrustPool.litwareinc.com/tapp2,其中 TrustPool.litwareinc.com 是池 FQDN,tapp2 是应用程序 ID。注意,如果通过调用 Get-CsTrustedApplication 查看现有应用程序,则将看到类似于这种形式的 ID:TrustPool.litwareinc.com/urn:application:tapp2。请注意应用程序名称 (tapp2) 之前的前缀urn:application:。虽然此前缀是 Identity 的一部分,但在指定 Identity 参数的值时不需要此前缀。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Set-CsTrustedApplication cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –matches "Set-CsTrustedApplication\b"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
可选 |
外部应用程序标识 |
要修改的受信任应用程序的唯一标识符。必须按照格式 <池 FQDN>/<应用程序 ID> 输入 Identity 值,其中“池 FQDN”是应用程序所在的池的 FQDN,“应用程序 ID”是应用程序的名称。 |
Port |
可选 |
Int32 |
将运行应用程序的端口号。 |
Force |
可选 |
开关参数 |
禁止显示任何本该在进行更改前显示的确认提示。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.Xds.DisplayTrustedApplication 对象。接受通过管道传递的受信任应用程序对象的输入。
返回类型
此 cmdlet 不返回值。它修改一个类型为 Microsoft.Rtc.Management.Xds.DisplayTrustedApplication 的对象。
示例
-------------------------- 示例 1 ------------------------
Set-CsTrustedApplication -Identity TrustPool.litwareinc.com/tapp2 -Port 6200
此示例将 Identity 为 TrustPool.litwareinc.com/tapp2 的受信任应用程序的端口修改为端口 6200。这一点是通过向 Set-CsTrustedApplication cmdlet 传递 TrustPool.litwareinc.com/tapp2 的 Identity 实现的。此 Identity 由应用程序所在池的名称后跟应用程序的名称(或 ID)组成。然后,加入 Port 参数,向其提供值 6200 以修改该值。