Commands › Exchange Online

Remove-PublicFolderMigrationRequest

Exchange Online ExchangeOnlineManagement Remove-*

Cancel or complete serial public folder migration requests (requests created by the New-PublicFolderMigrationRequest cmdlet). You need to use this cmdlet to remove an existing serial public folder migration request before you can create another one. **Note**: Support for serial migration of public folders ended in Exchange 2013 Cumulative Update 8 (CU8), and the cmdlets are no longer available in Exchange Online. Instead, use the corresponding **\*-MigrationBatch** and **\*-PublicFolderMailboxMigration\*** cmdlets.

Quick start script

# Remove-PublicFolderMigrationRequest — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-ExchangeOnline -CertificateThumbprint $thumb -AppId $appId -Organization $org

# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-PublicFolderMigrationRequest
$before | Format-List

# 3. Make the change (dry run first)
Remove-PublicFolderMigrationRequest -Identity <PublicFolderMigrationRequestIdParameter> -RequestGuid <Guid> -RequestQueue <DatabaseIdParameter> -WhatIf
Remove-PublicFolderMigrationRequest -Identity <PublicFolderMigrationRequestIdParameter> -RequestGuid <Guid> -RequestQueue <DatabaseIdParameter>

# 4. Verify and diff
$after = Get-PublicFolderMigrationRequest
Compare-Object ($before | Out-String) ($after | Out-String)

Syntax — 2 parameter sets

Identity

Remove-PublicFolderMigrationRequest [-Identity] <PublicFolderMigrationRequestIdParameter>
 [-Confirm]
 [-DomainController <Fqdn>]
 [-Force]
 [-WhatIf]
 [<CommonParameters>]

MigrationRequestQueue

Remove-PublicFolderMigrationRequest -RequestGuid <Guid> -RequestQueue <DatabaseIdParameter>
 [-Confirm]
 [-DomainController <Fqdn>]
 [-WhatIf]
 [<CommonParameters>]

Parameters (7)

Parameter	Type	Required	What it controls
-Identity	PublicFolderMigrationRequestIdParameter	yes	The Identity parameter specifies the migration request that you want to remove. You can use the following values:
-RequestGuid	Guid	yes	The RequestGuid parameter identifies the migration request to remove by its RequestGUID value. This parameter also requires the RequestQueue parameter.
-RequestQueue	DatabaseIdParameter	yes	The RequestQueue parameter identifies the migration request by the mailbox database where the request is being run. You can use any value that uniquely identifies the database. For example:
-Confirm	SwitchParameter		The Confirm switch specifies whether to show or hide the confirmation prompt. How this switch affects the cmdlet depends on whether the cmdlet requires confirmation before proceeding.
-DomainController	Fqdn		The DomainController parameter specifies the domain controller that's used by this cmdlet to read data from or write data to Active Directory. You identify the domain controller by its fully qualified domain name...
-Force	SwitchParameter		The Force switch hides warning or confirmation messages. You don't need to specify a value with this switch.
-WhatIf	SwitchParameter		The WhatIf switch shows what the command does without making any changes. You don't need to specify a value with this switch.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.