Get-UMMailbox (RTM)

  • [アーティクル]

 

適用先: Exchange Server 2007

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

Get-UMMailbox コマンドレットは、ユニファイド メッセージング (UM) が有効な受信者の UM のプロパティを表示します。

構文

Get-UMMailbox [-Identity <MailboxIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

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

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

解説

Get-UMMailbox コマンドレットは、単一の UM メールボックスの UM プロパティを取得します。また、UM が有効なメールボックスの一覧を取得することもできます。

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

  • Exchange 受信者管理者の役割

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

パラメータ

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

Anr

省略可能

System.String

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

  • CommonName (CN)
  • DisplayName
  • FirstName
  • LastName
  • Alias

Credential

省略可能

System.Management.Automation.PSCredential

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

DomainController

省略可能

Microsoft.Exchange.Data.Fqdn

この構成の変更を Active Directory ディレクトリ サービスに書き込むドメイン コントローラの完全修飾ドメイン名を指定するには、コマンドレットに DomainController パラメータを含めます。

Filter

省略可能

System.String

このパラメータを使用すると、コマンドレットによって返される結果にフィルタを適用できます。

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

Identity

省略可能

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

このパラメータには、ユニファイド メッセージングを有効にするユーザーを指定します。このパラメータの変数は以下のとおりです。

  • ADObjectID
  • GUID
  • DN
  • ドメイン\アカウント
  • UPN
  • LegacyExchangeDN
  • SmtpAddress
  • Alias

Instance パラメータを使用しない場合は、このパラメータが必要になります。

OrganizationalUnit

省略可能

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

このパラメータには、組織単位 (OU) を指定します。結果を限定する場合に使用します。このパラメータを使用すると、指定したコンテナに存在するメールボックスのみが取得されます。OU またはドメイン名を使用できます。OU を使用する場合は、その OU の正規の名前を指定する必要があります。

ReadFromDomainController

省略可能

System.Management.Automation.SwitchParameter

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

ResultSize

省略可能

Microsoft.Exchange.Data.Unlimited

このパラメータを使用して、返される結果の最大件数を指定できます。最大件数を指定しない場合、コマンドレットはすべての結果を返します。

SortBy

省略可能

System.String

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

  • Alias
  • DisplayName
  • Name

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

入力の種類

種類 説明

 

 

戻り値の種類

種類 説明

 

 

エラー

エラー 説明

 

 

例

最初のコード例は、Active Directory フォレスト内の UM が有効なメールボックスすべてを、書式化された一覧で表示します。

2 番目のコード例は、yanli@contoso.com の UM メールボックス プロパティを表示します。

Get-UMMailbox | format-list

Get-UMMailbox -Identity yanli@contoso.com

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