Email Recovery

Fix New-MailboxRestoreRequest Parameter Conversion Errors in Exchange PowerShell

Adam DavisAdam Davis Nov 14, 2026 868 views

Question details

The user needs to pass mailbox identity values to a PowerShell restore request instead of property objects or hashtables.

Fix New-MailboxRestoreRequest Parameter Conversion Errors in Exchange PowerShell
Product
Microsoft Exchange PowerShell
Device & OS
not provided
Scenario
A script restores a soft-deleted mailbox to a target mailbox using New-MailboxRestoreRequest.
Observed behavior
The manual restore works, but the scripted request fails with parameter conversion errors after Select-Object results are passed directly to the command.
Before you start

Connect to the appropriate Exchange PowerShell session and confirm that the soft-deleted source mailbox and target mailbox are available. Check that you have permission to run Get-Mailbox and New-MailboxRestoreRequest.

Solution 1Recommended

Pass scalar mailbox identities to the restore request

Use this approach when Select-Object returns property objects that New-MailboxRestoreRequest cannot convert into mailbox identities.

Select-Object with a property name normally returns an object containing that property, not the property value itself. Extract the value or use Select-Object -ExpandProperty before passing it to the restore command.

1
Retrieve the source mailbox

In Exchange PowerShell, run $source = Get-Mailbox -SoftDeletedMailbox -Identity "<source-mailbox-identity>" and replace the placeholder with the soft-deleted mailbox identity.

2
Retrieve the target mailbox

Run $target = Get-Mailbox -Identity "<target-mailbox-identity>" using the identity of the mailbox that will receive the restored content.

3
Extract and check the values

Run $sourceGuid = $source.ExchangeGuid.ToString() and $targetAlias = $target.Alias. Display $sourceGuid and $targetAlias in the console and verify that they identify the intended mailboxes.

4
Create the restore request

Run New-MailboxRestoreRequest -SourceMailbox $sourceGuid -TargetMailbox $targetAlias. If your script uses Select-Object, you can instead extract a single property with Select-Object -ExpandProperty ExchangeGuid or Select-Object -ExpandProperty Alias.

5
Check request progress

Run Get-MailboxRestoreRequest and inspect the request status. For more detail, pipe the relevant request to Get-MailboxRestoreRequestStatistics.

Pass scalar mailbox identities to the restore request
If the request still fails: Confirm that each variable contains one intended mailbox value, not a collection or hashtable. If the error persists, share the command and full error message in a Microsoft PowerShell forum after removing sensitive information.
Free Microsoft Office alternative

Work with Office files in WPS Office

WPS Office is a free, lightweight Office alternative with a familiar interface and support for common Microsoft Office formats, making it easy to move existing documents between suites. It does not restore Exchange mailboxes or fix PowerShell commands.

A familiar interface for working with documents and spreadsheetsCompatible with Microsoft Word, Excel, and PowerPoint formats such as DOCX, XLSX, and PPTXEdit documentation for mailbox recovery procedures in WriterFree and lightweight for everyday office work
microsoft office alternative - wps office

Frequently Asked Questions

Why does Select-Object cause a parameter conversion error?

Select-Object ExchangeGuid returns an object with an ExchangeGuid property. Use Select-Object -ExpandProperty ExchangeGuid or access the property directly to pass the value instead.

Which values can I pass to New-MailboxRestoreRequest?

Pass a valid source mailbox identity, such as its Exchange GUID, to -SourceMailbox and a valid target mailbox identity, such as its alias, to -TargetMailbox. Verify both values before running the request.

How do I check whether the restore request is progressing?

In Exchange PowerShell, run Get-MailboxRestoreRequest to find the request, then pipe it to Get-MailboxRestoreRequestStatistics for more detail.

What should I do if the script still fails after extracting the values?

Check that each variable represents one mailbox and inspect the full error message. If you need specialized help, post the command and error in a Microsoft PowerShell forum, removing sensitive information first.