Get-MoveRequest

モジュール:

ExchangePowerShell

適用対象:

Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。

Get-MoveRequest コマンドレットは、New-MoveRequest コマンドレットを使用して開始され進行中の非同期のメールボックス移動に関する詳細な状態を表示します。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

Get-MoveRequest
   [[-Identity] <MoveRequestIdParameter>]
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [-IncludeSoftDeletedObjects]
   [-ProxyToMailbox <MailboxIdParameter>]
   [<CommonParameters>]

Get-MoveRequest
   [-BatchName <String>]
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-Flags <RequestFlags>]
   [-HighPriority <Boolean>]
   [-IncludeSoftDeletedObjects]
   [-MoveStatus <RequestStatus>]
   [-Offline <Boolean>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-Protect <Boolean>]
   [-ProxyToMailbox <MailboxIdParameter>]
   [-RemoteHostName <Fqdn>]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [-SourceDatabase <DatabaseIdParameter>]
   [-Status <RequestStatus>]
   [-Suspend <Boolean>]
   [-SuspendWhenReadyToComplete <Boolean>]
   [-TargetDatabase <DatabaseIdParameter>]
   [<CommonParameters>]

説明

Get-MoveRequest コマンドレットの検索条件はブール型の And ステートメントです。 複数のパラメーターを使用すると、検索が絞り込まれて、検索結果の数が少なくなります。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例

例 1

Get-MoveRequest -Identity 'tony@contoso.com'

次の使用例は、Tony Smith のメールボックス (tony@contoso.com) の進行中のメールボックス移動の状態を取得します。

例 2

Get-MoveRequest -MoveStatus InProgress -TargetDatabase DB05

この例は、ターゲット データベース DB05 に対して進行中のメールボックス移動の状態を取得します。

例 3

Get-MoveRequest -BatchName "FromDB01ToDB02" -MoveStatus CompletedWithWarning

この例は、完了したものの警告が発生した FromDB01ToDB02 というバッチ内の移動要求について、その状態を取得します。

パラメーター

-BatchName

BatchName パラメーターは、バッチ移動要求に付けられた名前を指定します。

データベース名

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Credential

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

Credential パラメーターは、このコマンドの実行に使用されるユーザー名とパスワードを指定します。 通常、このパラメーターはスクリプトや、必要なアクセス許可を持つ別の資格情報を入力する必要がある場合に使用します。

このパラメーターの値には、Get-Credential コマンドレットが必要です。 このコマンドを一時停止し、資格情報の入力を求めるメッセージを表示するには、値(Get-Credential)を使用します。 または、このコマンドを実行する前に、資格情報を変数 (たとえば、$cred = Get-Credential) に保存し、このパラメーターに変数名 ($cred) を使用します。 詳細については、Get-Credentialに関するページをご覧ください。

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Flags

Flags パラメーターは、情報を取得する移動の種類を指定します。 次の値を使用できます。

• CrossOrg
• HighPriority
• IntraOrg
• 参加
• MoveOnlyArchiveMailbox
• MoveOnlyPrimaryMailbox
• None
• オフライン
• Protected
• プル
• プッシュ
• RemoteLegacy
• Split
• 中断
• SuspendWhenReadyToComplete
• TargetIsAggregatedMailbox

Type:	RequestFlags
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-HighPriority

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

HighPriority パラメーターは、コマンドレットが HighPriority フラグを使用して作成された要求を返すことを指定します。 HighPriority フラグは、キューにある優先度が低い他の要求より前にその要求を処理することを示します。

データベース名

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Identity パラメーターは、メールボックスまたはメール ユーザーの ID である移動要求の ID を指定します。 メールボックス、またはメール ユーザーを一意に識別する任意の値を使用できます。 例:

• 名前
• Alias
• 識別名 (DN)
• 正規 DN
• Domain\Username
• 電子メール アドレス
• GUID
• LegacyExchangeDN
• SamAccountName
• ユーザー ID またはユーザー プリンシパル名 (UPN)

このパラメーターは、次のパラメーターと併用できます。

• Batchname
• HighPriority
• MoveStatus
• オフライン
• 保護
• RemoteHostName
• SourceDatabase
• 中断
• SuspendWhenReadyToComplete
• TargetDatabase

Type:	MoveRequestIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IncludeSoftDeletedObjects

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

