New-CsTrustedApplication
上次修改主題的時間： 2012-03-26
將信任的應用程式新增到集區。
語法
New-CsTrustedApplication -ApplicationId <String> -Port <Int32> -TrustedApplicationPoolFqdn <String> [-Confirm [<SwitchParameter>]] [-EnableTcp <SwitchParameter>] [-Force <SwitchParameter>] [-LegacyApplicationName <String>] [-WhatIf [<SwitchParameter>]]
New-CsTrustedApplication [-Identity <ExternalApplicationIdentity>] -Port <Int32> [-Confirm [<SwitchParameter>]] [-EnableTcp <SwitchParameter>] [-Force <SwitchParameter>] [-LegacyApplicationName <String>] [-WhatIf [<SwitchParameter>]]
詳細描述
信任的應用程式是由第三方開發的應用程式，具備做為 Microsoft Lync Server 2010 之一部分來執行的信任狀態，但不是產品的內建部分。此指令程式會將信任的應用程式新增到信任的應用程式集區，並將連接埠指派給執行該應用程式的外部服務。
信任的應用程式必須與可全域路由傳送使用者代理程式 URI (GRUU) 產生關聯，包括服務 GRUU 及電腦 GRUU。此指令程式會根據與此應用程式所在位置之集區相關聯的電腦及服務，自動產生這些值。
當您使用此指令程式建立信任的應用程式時，必須提供 Identity 參數的值或 ApplicationID 及 TrustedApplicationPoolFqdn 參數的值。Identity 就是 TrustedApplicationPoolFqdn 後面緊接著正斜線 (/) 和 ApplicationID。例如 TrustPool.litwareinc.com/tapp2，其中的 TrustPool.litwareinc.com 是 TrustedApplicationPoolFqdn，而 tapp2 則是 ApplicationID。
請注意，當您輸入應用程式識別碼(不論是做為 Identity 參數的一部分或在 ApplicationID 參數中) 時，必須只輸入應用程式名稱。不過，完整的應用程式識別碼將會自動加上字串 urn:application: 做為首碼。例如，如果您輸入值 tapp2 做為 ApplicationID，該 ID 將會儲存為 urn:application:tapp2。同樣地，如果您輸入的 Identity 為 TrustPool.litwareinc.com/tapp2，該 Identity 在系統中將會儲存為 TrustPool.litwareinc.com/urn:application:tapp2。
當您使用此 Cmdlet 指定 Port 值時，此指令程式不會開啟該連接埠。您必須在 Windows 防火牆和任何公司防火牆中開啟連接埠，才能讓信任的應用程式與防火牆外的網路取得聯繫。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsTrustedApplication Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsTrustedApplication\b"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
外部應用程式 Identity |
集區中信任之應用程式的唯一識別碼。Identity 值的輸入格式必須為 <集區 FQDN>/<應用程式識別碼>，其中的集區 FQDN 是應用程式所在之集區的完整網域名稱 (FQDN)，而應用程式識別碼則是應用程式名稱。應用程式識別碼在指定集區中必須是唯一的。 如果您輸入 Identity，則無法指定 ApplicationId 或 TrustedApplicationPoolFqdn 參數的值。 |
ApplicationId |
必要 |
字串 |
應用程式的名稱。這必須是在 TrustedApplicationPoolFqdn 參數中指定，並且在集區中是唯一的字串。該字串中不能包含空格。如果您提供 ApplicationId 的值，也必須提供 TrustedApplicationPoolFqdn 參數的值。您無法指定 ApplicationId 及 Identity。 |
Port |
必要 |
Int32 |
將會執行應用程式的連接埠號碼。該連接埠在指定集區中必須是唯一的。換句話說，在指定的集區上無法定義使用這個相同連接埠的其他應用程式。 |
TrustedApplicationPoolFqdn |
必要 |
字串 |
應用程式所在之信任應用程式集區的 FQDN。如果您提供 TrustedApplicationPoolFqdn 的值，也必須提供 ApplicationId 的值，但是您無法提供 Identity 參數的值。 |
EnableTcp |
選用 |
切換參數 |
指定信任的應用程式將使用傳輸控制通訊協定 (TCP)。只有在信任的應用程式不是 Microsoft Unified Communications Managed API (UCMA) 應用程式時，才使用此參數。這是因為 UCMA 應用程式僅支援相互傳輸層安全性 (MTLS) 通訊協定。如果您不指定 Force 參數搭配 EnableTcp 參數，將在建立新信任的應用程式之前收到確認提示。 |
LegacyApplicationName |
選用 |
字串 |
只有當應用程式從 Microsoft Office Communications Server 2007 R2 部署遷移時，才使用此參數。此值必須與應用程式 Office Communications Server 2007 R2 版本的 GRUU 類型相同，兩者才能共同運作。 請注意，在大多數情況下，將 ApplicationId 參數設為等於 GRUU 類型，就足以讓應用程式共同運作。不過，如果來自 Office Communications Server 2007 R2 應用程式的 GRUU 類型包含 ApplicationId 中無效的字元，則必須在 LegacyApplicationName 參數中提供該值。 如果您未指定此參數的值，將會自動插入應用程式識別碼的值 (不含 urn:application:首碼)。 |
Force |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。
傳回類型
建立 Microsoft.Rtc.Management.Xds.DisplayTrustedApplication 類型的物件。
範例
-------------------------- 範例 1 ------------------------
New-CsTrustedApplication -ApplicationId tapp1 -TrustedApplicationPoolFqdn TrustPool.litwareinc.com -Port 6000
此範例會建立應用程式識別碼為 tapp1 之信任的應用程式。我們使用 TrustedApplicationPoolFqdn 參數指定此應用程式所在之信任的應用程式集區，在此例中，是 FQDN 為 TrustPool.litwareinc.com 的集區。我們也必須指定應用程式的連接埠；在此範例中，我們使用連接埠 6000。請注意，透過指定 ApplicationId 和 TrustedApplicationPoolFqdn 來執行此指令程式將會自動產生 Identity，此 Identity 稍後可用來擷取、修改或移除此應用程式。
-------------------------- 範例 2 ------------------------
New-CsTrustedApplication -Identity TrustPool.litwareinc.com/tapp2 -Port 6100
此範例會在連接埠 6100 上建立 Identity 為 TrustPool.litwareinc.com/tapp2 的信任的應用程式。請注意 Identity 的格式。此值的格式必須為 <信任的集區 FQDN>/<應用程式識別碼>。