Get-Mailbox

  • [アーティクル]

 

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

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

メールボックスのオブジェクトおよび属性を表示したり、プロパティ ページを作成したり、メールボックス情報を他のタスクに提供したりするには、Get-Mailbox コマンドレットを使用します。

構文

get-Mailbox [-Identity <MailboxIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-Mailbox [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>] [-SortBy <String>]

get-Mailbox [-Credential <PSCredential>] [-Database <DatabaseIdParameter>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

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

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

解説

Get-Mailbox コマンドレットは、メールボックスの属性およびオブジェクトを取得します。必須パラメータはありません。パラメータを指定しないでこのコマンドレットを使用すると、組織にあるすべてのメールボックスが一覧表示されます。

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

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

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

note注 :
Get-Mailbox コマンドレットを使用して現在の格納域の制限の状態を正確に評価するには、ProhibitSendQuota、ProhibitSendReceiveQuota、および IssueWarningQuota プロパティに加えて UseDatabaseQuotaDefaults プロパティを確認する必要があります。UseDatabaseQuotaDefaults プロパティの値が True の場合は、メールボックスごとの設定が無視され、メールボックス データベースの制限が使用されることを意味します。このプロパティが True に設定されていて、ProhibitSendQuota、ProhibitSendReceiveQuota、IssueWarningQuota の各プロパティが unlimited (無制限) に設定されている場合、メールボックスのサイズは無制限ではありません。メールボックスに対する制限を確認するには、代わりにメールボックス データベースの格納域に関する制限を参照する必要があります。UseDatabaseQuotaDefaults プロパティの値が False の場合は、メールボックスごとの設定が使用されることを意味します。

パラメータ

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

Anr

省略可能

System.String

Anr パラメータには、あいまいな名前の解決 (ANR) の検索を実行する際に使用する文字列を指定します。部分的な文字列を指定して、その文字列に一致する属性を持つオブジェクトを検索することができます。検索される既定の属性は次のとおりです。

  • CommonName (CN)
  • DisplayName
  • FirstName
  • LastName
  • エイリアス

Credential

省略可能

System.Management.Automation.PSCredential

Credential パラメータには、Active Directory ディレクトリ サービスへのアクセスに使用するユーザー名とパスワードを指定します。

Database

省略可能

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

Database パラメータには、メールボックスの取得元のデータベースを指定します。次の値を使用できます。

  • データベースの GUID
  • データベース名
  • <サーバー名>\<データベース名>
  • <サーバー名>\<ストレージ グループ>\<データベース名>

サーバー名を指定しない場合、コマンドレットはローカル サーバー上でデータベースを検索します。同じサーバー上に同じ名前で複数のデータベースがある場合は、ストレージ グループを指定する必要があります。

このパラメータを Filter パラメータと共に使用することはできません。

DomainController

省略可能

Microsoft.Exchange.Data.Fqdn

DomainController パラメータには、Active Directory へのアクセスに使用するドメイン コントローラを指定します。使用するドメイン コントローラの完全修飾ドメイン名 (FQDN) を使用します。

Filter

省略可能

System.String

Filter パラメータには、クエリによって返されるメールボックスを制限するために使用される属性を 1 つ以上指定します。

このパラメータを Database パラメータと共に使用することはできません。

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

Identity

省略可能

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

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) を指定します。結果を限定する場合に使用します。このパラメータを使用すると、指定したコンテナに存在するメールボックスのみが取得されます。OU またはドメイン名を使用できます。OU を使用する場合は、その 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 が RoomMailbox に設定され、ユーザー メールボックスは RecipientTypeDetails が UserMailbox に設定されます。

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

  • RoomMailbox
  • EquipmentMailbox
  • LegacyMailbox
  • LinkedMailbox
  • UserMailbox
  • SharedMailbox

ResultSize

省略可能

Microsoft.Exchange.Data.Unlimited

ResultSize パラメータには、返される結果の最大件数を指定します。クエリに一致するメールボックスがすべて返されるようにする場合は、このパラメータの値に "unlimited" を使用します。既定値は 1,000 です。

Server

省略可能

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Server パラメータには、個々のサーバーを指定します。結果を限定する場合に使用します。このパラメータを使用すると、指定したサーバーに存在するメールボックスのみが取得されます。指定するサーバーの共通名を使用してください。

SortBy

省略可能

System.String

SortBy パラメータには、結果の並べ替えに使用する属性を指定します。並べ替えることができるのは、一度に 1 つの属性のみです。次の属性で並べ替えることができます。

  • エイリアス
  • 表示名
  • 名前

結果は昇順で並べ替えられます。

入力の種類

戻り値の種類

エラー

エラー 説明

 

例外

例外 説明

 

例

最初の例では、組織に存在するすべてのメールボックスの一覧を取得する方法を示しています。

2 つ目の例では、組織の Contoso.com ドメインの Users コンテナに存在するすべてのメールボックスの一覧を取得する方法を示しています。

3 つ目の例では、DC01 というドメインに存在するメールボックスのうち、文字列 "Chr" であいまいな名前を解決する検索を実行した結果解決されたすべてのメールボックスの一覧を取得する方法を示しています。Chris Ashton、Christian Cletus、Christa Geller などのユーザーのメールボックスが返されます。

Get-Mailbox -ResultSize unlimited
Get-Mailbox -OrganizationalUnit Users
Get-Mailbox -Anr Chr -DomainController DC01

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