Get-Contact

  • [アーティクル]

 

適用先: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

トピックの最終更新日: 2010-04-27

指定した連絡先の情報を取得するには、Get-Contact コマンドレットを使用します。

構文

Get-Contact [-Identity <ContactIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Get-Contact [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Get-Contact [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

解説

Get-Contact コマンドレットは、Active Directory ディレクトリ サービス内の特定の連絡先または連絡先の受信者オブジェクトのプロパティを照会します。

Get-Contact コマンドレットを実行するには、使用するアカウントに次の権限が委任されている必要があります。

  • Exchange 表示専用管理者の役割

Exchange Server 2007 を管理するために必要なアクセス許可、役割の委任、および権限の詳細については、「アクセス許可に関する考慮事項」を参照してください。

パラメータ

パラメータ 必須かどうか 種類 説明

Anr

省略可能

System.String

Anr パラメータは、文字列の一部を指定してそれに一致するオブジェクトを検索する場合に使用します。ワイルドカード文字を使用する検索と似ています。

Credential

省略可能

System.Management.Automation.PSCredential

Credential パラメータには、連絡先の資格情報について Active Directory に照会するために使用するアカウントを指定します。

DomainController

省略可能

Microsoft.Exchange.Data.Fqdn

Active Directory からデータを取得するドメイン コントローラの完全修飾ドメイン名 (FQDN) を指定するには、コマンドに DomainController パラメータを含めます。

Filter

省略可能

System.String

Filter パラメータには、クエリによって返される受信者を限定するために使用する一連の属性を指定します。

フィルタ可能なプロパティの詳細については、「-Filter パラメータのフィルタ可能なプロパティ」を参照してください。

Identity

省略可能

Microsoft.Exchange.Configuration.Tasks.ContactIdParameter

Identity パラメータには、次のいずれかの値を指定します。

  • GUID
  • 識別名 (DN)
  • ドメイン\アカウント
  • ユーザー プリンシパル名 (UPN)
  • LegacyExchangeDN
  • SMTP (簡易メール転送プロトコル) アドレス
  • エイリアス

IgnoreDefaultScope

省略可能

System.Management.Automation.SwitchParameter

IgnoreDefaultScope パラメータは、Exchange 管理シェルに対する既定の受信者の設定範囲を無視し、範囲としてフォレスト全体を使用するようにコマンドに指示します。これにより、コマンドは現在既定の範囲内にない Active Directory オブジェクトにアクセスできます。IgnoreDefaultScope パラメータを使用する場合、以下の制限事項が適用されます。

  • DomainController パラメータは使用できません。コマンドによって、適切なグローバル カタログ サーバーが自動的に使用されます。
  • Identity パラメータには DN のみを使用できます。エイリアスや GUID など、他の形式の ID は許可されません。
  • OrganizationalUnit パラメータと Identity パラメータは同時に使用できません。
  • Credential パラメータは使用できません。

OrganizationalUnit

省略可能

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

OrganizationalUnit パラメータを指定すると、指定した組織単位 (OU) からのみオブジェクトが返されます。

ReadFromDomainController

省略可能

System.Management.Automation.SwitchParameter

ReadFromDomainController パラメータには、ユーザー情報がユーザーのドメインのドメイン コントローラから読み取られることを指定します。フォレスト内のすべての受信者を含めるように受信者の範囲を設定した場合、このパラメータを使用しないと、情報が古いグローバル カタログからユーザー情報が読み取られる可能性があります。このパラメータを使用する場合は、情報を取得するために読み取りが数回必要になる場合があります。

note注 :
既定では、受信者の範囲は、Exchange サーバーをホストするドメインに設定されています。

RecipientTypeDetails

省略可能

Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[]

RecipientTypeDetails パラメータには、返される受信者の種類を指定します。Microsoft Exchange Server 2007 の受信者の種類は、受信者の種類とサブタイプに分かれています。各受信者の種類には、すべてのサブタイプに共通するすべてのプロパティが含まれています。たとえば、UserMailbox は、関連付けられたメールボックスを持つ Active Directory のユーザー アカウントを表します。メールボックスには種類が複数あるため、各メールボックスの種類は RecipientTypeDetails パラメータによって識別されます。たとえば、会議室メールボックスは RecipientTypeDetails が ConferenceRoomMailbox に設定され、ユーザー メールボックスは RecipientTypeDetails が UserMailbox に設定されます。

このコマンドで使用できる受信者の種類の詳細を次に示します。

  • Contact
  • MailEnabledContact
  • MailEnabledForestContact

ResultSize

省略可能

Microsoft.Exchange.Data.Unlimited

ResultSize パラメータには、返される結果の最大件数を指定します。

SortBy

省略可能

System.String

SortBy パラメータには、単一の属性の昇順で並べ替えることを指定します。

入力の種類

戻り値の種類

エラー

エラー 説明

 

 

例外

例外 説明

 

例

この例では、Get-Contact コマンドは連絡先 Ted Bremer を取得し、オブジェクトをパイプライン処理して Format-List コマンドに渡し、連絡先に関する情報を表示します。

Get-Contact -Identity TedBremer | Format-List

参照している情報が最新であることを確認したり、他の Exchange Server 2007 ドキュメントを見つけたりするには、Exchange Server TechCenter を参照してください。