次の方法で共有

  • [アーティクル]

Get-CsTrustedApplicationEndpoint

 

トピックの最終更新日: 2012-03-23

1 つ以上の信頼されたアプリケーション エンドポイントに関する情報を取得します。

構文

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

省略可能

UserIdParameter

変更するアプリケーション エンドポイントの Identity (識別名)、SIP アドレス、または表示名。

Filter

省略可能

文字列

Microsoft Lync Server 2010 固有の属性をフィルター処理することで、返りデータを制限できます。たとえば、表示名または SIP アドレスが特定のワイルドカードのパターンに一致する連絡先に、返りデータを制限することができます。

Filter パラメーターは、Where-Object コマンドレットと同じ Windows PowerShell フィルター処理構文を使用します。たとえば、エンタープライズ VoIP が有効になっている連絡先のみを戻すフィルターの場合、{EnterpriseVoiceEnabled -eq $True} のようになります。ここで、EnterpriseVoiceEnabled は Active Directory の属性を、-eq は比較演算子 (equal to) を、$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 では、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 プロパティのみを表示します。