Get-PublicFolderMailboxMigrationRequest
このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。
New-MigrationBatch コマンドレットを使用して作成したパブリック フォルダー移行バッチに含まれる個々のジョブの状態を表示するには、Get-PublicFolderMailboxMigrationRequest コマンドレットを使用します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Get-PublicFolderMailboxMigrationRequest
[-BatchName <String>]
[-DomainController <Fqdn>]
[-HighPriority <Boolean>]
[-Name <String>]
[-RequestQueue <DatabaseIdParameter>]
[-ResultSize <Unlimited>]
[-Status <RequestStatus>]
[-Suspend <Boolean>]
[<CommonParameters>] 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
BatchName パラメーターは、バッチ ジョブの作成時に割り当てられたフレンドリ BatchName 値によって結果をフィルター処理します。 この値の形式は です MigrationService:<Batch name provided at batch creation>。
データベース名
| Type: | String |
| 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 |
-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 2013, Exchange Server 2016, Exchange Server 2019 |
-HighPriority
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
HighPriority パラメーターは、要求の作成時に割り当てられた Priority 値に基づいて結果をフィルター処理します。 このパラメーターの有効な入力値は、$true または $false です。 これらの値によって結果がフィルター処理される方法を次に示します。
- $true 優先度の値が [高]、[高]、[最高]、または [緊急] で作成された要求を返します。
- $false Priority 値 Normal、Low、Lower、Lowest を使用して作成された要求を返します。
データベース名
| Type: | Boolean |
| 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 |
-Identity
Identity パラメーターは、表示するパブリック フォルダー メールボックス移行要求を指定します。 この値では、 という構文 (例: \PublicFolderMailboxMigrationac6d9eb4-ee49-405f-b90d-04e9a258bd7e) が使用されます \PublicFolderMailboxMigration<GUID> 。
このパラメーターは、次のパラメーターと併用できません。
- Batchname
- HighPriority
- 名前
- RequestQueue
- 中断
- 状態
| Type: | PublicFolderMailboxMigrationRequestIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Name
Name パラメーターは、パブリック フォルダー メールボックスの移行要求の名前を指定します。 作成時に名前が指定されていない場合、既定値は PublicFolderMailboxMigration<GUID> です (例: PublicFolderMailboxMigration2ffdef13-01b9-4586-af2b-d5a5482010a8)。
データベース名
| Type: | String |
| 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 |
-RequestQueue
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
RequestQueue パラメーターは、要求が実行されているメールボックス データベースに基づいて要求を識別します。 データベースを一意に識別する、任意の値を使用できます。 以下に例を示します。
- 名前
- 識別名 (DN)
- GUID
データベース名
| Type: | DatabaseIdParameter |
| 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 |
-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 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Status
Status パラメーターは、状態に基づいて結果をフィルター処理します。 次の値を使用できます。
- 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 2013, Exchange Server 2016, Exchange Server 2019, 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 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |