Remove-PublicFolderMailboxMigrationRequest

此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。

使用 Remove-PublicFolderMailboxMigrationRequest cmdlet 可以删除公用文件夹迁移批次中的单个作业,该批次使用 New-MigrationBatch cmdlet 创建。

有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法

语法

Remove-PublicFolderMailboxMigrationRequest
      [-Identity] <PublicFolderMailboxMigrationRequestIdParameter>
      [-Confirm]
      [-DomainController <Fqdn>]
      [-Force]
      [-WhatIf]
      [<CommonParameters>]
Remove-PublicFolderMailboxMigrationRequest
      -RequestGuid <Guid>
      -RequestQueue <DatabaseIdParameter>
      [-Confirm]
      [-DomainController <Fqdn>]
      [-WhatIf]
      [<CommonParameters>]

说明

您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet

示例

示例 1

Remove-PublicFolderMailboxMigrationRequest -Identity \PublicFolderMailboxMigrationac6d9eb4-ee49-405f-b90d-04e9a258bd7e

本示例删除指定的公用文件夹邮箱迁移请求。

示例 2

Get-PublicFolderMailboxMigrationRequest | ?{$_.TargetMailbox -eq $null}

此示例返回没有目标邮箱的公用文件夹邮箱迁移请求。 若要删除这些孤立的迁移请求,请将 添加到 | Remove-PublicFolderMailboxMigrationRequest 命令的末尾。

示例 3

Get-PublicFolderMailboxMigrationRequest | group TargetMailbox | ?{$_.Count -gt 1}

此示例返回重复的公用文件夹迁移请求 (为同一目标邮箱) 创建的请求。 如果命令未返回任何结果,则不存在重复的迁移请求。

示例脚本 “删除重复公用文件夹 MRS 请求” 将检测重复或孤立的公用文件夹邮箱迁移请求,并删除这些请求。

参数

-Confirm

Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

  • 破坏性 cmdlet (例如,Remove-* cmdlet) 具有内置的暂停,该暂停会强制你在继续操作之前确认命令。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:-Confirm:$false
  • 大多数其他 cmdlet (例如,New-* 和 Set-* cmdlet) 没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。
Type:SwitchParameter
Aliases:cf
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, Exchange Online

-Force

强制开关隐藏警告或确认消息。 不必为此开关指定值。

您可以在以编程方式运行任务时使用此开关,因为此时并不适合提示用户提供管理输入。

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

-Identity

Identity 参数指定想要删除的公用文件夹邮箱迁移请求。 此值使用语法 \PublicFolderMailboxMigration<GUID> (例如 \PublicFolderMailboxMigrationac6d9eb4-ee49-405f-b90d-04e9a258bd7e) 。

此参数不能与 RequestGuid 或 RequestQueue 参数一起使用。

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

-RequestGuid

此参数只在本地 Exchange 中可用。

RequestGuid 参数指定请求的唯一 RequestGuid 标识符。 若要查找 RequestGuid 值,请使用 Get-PublicFolderMailboxMigrationRequest cmdlet。

如果使用此参数,则还必须使用 RequestQueue 参数。 您不能将这两个参数与 Identity 参数一起使用。

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

-RequestQueue

此参数只在本地 Exchange 中可用。

RequestQueue 参数基于运行请求的邮箱数据库标识请求。 可以使用任何能够唯一标识此数据库的值。 例如:

  • 名称
  • 可分辨名称 (DN)
  • GUID

数据库名称

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

-WhatIf

WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。

Type:SwitchParameter
Aliases:wi
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