Get-MailContact (RTM)

  • [アーティクル]

 

適用先: Exchange Server 2007

トピックの最終更新日: 2007-06-05

Get-MailContact コマンドレットを使用して、指定した連絡先のすべての属性を Active Directory から取得します。

構文

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

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

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

解説

このコマンドレットは、指定した連絡先のすべての属性を取得します。必須パラメータはありません。パラメータを指定せずにこのコマンドレットを実行すると、Exchange 組織の連絡先の完全な一覧が返されます。

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

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

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

パラメータ

パラメータ 必須 種類 説明

ANR

省略可能

System.String

指定したパラメータが、あいまいな名前の解決 (ANR) を使用して解決されます。既定で検索対象となっているのは、以下の属性です。

  • CommonName (CN)
  • DisplayName (displayName)
  • FirstName (givenName)
  • LastName (sn)
  • Alias (mailNickname)
  • LegacyExchangeDN (legacyExchangeDN)
  • Name (name) (CommonName/CN の代わり)
  • EmailAddresses (proxyAddresses)
  • SamAccountName (samAccountName)
  • Office (physicalDeliveryOfficeName)

Credential

省略可能

System.Management.Automation.PSCredential

このパラメータには、Active Directory へのアクセスに使用するアカウントを指定します。

Credential パラメータを使用した場合は、続行するためにアカウントのパスワードの入力を求められます。

DomainController

省略可能

Microsoft.Exchange.Data.Fqdn

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

Filter

省略可能

System.String

このパラメータは、返された受信者の一覧をフィルタ処理するために使用します。フィルタ処理する属性を指定できます。

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

Identity

省略可能

Microsoft.Exchange.Configuration.Tasks.MailContactIdParameter

このパラメータは、連絡先を識別します。連絡先の ADObjectID、識別名、LegacyExchangeDN、GUID、ドメイン\SamAccountName、ユーザー プリンシパル名 (UPN)、電子メール アドレス、またはエイリアスを指定できます。

OrganizationalUnit

省略可能

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

このパラメータは、結果を特定のコンテナに限定する際に使用します。組織単位 (OU) かドメインのどちらかを指定できます。また、正規名を指定する必要があります。以下に例を示します。

  • OU: westcoast.contoso.com/users
  • ドメイン : westcoast.contoso.com

ReadFromDomainController

省略可能

System.Management.Automation.SwitchParameter

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

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

RecipientTypeDetails

省略可能

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

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

このコマンドレットで利用できる受信者タイプの詳細を以下に示します。

  • MailEnabledContact
  • MailEnabledForestContact

ResultSize

省略可能

Microsoft.Exchange.Data.Unlimited

このパラメータは、返される受信者オブジェクトの合計数を指定します。指定しない場合は、フィルタに一致するすべての結果が返されます。

SortBy

省略可能

System.String

このパラメータには、結果の並べ替えに使用する属性を指定します。並べ替えは一度に 1 つの属性によって行われ、常に昇順で並べ替えられます。

入力の種類

戻り値の種類

エラー

エラー 説明

例外

例外 説明

例

この例では、Get-MailContact コマンドを使用して、メールが有効な Ted という連絡先を取得しています。

Get-MailContact -Identity Ted | Format-List

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