Get-CsTrustedApplicationEndpoint

構文

Get-CsTrustedApplicationEndpoint [-Identity <UserIdParameter>] [-ApplicationId <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>] [-TrustedApplicationPoolFqdn <String>]

解説

信頼されたアプリケーション エンドポイントは、信頼されたアプリケーションへの通話ルーティングを有効にする、Active Directory 連絡先オブジェクトです。このコマンドレットは、Active Directory ドメイン サービス (AD DS) 内の 1 つ以上の既存のエンドポイント連絡先オブジェクトに関する情報を取得します。

このコマンドレットを実行できるユーザー: 既定では、次のグループのメンバーが、Get-CsTrustedApplicationEndpoint コマンドレットのローカル実行を承認されています。RTCUniversalUserAdmins、RTCUniversalServerAdmins、RTCUniversalReadOnlyAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsTrustedApplicationEndpoint"}

パラメーター

入力の種類

文字列。ユーザー アカウントの Identity を表す、パイプ処理された文字列値を受け入れます。

戻り値の種類

Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact 型のオブジェクトを取得します。

例

-------------------------- 例 1 ------------------------

Get-CsTrustedApplicationEndpoint

この例では、Lync Server 2010 の展開で定義されているすべての信頼されたアプリケーション エンドポイントに関する情報を取得します。

-------------------------- 例 2 ------------------------

Get-CsTrustedApplicationEndpoint -Identity "sip:endpoint1@litwareinc.com"

例 2 では、endpoint1@litwareinc.com という SIP アドレスを持つアプリケーション エンドポイントの連絡先に関する情報を取得します。sip: プレフィックスは、SIP アドレスを ID として使用する場合に必要です。

-------------------------- 例 3 ------------------------

Get-CsTrustedApplicationEndpoint -Filter {DisplayName -like "*endpoint*"}

例 3 では、表示名のどこかに文字列 "endpoint" を持つ、すべての信頼されたアプリケーション エンドポイントを取得します。この処理を行うため、このコマンドは Filter パラメーターを使用します。このパラメーターの値はフィルター処理され、文字列 endpoint (*endpoint* - ワイルドカード文字は、文字列 endpoint の前または後ろに任意の文字列が存在してよいことを表します。つまり、endpoint は表示名のどこに存在してもかまいません) が含まれる (-like) 表示名 (DisplayName) を持つエンドポイント オブジェクトを見つけます。

-------------------------- 例 4 ------------------------

Get-CsTrustedApplicationEndpoint -ApplicationId tapp2 | Select-Object SipAddress, DisplayName, OwnerUrn

例 4 では、アプリケーション tapp2 に関連付けられているすべての信頼されたアプリケーション エンドポイントを戻します。この処理を実行するため、ID tapp2 を ApplicationId パラメーターに渡します。プールの FQDN は指定しません。つまり、tapp2 という ID を持つアプリケーションが複数のプールに存在している場合は、そのすべてのアプリケーションのエンドポイントを取得します。このコマンドの次の部分は、戻された 1 つ以上のオブジェクトを Select-Object コマンドレットにパイプ処理し、そのオブジェクトの SipAddress、DisplayName、および OwnerUrn プロパティのみを表示します。

関連項目

その他のリソース

New-CsTrustedApplicationEndpoint
Remove-CsTrustedApplicationEndpoint
Set-CsTrustedApplicationEndpoint