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 連絡人物件,可讓呼叫路由傳送至信任的應用程式。此指令程式可以擷取 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 |
要修改之應用程式端點的 Identity (辨別名稱)、SIP 位址或顯示名稱。 |
Filter |
選用 |
字串 |
可讓您篩選 Microsoft Lync Server 2010 的特定屬性來限制傳回的資料。例如,您可以將傳回的資料限制在其顯示名稱或 SIP 位址符合特定萬用字元模式的連絡人。 Filter 參數使用的 Windows PowerShell 篩選語法與 Where-Object 指令程式相同。例如,只傳回已啟用 Enterprise Voice 之連絡人的篩選看起來如下所示:{EnterpriseVoiceEnabled -eq $True},其中 EnterpriseVoiceEnabled 代表 Active Directory 屬性;-eq 代表比較運算子 (等於);$True (內建的 Windows PowerShell 變數) 代表篩選值。 |
ApplicationId |
選用 |
字串 |
適用於您要擷取的端點之受信任應用程式的應用程式 ID。 |
Credential |
選用 |
PSCredential |
可用來擷取端點的替代認證。您可以呼叫 Get-Credential 指令程式來擷取 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 相關聯的所有受信任應用程式端點。這是藉由將 tapp2 這個 ID 傳給 ApplicationId 參數來達成。請注意,我們並未提供集區 FQDN;這表示如果其 ID 為 tapp2 的應用程式存在多個集區上,則會擷取所有這些應用程式的端點。此命令的下一個部分會將傳回的一或多個物件傳送到 Select-Object指令程式,這樣只會顯示這些物件的 SipAddress、DisplayName 及 OwnerUrn 屬性。