Get-PublicFolderMailboxMigrationRequest
このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターと設定は、1 つの環境または他の環境に限定される場合があります。
New-MigrationBatch コマンドレットを使用して作成したパブリック フォルダー移行バッチに含まれる個々のジョブの状態を表示するには、Get-PublicFolderMailboxMigrationRequest コマンドレットを使用します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Filtering
Get-PublicFolderMailboxMigrationRequest
[-BatchName <String>]
[-DomainController <Fqdn>]
[-HighPriority <Boolean>]
[-Name <String>]
[-RequestQueue <DatabaseIdParameter>]
[-ResultSize <Unlimited>]
[-Status <RequestStatus>]
[-Suspend <Boolean>]
[<CommonParameters>]
Identity
Get-PublicFolderMailboxMigrationRequest
[[-Identity] <PublicFolderMailboxMigrationRequestIdParameter>]
[-DomainController <Fqdn>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
説明
既定では、Get-PublicFolderMailboxMigrationRequest コマンドレットは次のプロパティを表示します。
- 名前: 特定のメールボックス移行ジョブにシステムによって割り当てられた名前。
- TargetMailbox: 移行するメールボックス。
- 状態: ジョブの現在の状態。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事ではコマンドレットのすべてのパラメーターを一覧表示しますが、割り当てられたアクセス許可にパラメーターが含まれていない場合は、一部のパラメーターにアクセスできない可能性があります。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Get-PublicFolderMailboxMigrationRequest
この例では、すべて移行要求に関する情報を返します。
例 2
Get-PublicFolderMailboxMigrationRequest -HighPriority $true
オンプレミスの Exchange では、この例では、優先度の値が High、High、Highest、Emergency のすべての移行要求を返します。
例 3
Get-PublicFolderMailboxMigrationRequest | ?{$_.TargetMailbox -eq $null}
次の使用例は、ターゲット メールボックスを持たないパブリック フォルダー メールボックスの移行要求を返します。
例 4
Get-PublicFolderMailboxMigrationRequest | group TargetMailbox |?{$_.Count -gt 1}
次の使用例は、重複するパブリック フォルダー移行要求 (同じターゲット メールボックスに対して作成された要求) を返します。 コマンドが結果を返さない場合、重複する移行要求はありません。
パラメーター
-BatchName
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
BatchName パラメーターは、バッチ ジョブの作成時に割り当てられたフレンドリ BatchName 値によって結果をフィルター処理します。 この値の形式は、 MigrationService:<Batch name provided at batch creation>です。
データベース名
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Filtering
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DomainController
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
パラメーターのプロパティ
| 型: | Fqdn |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-HighPriority
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
HighPriority パラメーターは、要求の作成時に割り当てられた Priority 値に基づいて結果をフィルター処理します。 このパラメーターの有効な入力値は、$true または $false です。 これらの値によって結果がフィルター処理される方法を次に示します。
- $true 優先度の値が [高]、[高]、[最高]、または [緊急] で作成された要求を返します。
- $false Priority 値 Normal、Low、Lower、Lowest で作成された要求を返します。
データベース名
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Filtering
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Identity パラメーターは、表示するパブリック フォルダー メールボックス移行要求を指定します。 この値では、 \PublicFolderMailboxMigration<GUID> ( \PublicFolderMailboxMigrationac6d9eb4-ee49-405f-b90d-04e9a258bd7e など) という構文が使用されます。
このパラメーターは、次のパラメーターと併用できません。
- BatchName
- HighPriority
- Name
- RequestQueue
- 停止する
- 状態
注意: Identity パラメーターの値$null値または存在しない値は、Identity パラメーターなしで Get- コマンドを実行したかのように 、すべての オブジェクトを返します。 Identity パラメーターの値の一覧が正確であり、存在しない$null値が含まれていないことを確認します。
パラメーターのプロパティ
| 型: | PublicFolderMailboxMigrationRequestIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Identity
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Name
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Name パラメーターは、パブリック フォルダー メールボックスの移行要求の名前を指定します。 作成時に名前が指定されていない場合、既定値は PublicFolderMailboxMigration<GUID> (たとえば、 PublicFolderMailboxMigration2ffdef13-01b9-4586-af2b-d5a5482010a8) です。
データベース名
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Filtering
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-RequestQueue
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
RequestQueue パラメーターは、要求が実行されているメールボックス データベースに基づいて要求を識別します。 データベースを一意に識別する、任意の値を使用できます。 以下に例を示します。
- 名前
- 識別名 (DN)
- GUID
データベース名
パラメーターのプロパティ
| 型: | DatabaseIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Filtering
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ResultSize
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ResultSize パラメーターは、返される結果の最大数を指定します。 クエリに一致するすべてのリクエストを返す場合は、このパラメーターの値に unlimited を使用します。 既定値は 1,000 です。
パラメーターのプロパティ
| 型: | Unlimited |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Status
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Status パラメーターは、状態に基づいて結果をフィルター処理します。 次の値を使用できます。
- AutoSuspended
- 完了
- CompletedWithWarning
- CompletionInProgress
- 失敗
- InProgress
- キューに登録済み
- 再試行
- 中断
- 同期済み
データベース名
パラメーターのプロパティ
| 型: | RequestStatus |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Filtering
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Suspend
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Suspend パラメーターは、中断された要求を返すかどうかを指定します。 このパラメーターの有効な入力値は、$true または $false です。
データベース名
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Filtering
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。