New-CsTrustedApplicationEndpoint
上次修改主題的時間： 2012-03-25
建立信任的應用程式的新端點連絡人。
語法
New-CsTrustedApplicationEndpoint -ApplicationId <String> -TrustedApplicationPoolFqdn <Fqdn> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-PrimaryLanguage <String>] [-SecondaryLanguages <MultiValuedProperty>] [-SipAddress <String>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]
詳細描述
信任的應用程式端點是 Active Directory 連絡人物件，可讓呼叫路由傳送至信任的應用程式。這個指令程式會在指定的應用程式的 Active Directory 網域服務 (AD DS) 中建立新端點連絡人物件。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsTrustedApplicationEndpoint Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsTrustedApplicationEndpoint"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
ApplicationId |
必要 |
字串 |
要為其建立端點連絡人的信任的應用程式之應用程式識別碼。具有此識別碼的應用程式必須已經存在。請注意，您只能加入應用程式識別碼的名稱部分，無需加入首碼資訊。例如，如果應用程式識別碼為 urn:application:TrustedApp1，則只需傳遞字串 TrustedApp1 至這個參數。 |
TrustedApplicationPoolFqdn |
必要 |
Fqdn |
與應用程式相關聯的信任應用程式集區的完整網域名稱 (FQDN)。應用程式必須已經和此集區相關聯才能建立端點。 |
SipAddress |
選用 |
字串 |
新連絡人物件的 SIP 位址。如果您沒有加入此參數值，會以格式 sip:RtcApplication-<GUID>.<domain> 自動產生 SIP 位址，例如， sip:RtcApplication-fbf9e2d1-c6aa-45a3-a045-b92d4ef961b2@litwareinc.com。該網域為預設的 SIP 網域。 |
DisplayName |
選用 |
字串 |
端點連絡人物件的顯示名稱。 |
DisplayNumber |
選用 |
字串 |
將在通訊錄中顯示的連絡人電話號碼。 |
LineURI |
選用 |
字串 |
連絡人的電話號碼。格式必須為 TEL:<number>，例如 TEL:+14255551212。 |
PrimaryLanguage |
選用 |
Int32 |
受信任應用程式所使用的主要語言。必須使用有效的語言代碼來設定該語言，例如 en-US (美國英文)、fr-FR (法文) 等等。 |
SecondaryLanguages |
選用 |
Int32[] |
也可用於受信任應用程式的語言集合。必須將值設定為以逗號分隔的語言代碼清單。例如，下列語法可將法文 (加拿大) 和法文設為次要語言：-SecondaryLanguages "fr-CA","fr-FR"。 |
Tenant |
選用 |
GUID |
物件的全域唯一識別碼 (GUID)。這個參數不用於內部部署。 |
PassThru |
選用 |
切換參數 |
傳回此命令的結果。執行此指令程式會顯示新建立的物件；加上此參數只會重複該輸出，導致此參數變得多餘。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。
傳回類型
建立 Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact 類型的物件。
範例
-------------------------- 範例 1 ------------------------
New-CsTrustedApplicationEndpoint -ApplicationId tapp1 -TrustedApplicationPoolFqdn TrustPool.litwareinc.com
這個範例為應用程式識別碼 tapp1 設在 TrustPool.litwareinc.com 集區之應用程式建立信任的應用程式端點。ApplicationID 和 TrustedApplicationPoolFqdn 是唯一需要建立信任的應用程式端點的參數。不過，請記住，只將值指派給這兩個參數會自動產生連絡人的 SIP 位址。為了確保 SIP 位址是唯一的，自動產生位址會加入全域唯一識別碼 (GUID)，如以下範例所示：sip:RtcApplication-fbf9e2d1-c6aa-45a3-a045-b92d4ef961b2@litwareinc.com。如果您希望 SIP 位址更方便讀取，請參閱範例 2。
-------------------------- 範例 2 ------------------------
New-CsTrustedApplicationEndpoint -ApplicationId tapp1 -TrustedApplicationPoolFqdn TrustPool.litwareinc.com -SipAddress sip:endpoint1@litwareinc.com
範例 2 與範例 1 的相同點在於其為應用程式識別碼 tapp1 設在 TrustPool.litwareinc.com 集區之應用程式建立信任的應用程式端點。但與範例 1 不同的是，我們在建立端點時多加了一個參數：SipAddress。我們指定了 endpoint1@litwareinc.com 的位址，而非容許系統產生 SIP 位址。