Get-PublicFolderMailboxMigrationRequest
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。
使用 Get-PublicFolderMailboxMigrationRequest cmdlet 可以查看公用文件夹迁移批次中单个作业的状态，这些批次使用 New-MigrationBatch cmdlet 创建。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
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 cmdlet 默认显示以下属性。
- 名称：系统分配给特定邮箱迁移作业的名称。
- TargetMailbox：要迁移的邮箱。
- 状态：作业的当前状态。
您必须先获得权限，然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Get-PublicFolderMailboxMigrationRequest本示例返回有关所有迁移请求的信息。
示例 2
Get-PublicFolderMailboxMigrationRequest -HighPriority $true在本地 Exchange 中，此示例返回优先级值为“高”、“高”、“最高”或“紧急”的所有迁移请求。
示例 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 参数指定此 cmdlet 从 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返回使用优先级值 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 参数指定想要查看的公用文件夹邮箱迁移请求。 值使用语法： \PublicFolderMailboxMigration<GUID> (例如 \PublicFolderMailboxMigrationac6d9eb4-ee49-405f-b90d-04e9a258bd7e ，) 。
此参数不能与以下参数一起使用：
- 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 参数指定了要返回的结果的最大数量。 若要返回所有与查询相匹配的请求，则请将此参数的值设为无限制。 默认值为 1000。
| 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 |