Skip to content

Move-MailboxToCloud

SYNOPSIS

Move an on-premises mailbox to Exchange Online.

SYNTAX

Move-MailboxToCloud [-Identity] <Object> [[-BatchName] <String>] [<CommonParameters>]

DESCRIPTION

The `Move-MailboxToCloud` function moves an on-premises mailbox to Exchange Online. It uses a predefined set of parameters, including credentials, target delivery domain, and batch name. The function ensures the mailbox exists and handles ambiguous identities before initiating the move request.

EXAMPLES

EXAMPLE 1

Move-MailboxToCloud -Identity "[email protected]" -BatchName "Batch1"

Moves the mailbox for `user@example.com` to Exchange Online in a batch named `Batch1`.

EXAMPLE 2

Move-MailboxToCloud -Identity "[email protected]"

Moves the mailbox for `user@example.com` to Exchange Online using the default batch name `Automation`.

PARAMETERS

-Identity

The identity of the mailbox to be moved (e.g., UserPrincipalName, WindowsEmailAddress, or mail).

Type: Object
Parameter Sets: (All)
Aliases: UserPrincipalName, WindowsEmailAddress, mail

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-BatchName

The name of the batch for the mailbox move. Defaults to `Automation`.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 2
Default value: Automation
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

NOTES