Commands › Exchange Online

Enable-RemoteMailbox

Exchange Online ExchangeOnlineManagement Enable-*

Create a mailbox in the cloud-based service for an existing user in the on-premises Active Directory.

Quick start script

# Enable-RemoteMailbox — 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-RemoteMailbox
$before | Format-List

# 3. Make the change (dry run first)
Enable-RemoteMailbox -Identity <UserIdParameter> -Equipment <SwitchParameter> -Room <SwitchParameter> -WhatIf
Enable-RemoteMailbox -Identity <UserIdParameter> -Equipment <SwitchParameter> -Room <SwitchParameter>

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

Syntax — 5 parameter sets

Default

Enable-RemoteMailbox [-Identity] <UserIdParameter>
 [-RemoteRoutingAddress <ProxyAddress>]
 [-ACLableSyncedObjectEnabled]
 [-Alias <String>]
 [-Confirm]
 [-DisplayName <String>]
 [-DomainController <Fqdn>]
 [-PrimarySmtpAddress <SmtpAddress>]
 [-WhatIf]
 [<CommonParameters>]

Room

Enable-RemoteMailbox [-Identity] <UserIdParameter>
 [-Room]
 [-ACLableSyncedObjectEnabled]
 [-Alias <String>]
 [-Confirm]
 [-DisplayName <String>]
 [-DomainController <Fqdn>]
 [-PrimarySmtpAddress <SmtpAddress>]
 [-RemoteRoutingAddress <ProxyAddress>]
 [-WhatIf]
 [<CommonParameters>]

Equipment

Enable-RemoteMailbox [-Identity] <UserIdParameter>
 [-Equipment]
 [-ACLableSyncedObjectEnabled]
 [-Alias <String>]
 [-Confirm]
 [-DisplayName <String>]
 [-DomainController <Fqdn>]
 [-PrimarySmtpAddress <SmtpAddress>]
 [-RemoteRoutingAddress <ProxyAddress>]
 [-WhatIf]
 [<CommonParameters>]

Parameters (14)

Parameter	Type	Required	What it controls
-Identity	UserIdParameter	yes	The Identity parameter specifies the identity of the existing on-premises user. You can use any value that uniquely identifies the user. For example:
-Equipment	SwitchParameter	yes	The Equipment switch specifies that the mailbox in the service should be created as an equipment resource mailbox. You don't need to specify a value with this switch.
-Room	SwitchParameter	yes	The Room switch specifies that the mailbox in the service should be created as a room resource mailbox. You don't need to specify a value with this switch.
-Shared	SwitchParameter	yes	Note: This switch is available only in Exchange 2013 CU21 or later and Exchange 2016 CU10 or later. To use this switch, you also need to run setup.exe /PrepareAD. For more information, see...
-ACLableSyncedObjectEnabled	SwitchParameter	yes	The ACLableSyncedObjectEnabled switch specifies whether the remote mailbox is an ACLableSyncedMailboxUser. You don't need to specify a value with this switch.
-Alias	String		The Alias parameter specifies the Exchange alias (also known as the mail nickname) for the recipient. This value identifies the recipient as a mail-enabled object, and shouldn't be confused with multiple email...
-Archive	SwitchParameter		The Archive switch creates an archive mailbox for an existing cloud-based user that already has a mailbox. You don't need to specify a value with this switch.
-ArchiveName	MultiValuedProperty		The ArchiveName parameter specifies the name of the archive mailbox. This is the name displayed to users in Outlook on the web (formerly known as Outlook Web App). If the value contains spaces, enclose the value in...
-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.
-DisplayName	String		The DisplayName parameter specifies the display name for the mailbox that's created in the service. The display name is visible in the Exchange admin center, address lists and Outlook. The maximum length is 256...
-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...
-PrimarySmtpAddress	SmtpAddress		The PrimarySmtpAddress parameter specifies the primary return email address that's used for the recipient.
-RemoteRoutingAddress	ProxyAddress		The RemoteRoutingAddress parameter specifies the SMTP address of the mailbox in the service that this user is associated with.
-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.