Get-CsAdContact

構文

Get-CsAdContact [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-LDAPFilter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]

解説

複数フォレスト トポロジで、他のフォレストのユーザーは連絡先として表されます。これらの連絡先は Active Directory の連絡先とは同じではありません。[Active Directory ユーザーとコンピューター] を使用して新しい連絡先を作成すると、Get-CsAdContact コマンドレットによって、そのユーザーは戻されません。代わりに Get-CsAdContact では、ホーム フォレスト以外のフォレストのユーザーの情報が戻されるだけです。複数フォレスト トポロジを使用していない場合は、Get-CsAdContact を呼び出す必要はありません

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

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

パラメーター

入力の種類

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

戻り値の種類

Get-CsAdContact を実行すると、Microsoft.Rtc.Management.ADConnect.Schema.ADContact オブジェクトのインスタンスが戻されます。

例

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

Get-CsAdContact

例 1 に示すコマンドでは、Active Directory ドメイン サービス (AD DS) に存在するすべての複数フォレストの連絡先のコレクションを戻しています。追加のパラメーターを使用しないで Get-CsAdContact を呼び出すと、すべての Active Directory の連絡先のすべてのプロパティの値が戻されます。

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

Get-CsAdContact | Select-Object DisplayName, SipAddress

例 2 でも、すべての Active Directory の連絡先のコレクションを戻しています。ただしこの場合は、そのコレクションを Select-Object コマンドレットにパイプ処理し、画面に表示される次の 2 つの属性のみ指定します。DisplayName および SipAddress です。

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

Get-CsAdContact -Identity "Ken Myer"

上記のコマンドでは、次に示す 1 つの Active Directory の連絡先の情報を戻しています。Identity が "Ken Myer" の連絡先です。

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

Get-CsAdContact -LdapFilter "Organization=Fabrikam"

例 4 のコマンドでは、Fabrikam に勤務しているすべての Active Directory の連絡先を戻しています。これを行うため、Get-CsAdContact に LdapFilter パラメーターを指定して呼び出します。この例では、Organization 属性が "Fabrikam" に設定されている連絡先のみに戻りデータを限定しています。

-------------------------- 例 5 ------------------------

$x = Get-Credential -Credential "litwareinc\administrator"
Get-CsAdContact -Credential $x

例 5 に示す 2 つのコマンドでは Credential パラメーターを使用しており、これにより別の資格情報で Get-CsAdContact を実行できます。最初のコマンドでは、Get-Credential コマンドレットを呼び出し、アカウント litwareinc\administrator に対して PSCredential オブジェクトを作成しています。このコマンドでは、ユーザー litwareinc\administrator に対する [資格情報の要求] ダイアログ ボックスが表示されます。このアカウントのパスワードを入力すると、その資格情報が変数 $x に格納されます。2 番目のコマンドでは、Get-CsAdContact に Credential パラメーターを指定して呼び出します。パラメーター値 $x は、アカウント litwareinc\administrator の下で Get-CsAdContact を実行することを示します。

関連項目

その他のリソース

Get-CsAdUser
Get-CsUser