New-CsTrustedApplicationPool
上次修改主題的時間： 2012-03-27
建立包含託管信任的應用程式之電腦的新集區。
語法
New-CsTrustedApplicationPool -Identity <XdsGlobalRelativeIdentity> [-AppSharingPortCount <UInt16>] [-AppSharingPortStart <UInt16>] [-AudioPortCount <UInt16>] [-AudioPortStart <UInt16>] [-ComputerFqdn <Fqdn>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-OutboundOnly <$true | $false>] [-Registrar <String>] [-RequiresReplication <$true | $false>] [-Site <String>] [-ThrottleAsServer <$true | $false>] [-TreatAsAuthenticated <$true | $false>] [-VideoPortCount <UInt16>] [-VideoPortStart <UInt16>] [-WhatIf [<SwitchParameter>]]
詳細描述
建議您應該將 Microsoft Lync Server 2010 部署內執行信任的應用程式的電腦，新增至信任的應用程式專用的集區。不過，您也可以將信任的應用程式電腦新增至用於其他用途的現有集區。如果集區已經是拓撲的一部分，這個指令程式會建立與該集區相關聯的外部服務 (含 ExternalServer 的服務角色)。如果集區不存在，這個指令程式會建立集區和對應的服務 (您可以透過呼叫 Get-CsPool 指令程式，找到現有集區的清單)。
建立新的信任的應用程式集區 (新外部服務) 還會建立指派給該集區之新的信任的應用程式電腦。依預設，會指派與集區相同的完整網域名稱 (FQDN) 給電腦。不過，您可以使用這個指令程式的 ComputerFqdn 參數，指定您自己的 FQDN 值。如果您計畫新增更多電腦至集區，則必須指定與集區 FQDN 不同的 ComputerFqdn 值。若要新增更多電腦至集區，請呼叫 New-CsTrustedApplicationComputer 指令程式。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsTrustedApplicationPool Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsTrustedApplicationPool"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
XdsGlobalRelativeIdentity |
新集區的 FQDN。請注意，用於建立集區的 Identity 值是集區 FQDN，作為 Identity 與新集區一起儲存的值實際上是集區自動產生的服務 ID。此處輸入的 Identity 會儲存為 PoolFqdn。 |
AppSharingPortCount |
選用 |
Uint16 |
連接埠範圍中可用於應用程式共用連線的連接埠數目。 預設值：0 |
AppSharingPortStart |
選用 |
UInt16 |
連接埠範圍中可用於應用程式共用連線的第一個連接埠號碼。 |
AudioPortCount |
選用 |
UInt16 |
連接埠範圍中可用於音訊連線的連接埠數目。 預設值：0 |
AudioPortStart |
選用 |
UInt16 |
連接埠範圍中可用於音訊連線的第一個連接埠號碼。 |
ComputerFqdn |
選用 |
FQDN |
建立信任的應用程式集區會自動建立屬於該集區之信任的應用程式電腦。依預設，電腦會接收與集區相同的 FQDN。在這個參數中輸入值，以指定與集區 FQDN 不同之電腦的 FQDN。如果您計畫新增更多電腦至集區，您必須輸入與集區 FQDN 不同的參數值。 |
OutboundOnly |
選用 |
布林值 |
指定信任的應用程式是否可以起始連線至集區內的伺服器如果您希望由伺服器而非由應用程式起始所有連線，請將這個值設為 True。 預設值：False |
Registrar |
選用 |
字串 |
集區之登錄器服務的服務 ID 或 FQDN。 請注意，雖然這是選擇性選項，但如果您嘗試建立新的信任的應用程式端點 (使用 New-CsTrustedApplicationEndpoint 指令程式)，並指派端點至沒有登錄器相依性的集區，則您會收到錯誤，且無法建立端點。此外，您無法移除與登錄器無關之信任的應用程式集區。 |
RequiresReplication |
選用 |
布林值 |
決定此集區是否需要複寫。如果不需要複寫，請將這個值設為 False。若是 Microsoft Outlook Web Access 和手動佈建的應用程式，通常會將這個參數設為 False。 預設值：True |
Site |
選用 |
字串 |
此集區所在之站台的站台識別碼。呼叫 Get-CsSite 指令程式以擷取站台的 SiteId 內容。請記住，您必須使用 SiteId 內容，而不是站台的 Identity。另外，請勿在 SiteId 前加上 “site:” 字串，只要輸入 SiteId 即可。除此之外，雖然您已經輸入從 Get-CsSite 擷取的 SiteId，不過新受信任應用程式集區的 SiteId 內容將含有站台 Identity。例如，如果站台的 SiteId 為 Main 而站台 Identity 為 site:Redmond1，您必須在呼叫 New-CsTrustedApplicationPool 時輸入 -Site Main，不過後續的 Get-CsTrustedApplicationPool 呼叫會將 SiteId 顯示為 site:Redmond1。 如果在 Identity 中指定的集區已存在，則您不需要指定站台。如果集區不存在，則需要此參數。 |
ThrottleAsServer |
選用 |
布林值 |
設定此參數為 False，將集區內的伺服器和信任的應用程式之間的連線節流為用戶端。相較於將連線節流為伺服器的預設值 True，這樣的連線限制更多。連線節流會限制可同時發生的交易數目。 預設值：True |
TreatAsAuthenticated |
選用 |
布林值 |
決定集區內連線至伺服器之信任的應用程式是否需要驗證。如果信任的應用程式需要驗證，請將此參數設為 False。預設值 True 允許信任的應用程式在已驗證的假設下連線。 預設值：True |
VideoPortCount |
選用 |
UInt16 |
連接埠範圍中可用於視訊連線的連接埠數目。 預設值：0 |
VideoPortStart |
選用 |
Uint16 |
連接埠範圍中可用於視訊連線的第一個連接埠號碼。 |
Force |
選用 |
切換參數 |
隱藏任何會在進行變更之前顯示的確認提示。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。
傳回類型
建立 Microsoft.Rtc.Management.Xds.DisplayExternalServer 類型的物件。
範例
-------------------------- 範例 1 ------------------------
New-CsTrustedApplicationPool -Identity TrustPool.litwareinc.com -Registrar pool0.litwareinc.com -Site Redmond
此範例會建立含有 FQDN TrustPool.litwareinc.com 的新集區。我們使用 Identity 參數來指定新 FQDN。我們使用含有 pool0.litwareinc.com 值的 Registrar 參數，在該 FQDN 上使新集區與登錄器服務產生關聯。最後，我們使用含有 Redmond 值的 Site 參數來指定該集區為 Redmond 站台的一部份。
請注意，儘管 Site 值是 SiteId (可藉由呼叫 Get-CsSite 來加以擷取)，不過站台 Identity 將隨著新受信任應用程式集區一併儲存。例如，如果站台的 Identity 為 site:Redmond1 而 SiteId 為 NA，您必須在呼叫 New-CsTrustedApplicationPool 時將 NA 當做 Site 參數的值。然而，如果您想要在稍後再尋找 NA 站台的所有受信任應用程式集區，您可以在 Where 子句中使用 Identity 值，如下所示：
Get-CsTrustedApplicationPool | Where-Object {$_.SiteId –eq "site:Redmond1"}
-------------------------- 範例 2 ------------------------
New-CsTrustedApplicationPool -Identity TrustPool.litwareinc.com -Registrar Registrar:redmond.litwareinc.com -Site Redmond -ComputerFqdn AppServer.litwareinc.com
範例 2 與範例 1 相同，除了它不指定登錄器服務的 FQDN，而是使用服務識別碼 Registrar:redmond.litwareinc.com。此外，我們已為 ComputerFqdn 參數指定了值。建立集區之後，電腦也會建立在該集區內。依預設，電腦的 FQDN 與集區的 FQDN 相同。我們已為該集區內的電腦指定不同的 FQDN，即 AppServer.litwareinc.com。