Set-CsTrustedApplication
上次修改主題的時間: 2012-03-26
修改信任之應用程式的設定。
語法
Set-CsTrustedApplication [-Identity <ExternalApplicationIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Port <Int32>] [-WhatIf [<SwitchParameter>]]
詳細描述
信任的應用程式是由第三方開發的應用程式,具備做為 Microsoft Lync Server 2010 之一部分來執行的信任狀態,但不是產品的內建部分。此指令程式可讓您修改執行應用程式之外部服務所使用的連接埠號碼。
當您使用此指令程式修改信任的應用程式時,必須提供 Identity 參數的值。Identity 是應用程式所在之集區的完整網域名稱 (FQDN),後面緊接著正斜線 (/) 和應用程式識別碼。例如 TrustPool.litwareinc.com/tapp2,其中 TrustPool.litwareinc.com 是集區 FQDN,而 tapp2 是應用程式識別碼。請注意,如果您透過呼叫 Get-CsTrustedApplication 來檢視現有的應用程式,您看到的識別碼會類似如下: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 |
選用 |
外部應用程式 Identity |
您要修改之信任的應用程式的唯一識別碼。Identity 值必須以 <pool FQDN>/<application ID> 格式輸入,其中集區 FQDN 是應用程式所在之集區的 FQDN,而 application ID 是應用程式的名稱。 |
Port |
選用 |
Int32 |
將會執行應用程式的連接埠號碼。 |
Force |
選用 |
切換參數 |
抑制在進行變更前可能顯示的任何確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果,但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.Xds.DisplayTrustedApplication 物件。接受管線傳送的受信任應用程式物件輸入。
傳回類型
這個指令程式不會傳回值。它會修改 Microsoft.Rtc.Management.Xds.DisplayTrustedApplication 類型的物件。
範例
-------------------------- 範例 1 ------------------------
Set-CsTrustedApplication -Identity TrustPool.litwareinc.com/tapp2 -Port 6200
此範例會將 Identity 為 TrustPool.litwareinc.com/tapp2 之信任的應用程式的連接埠修改為連接埠 6200。這可以透過將 Identity TrustPool.litwareinc.com/tapp2 傳遞給 Set-CsTrustedApplication 指令程式完成。此 Identity 是由應用程式所在之集區的名稱,後面緊接著應用程式名稱 (或識別碼) 所組成。接著,我們會加上 Port 參數,將其值指定為 6200 以修改該值。