Get-CsTrustedApplicationEndpoint
上一次修改主题: 2012-03-23
检索有关一个或多个受信任应用程序终结点的信息。
语法
Get-CsTrustedApplicationEndpoint [-Identity <UserIdParameter>] [-ApplicationId <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>] [-TrustedApplicationPoolFqdn <String>]
详细说明
受信任的应用程序终结点是一个 Active Directory 联系人对象,它允许将呼叫路由至受信任的应用程序。此 cmdlet 可在 Active Directory 域服务 (AD DS) 中检索一个或多个现有终结点联系人对象。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Get-CsTrustedApplicationEndpoint cmdlet:RTCUniversalUserAdmins、RTCUniversalServerAdmins 和 RTCUniversalReadOnlyAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsTrustedApplicationEndpoint"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
可选 |
UserIdParameter |
要修改的应用程序终结点的标识(可分辨名称)、SIP 地址或显示名称。 |
Filter |
可选 |
字符串 |
用于通过筛选 Microsoft Lync Server 2010 的特定属性来限制返回的数据。例如,您可以将返回的数据限制为显示名称或 SIP 地址与某种通配符模式匹配的联系人。 Filter 参数与 Where-Object cmdlet 使用相同的 Windows PowerShell 筛选语法。例如,仅返回已启用企业语音的联系人的筛选器语法如下:{EnterpriseVoiceEnabled -eq $True},其中 EnterpriseVoiceEnabled 代表 Active Directory 属性,-eq 代表比较运算符(等于),$True(内置的 Windows PowerShell 变量)代表筛选器值。 |
ApplicationId |
可选 |
字符串 |
要检索终结点的受信任应用程序的应用程序 ID。 |
Credential |
可选 |
PSCredential |
用于检索终结点的备用凭据。可以通过调用 Get-Credential cmdlet 检索 PSCredential 对象。 |
DomainController |
可选 |
Fqdn |
用于指定域控制器。如果未指定域控制器,将使用第一个可用的域控制器。 |
OU |
可选 |
OUIdParameter |
终结点所在的 OU。 |
ResultSize |
可选 |
无限制 |
要检索的终结点记录的最大数量。 |
TrustedApplicationPoolFqdn |
可选 |
字符串 |
与要检索终结点的应用程序相关联的受信任应用程序池的完全限定域名 (FQDN)。 |
输入类型
字符串。接受通过管道传递的代表用户帐户 Identity 的字符串值。
返回类型
检索一个类型为 Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact 的对象。
示例
-------------------------- 示例 1 --------------------------
Get-CsTrustedApplicationEndpoint
此示例检索有关在 Lync Server 2010 部署内定义的所有受信任应用程序终结点的信息。
-------------------------- 示例 2 --------------------------
Get-CsTrustedApplicationEndpoint -Identity "sip:endpoint1@litwareinc.com"
示例 2 检索有关 SIP 地址为 endpoint1@litwareinc.com 的应用程序终结点联系人的信息。请注意,将 SIP 地址用作 Identity 时,需要使用 sip: 前缀。
-------------------------- 示例 3 --------------------------
Get-CsTrustedApplicationEndpoint -Filter {DisplayName -like "*endpoint*"}
示例 3 检索显示名称中包含字符串“endpoint”的所有受信任应用程序终结点。为此,该命令使用了 Filter 参数。该参数的值通过筛选找到显示名称 (DisplayName) 包含 (-like) 字符串终结点的终结点对象(*endpoint* - 该通配符指示在字符串终结点前后可以出现任意字符,即终结点可以位于显示名称中的任意位置)。
-------------------------- 示例 4 --------------------------
Get-CsTrustedApplicationEndpoint -ApplicationId tapp2 | Select-Object SipAddress, DisplayName, OwnerUrn
示例 4 将返回与应用程序 tapp2 相关联的所有受信任应用程序终结点。这是通过将 ID tapp2 传递给 ApplicationId 参数实现的。请注意,我们未提供 FQDN 池;这意味着如果在多个池中存在 ID 为 tapp2 的应用程序,则将检索所有这些应用程序的终结点。该命令的下一部分将返回的一个或多个对象通过管道传递到 Select-Object cmdlet,后者将仅显示这些对象的 SipAddress、DisplayName 和 OwnerUrn 属性。