IncludeSoftDeletedObjects パラメーターは、回復可能な削除によって削除されたメールボックスを返すかどうかを指定します。 このパラメーターには $true または $false を指定できます。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MoveStatus

MoveStatus パラメーターは、指定された状態にある移動要求を返します。 次の値を使用できます。

• AutoSuspended
• 完了
• CompletedWithWarning
• CompletionInProgress
• 失敗
• InProgress
• キューに登録済み
• 再試行
• 中断

データベース名

Type:	RequestStatus
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Offline

Offline パラメーターは、オフライン モードに移動されるメールボックスを返すかどうかを指定します。 このパラメーターには $true または $false を指定できます。

データベース名

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-OrganizationalUnit

OrganizationalUnit パラメーターは、Active Directory 内のオブジェクトの場所に基づいて結果をフィルタリングします。 指定された場所に存在するオブジェクトのみが返されます。 このパラメーターの有効な入力値は、Get-OrganizationalUnit コマンドレットによって返される組織単位 (OU) またはドメインです。 OU またはドメインを一意に識別する、任意の値を使用できます。 以下に例を示します。

• 名前
• 識別名 (DN)
• 識別名 (DN)
• GUID

Type:	OrganizationalUnitIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Protect

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

Protect パラメーターは、保護モードで移動中のメールボックスを返します。 このパラメーターには $true または $false を指定できます。

データベース名

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ProxyToMailbox

このパラメーターは、クラウドベースのサービスでのみ使用できます。

ProxyToMailbox パラメーターは、指定されたメールボックスの場所によって結果をフィルター処理します (プロキシとも呼ばれます)。 メールボックスを一意に識別する任意の値を使用できます。 次に例を示します。

• 名前
• Alias
• 識別名 (DN)
• 正規 DN
• Domain\Username
• 電子メール アドレス
• GUID
• LegacyExchangeDN
• SamAccountName
• ユーザー ID またはユーザー プリンシパル名 (UPN)

Type:	MailboxIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-RemoteHostName

RemoteHostName パラメーターは、メールボックスの移動元となるフォレスト間組織の完全修飾ドメイン名を指定します。

データベース名

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ResultSize

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

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SortBy

SortBy パラメーターは、結果を並べ替えるためのプロパティを指定します。 並べ替えの基準にできるのは、一度に 1 つのプロパティのみです。 結果は昇順で並べ替えられます。

既定のビューに並べ替えるプロパティが含まれていない場合は、 コマンドを で | Format-Table -Auto Property1,Property2,...PropertyX追加できます。 をクリックして、表示するすべてのプロパティを含む新しいビューを作成します。 プロパティ名にはワイルドカード (*) がサポートされています。

以下のプロパティで並べ替えることができます。

• 名前
• DisplayName
• Alias

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SourceDatabase

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

SourceDatabase パラメーターは、指定したソース メールボックス データベースから移動されているすべてのメールボックスを返します。 データベースを一意に識別する、任意の値を使用できます。 以下に例を示します。

• 名前
• 識別名 (DN)
• GUID

データベース名

Type:	DatabaseIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Status

このパラメーターは、クラウドベースのサービスでのみ使用できます。

Status パラメーターは、状態によって結果をフィルター処理します。 有効な値は次のとおりです。

• AutoSuspended
• 完了
• CompletedWithSkippedItems
• CompletedWithWarning
• CompletionInProgress
• 失敗
• InProgress
• キューに登録済み
• 再試行
• 中断
• 同期済み

Type:	RequestStatus
Aliases:	MoveStatus
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-Suspend

Suspend パラメーターは、移動処理が中断されたメールボックスを返すかどうかを指定します。 このパラメーターには $true または $false を指定できます。

データベース名

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SuspendWhenReadyToComplete

SuspendWhenReadytoComplete パラメーターは、New-MoveRequest コマンドおよびその SuspendWhenReadyToComplete スイッチを使用して移動したメールボックスを返すかどうかを指定します。 このパラメーターには $true または $false を指定できます。

データベース名

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-TargetDatabase

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

TargetDatabase パラメーターは、指定したターゲット メールボックス データベースに移動されているすべてのメールボックスを返します。 データベースを一意に識別する、任意の値を使用できます。 以下に例を示します。

• 名前
• 識別名 (DN)
• GUID

データベース名

Type:	DatabaseIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

入力

Input types

このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。

出力

Output types

このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。