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 联系人对象，它允许将呼叫路由至受信任的应用程序。此 cmdlet 在 Active Directory 域服务 (AD DS) 中为指定的应用程序创建新的终结点联系人对象。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 New-CsTrustedApplicationEndpoint cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsTrustedApplicationEndpoint"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
ApplicationId |
必需 |
字符串 |
要为之创建终结点联系人的受信任应用程序的应用程序 ID。必须已存在具有此 ID 的应用程序。请注意，可以仅包含应用程序 ID 的名称部分，而无需（但可以）包含前缀信息。例如，如果应用程序 ID 为 urn:application:TrustedApp1，您只需将字符串 TrustedApp1 传递给此参数。 |
TrustedApplicationPoolFqdn |
必需 |
Fqdn |
与应用程序相关联的受信任应用程序池的完全限定域名 (FQDN)。为了创建终结点，应用程序必须已与该池相关联。 |
SipAddress |
可选 |
字符串 |
新联系人对象的 SIP 地址。如果未包含此参数的值，则将以 sip:RtcApplication-<GUID>.<域> 格式自动生成 SIP 地址，例如 sip:RtcApplication-fbf9e2d1-c6aa-45a3-a045-b92d4ef961b2@litwareinc.com。此域将为默认的 SIP 域。 |
DisplayName |
可选 |
字符串 |
终结点联系人对象的显示名称。 |
DisplayNumber |
可选 |
字符串 |
要在通讯簿中显示的联系人的电话号码。 |
LineURI |
可选 |
字符串 |
联系人的电话号码。必须采用 TEL:<号码> 格式，例如 TEL:+14255551212。 |
PrimaryLanguage |
可选 |
Int32 |
用于受信任应用程序的主要语言。必须使用有效的语言代码配置该语言，如 en-US（美国英语）、fr-FR（法语）等。 |
SecondaryLanguages |
可选 |
Int32[] |
可用于受信任应用程序的语言集合。必须将值配置为以逗号分隔的语言代码的值列表。例如，以下语法将加拿大法语和法语设置为辅助语言：-SecondaryLanguages "fr-CA","fr-FR"。 |
Tenant |
可选 |
GUID |
对象的全局唯一标识符 (GUID)。此参数不用于内部部署。 |
PassThru |
可选 |
开关参数 |
返回此命令的结果。运行此 cmdlet 将显示新创建的对象；包含此参数只会重复该输出，使得对此参数的使用变得多余。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。
返回类型
创建一个类型为 Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact 的对象。
示例
-------------------------- 示例 1 --------------------------
New-CsTrustedApplicationEndpoint -ApplicationId tapp1 -TrustedApplicationPoolFqdn TrustPool.litwareinc.com
此示例为应用程序 ID 为 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
与示例 1 相同，示例 2 也为应用程序 ID 为 tapp1、由 TrustPool.litwareinc.com 池托管的应用程序创建一个受信任的应用程序终结点。但与示例 1 不同的是，在创建终结点时多包含一个参数：SipAddress。我们将地址指定为 endpoint1@litwareinc.com，而不允许系统生成 SIP 地址。