Get-CsTrustedApplication
上次修改主題的時間： 2012-03-23
擷取受信任應用程式的設定。
語法
Get-CsTrustedApplication [-Identity <ExternalApplicationIdentity>]
Get-CsTrustedApplication [-Filter <String>]
Get-CsTrustedApplication [-ApplicationId <String>] [-TrustedApplicationPoolFqdn <String>]
詳細描述
受信任應用程式是由取得信任狀態之第三方開發的應用程式，可作為 Microsoft Lync Server 2010 的部分執行，但這並不是產品的內建部分。這個指令程式可讓您擷取一或多個受信任應用程式的連接埠，以及全域可路由使用者代理程式 URI (GRUU) 設定。
當您使用此指令程式來擷取單一受信任應用程式時，您必須提供 Identity 參數值。Identity 是應用程式常駐之集區的完整網域名稱 (FQDN)，隨後接著正斜線 (/) 和應用程式 ID。例如，TrustPool.litwareinc.com/tapp2，其中 TrustPool.litwareinc.com 是集區 FQDN，而 tapp2 是應用程式 ID。請注意，當您以呼叫此指令程式的方式擷取應用程式時，您將會看到如下所示的 ID：TrustPool.litwareinc.com/urn:application:tapp2。注意首碼 urn:application:在應用程式名稱 (tapp2) 之前。此首碼是 Identity 的一部分，但是在您指定 Identity 參數值時則不需要。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsTrustedApplication Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins、RTCUniversalReadOnlyAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsTrustedApplication\b"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
ExternalApplicationIdentity |
您要擷取之受信任應用程式的唯一識別碼。Identity 值必須以 <pool FQDN>/<application ID> 格式輸入，其中集區 FQDN 是應用程式所在之集區的 FQDN，而 application ID 是應用程式的名稱。請注意，若您指定一個 Identity，則不可指定 ApplicationID 或 TrustedApplicationPoolFqdn。 |
Filter |
選用 |
字串 |
包含萬用字元的字串，可讓您根據符合指定之萬用字元字串的 Identity 值來擷取受信任應用程式。識別身分包含受信任應用程式集區 FQDN，後面接著正斜線 (/) 與受信任應用程式 ID。Filter 值會比對 Identity 的任何部分 (FQDN 與應用程式 ID 兩者)。 |
ApplicationId |
選用 |
字串 |
應用程式的名稱。可以包含應用程式 ID 前置字元，但並非必要。例如，urn:application:tapp1 及 tapp1 的 ApplicationId 值會同時傳回相同的應用程式。如果您提供 ApplicationId 值，您無法提供 Identity 值，但您必須提供 TrustedApplicationPoolFqdn 參數值。 |
TrustedApplicationPoolFqdn |
選用 |
字串 |
應用程式所在之受信任應用程式集區的 FQDN。如果您提供 TrustedApplicationPoolFqdn 值，您無法提供 Identity 值，但您必須提供 ApplicationID 參數值。 |
輸入類型
無。
傳回類型
傳回 Microsoft.Rtc.Management.Xds.DisplayTrustedApplication 類型的物件。
範例
-------------------------- 範例 1 ------------------------
Get-CsTrustedApplication
此範例會擷取定義於 Lync Server 2010 部署內所有受信任應用程式的相關資訊。
-------------------------- 範例 2 ------------------------
Get-CsTrustedApplication -Identity TrustPool.litwareinc.com/tapp2
範例 2 會擷取 Identity 為 TrustPool.litwareinc.com/urn:application:tapp2 的受信任應用程式。請注意，我們可以省略 urn:application:首碼，Get-CsTrustedApplication 會自動新增首碼並擷取正確的應用程式。
-------------------------- 範例 3 ------------------------
Get-CsTrustedApplication -Filter *trust*
範例 3 會擷取所有受信任應用程式，其識別身分符合指定為 Filter 值的萬用字元字串。在此案例中，利用 Filter 值 *trust*，命令會擷取在 Identity 任何位置中具有字串 “trust” 的所有受信任應用程式。此字串可包含於 Identity、集區 FQDN，或應用程式 ID 的任何部分。因此這個命令會擷取含識別身分 (如 TrustedPool.litwareinc.com/urn:application:application1、Pool1.litwareinc.com/urn:application:trustedapp，與 Pool1.litwareinc.com/urn:application:trust) 的受信任應用程式。
-------------------------- 範例 4 ------------------------
Get-CsTrustedApplication -ApplicationId tapp2 -TrustedApplicationPoolFqdn TrustPool.litwareinc.com
範例 4 會傳回與範例 2 (其中將 Identity 指定為唯一的參數) 相同的結果。兩個範例間唯一的差異是：範例 2 是根據 Identity 擷取受信任應用程式，其包含受信任集區 FQDN，後面接著應用程式 ID。在此範例中，輸入應用程式 ID 與受信任集區 FQDN 以作為兩個個別參數的值：ApplicationId 與 TrustedApplicationPoolFqdn。
-------------------------- 範例 5 ------------------------
Get-CsTrustedApplication | Where-Object {$_.TrustedApplicationPoolFqdn -eq "TrustPool.litwareinc.com"}
範例 5 會擷取集區 TrustPool.litwareinc.com 上的所有受信任應用程式。該範例以呼叫 Get-CsTrustedApplication 指令程式開始。這會傳回定義於 Lync Server 部署中之所有受信任應用程式的集合。接著將此集合傳送給 Where-Object 指令程式，它會逐項查看集合以找出 TrustedApplicationPoolFqdn 屬性等於 (-eq) TrustPool.litwareinc.com 的集合。