Get-PublicFolderMigrationRequest
此 cmdlet 仅适用于本地 Exchange。
使用 Get-PublicFolderMigrationRequest cmdlet 可查看有关New-PublicFolderMigrationRequest cmdlet) 创建的串行公用文件夹迁移请求 (请求的信息。
注意:对公用文件夹的串行迁移的支持在 Exchange 2013 累积更新 8 (CU8) 中结束,并且 cmdlet 在 Exchange Online 中不再可用。 请改用相应的 *-MigrationBatch 和 *-PublicFolderMailboxMigration* cmdlet。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Get-PublicFolderMigrationRequest
[-BatchName <String>]
[-DomainController <Fqdn>]
[-HighPriority <Boolean>]
[-Name <String>]
[-RequestQueue <DatabaseIdParameter>]
[-ResultSize <Unlimited>]
[-Status <RequestStatus>]
[-Suspend <Boolean>]
[<CommonParameters>]
Get-PublicFolderMigrationRequest
[[-Identity] <PublicFolderMigrationRequestIdParameter>]
[-DomainController <Fqdn>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
说明
您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Get-PublicFolderMigrationRequest
此示例返回进行中的迁移请求的状态。
示例 2
Get-PublicFolderMigrationRequest -Identity "PFMigrate10_11_12" | Format-List Suspended,AutoSuspended
此示例返回名称PFMigrate10_11_12且请求已暂停的所有迁移请求。
参数
-BatchName
BatchName 参数指定提供给批迁移请求的名称。
数据库名称
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 |
-DomainController
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
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 参数指定要查看的公用文件夹迁移请求的标识。 可以使用下列值:
- GUID
- 名称
不能将此参数与其他筛选参数一起使用, (BatchName、HighPriority、Name、RequestQueue、Status 或 Suspend) 。
Type: | PublicFolderMigrationRequestIdParameter |
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 |
-Name
Name 参数按公用文件夹迁移请求的名称筛选结果。
数据库名称
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 |
-RequestQueue
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 |
-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 |
-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 |
输入
Input types
若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。