New-Mailbox

This cmdlet is available in on-premises Exchange and in the cloud-based service. Some parameters and settings may be exclusive to one environment or the other. Use the New-Mailbox cmdlet to create mailboxes and user accounts at the same time. For information about the parameter sets in the Syntax section below, see Exchange cmdlet syntax (https://technet.microsoft.com/library/bb123552.aspx).

Syntax

New-Mailbox
   [-Name] <String>
   [-AccountDisabled]
   [-Password <SecureString>]
   [-UserPrincipalName <String>]
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-Force]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-MailboxPlan <MailboxPlanIdParameter>]
   [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
   [-ManagedFolderMailboxPolicyAllowed]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <$true | $false>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <$true | $false>]
    [-ResetPasswordOnNextLogon <$true | $false>]
   [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-SamAccountName <String>]
   [-SendModerationNotifications <Never | Internal | Always>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   [-ImportLiveId]
   -WindowsLiveID <WindowsLiveId>
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   [-RemovedMailbox <RemovedMailboxIdParameter>]
   [-TargetAllMDBs]
   [-UseExistingLiveId]
   [-InactiveMailbox <MailboxIdParameter>]
   [-MailboxRegion <String>]
   [-SkipMailboxProvisioningConstraintValidation]
   [<CommonParameters>]
New-Mailbox
   [-Name] <String>
   [-Arbitration]
   [-Password <SecureString>]
   -UserPrincipalName <String>
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-Force]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
   [-ManagedFolderMailboxPolicyAllowed]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <$true | $false>]
    [-ResetPasswordOnNextLogon <$true | $false>]
   [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-SamAccountName <String>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <$true | $false>]
   [-SendModerationNotifications <Never | Internal | Always>]
   [-TargetAllMDBs]
   -LinkedDomainController <String>
   -LinkedMasterAccount <UserIdParameter>
   [-LinkedCredential <PSCredential>]
   [-MailboxRegion <String>]
   [-SkipMailboxProvisioningConstraintValidation]
   [<CommonParameters>]
New-Mailbox
   [-Name] <String>
   -ArchiveDomain <SmtpDomain>
   -Password <SecureString>
   -UserPrincipalName <String>
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-Force]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-MailboxPlan <MailboxPlanIdParameter>]
   [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
   [-ManagedFolderMailboxPolicyAllowed]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <$true | $false>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
    [-RemoteArchive]
   [-RemotePowerShellEnabled <$true | $false>]
   [-ResetPasswordOnNextLogon <$true | $false>]
   [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-SamAccountName <String>]
   [-SendModerationNotifications <Never | Internal | Always>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   [-RemovedMailbox <RemovedMailboxIdParameter>]
   [-TargetAllMDBs]
   [-MailboxRegion <String>]
   [-SkipMailboxProvisioningConstraintValidation]
   [<CommonParameters>]
New-Mailbox
   [-Name] <String>
   [-Discovery]
   [-Password <SecureString>]
   [-UserPrincipalName <String>]
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-Force]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
   [-ManagedFolderMailboxPolicyAllowed]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <$true | $false>]
    [-ResetPasswordOnNextLogon <$true | $false>]
   [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-SamAccountName <String>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   [-Arbitration]
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   [-TargetAllMDBs]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-MailboxRegion <String>]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <$true | $false>]
   [-SendModerationNotifications <Never | Internal | Always>]
   [-SkipMailboxProvisioningConstraintValidation]
   [<CommonParameters>]
New-Mailbox
   [-Name] <String>
   [-Equipment]
   [-Password <SecureString>]
   [-UserPrincipalName <String>]
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-Force]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
   [-ManagedFolderMailboxPolicyAllowed]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <$true | $false>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <$true | $false>]
   [-ResetPasswordOnNextLogon <$true | $false>]
    [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-SamAccountName <String>]
   [-SendModerationNotifications <Never | Internal | Always>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   -WindowsLiveID <WindowsLiveId>
   [-EvictLiveId]
   [-MailboxPlan <MailboxPlanIdParameter>]
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   [-RemovedMailbox <RemovedMailboxIdParameter>]
   [-TargetAllMDBs]
   -ArchiveDomain <SmtpDomain>
   [-MailboxRegion <String>]
   [-RemoteArchive]
   [-SkipMailboxProvisioningConstraintValidation]
   [<CommonParameters>]
New-Mailbox
   [-Name] <String>
   -FederatedIdentity <String>
   -WindowsLiveID <WindowsLiveId>
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-EvictLiveId]
   [-FirstName <String>]
   [-Force]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-MailboxPlan <MailboxPlanIdParameter>]
   [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
   [-ManagedFolderMailboxPolicyAllowed]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <$true | $false>]
   [-ResetPasswordOnNextLogon <$true | $false>]
    [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-SamAccountName <String>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   -MicrosoftOnlineServicesID <WindowsLiveId>
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   [-RemovedMailbox <RemovedMailboxIdParameter>]
   [-TargetAllMDBs]
   [-ImportLiveId]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-MailboxRegion <String>]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <$true | $false>]
   [-SendModerationNotifications <Never | Internal | Always>]
   [-SkipMailboxProvisioningConstraintValidation]
   [<CommonParameters>]
New-Mailbox
   [-Name] <String>
   [-ImportLiveId]
   -WindowsLiveID <WindowsLiveId>
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-Force]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-MailboxPlan <MailboxPlanIdParameter>]
   [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
   [-ManagedFolderMailboxPolicyAllowed]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <$true | $false>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <$true | $false>]
    [-ResetPasswordOnNextLogon <$true | $false>]
   [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-SamAccountName <String>]
   [-SendModerationNotifications <Never | Internal | Always>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   [-Password <SecureString>]
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   -RemovedMailbox <RemovedMailboxIdParameter>
   [-TargetAllMDBs]
   -UserPrincipalName <String>
   [-MailboxRegion <String>]
   [-SkipMailboxProvisioningConstraintValidation]
   [<CommonParameters>]
New-Mailbox
   [-Name] <String>
   -LinkedDomainController <String>
   -LinkedMasterAccount <UserIdParameter>
   [-Password <SecureString>]
   [-UserPrincipalName <String>]
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-Force]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-LinkedCredential <PSCredential>]
   [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
   [-ManagedFolderMailboxPolicyAllowed]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <$true | $false>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <$true | $false>]
   [-ResetPasswordOnNextLogon <$true | $false>]
   [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-SamAccountName <String>]
   [-SendModerationNotifications <Never | Internal | Always>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   [-MailboxPlan <MailboxPlanIdParameter>]
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   [-TargetAllMDBs]
   -FederatedIdentity <String>
   -WindowsLiveID <WindowsLiveId>
   [-EvictLiveId]
   [-MailboxRegion <String>]
   [-RemovedMailbox <RemovedMailboxIdParameter>]
   [-SkipMailboxProvisioningConstraintValidation]
   [<CommonParameters>]
New-Mailbox
   [-Name] <String>
   -Password <SecureString>
   -UserPrincipalName <String>
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-Force]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-MailboxPlan <MailboxPlanIdParameter>]
   [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
   [-ManagedFolderMailboxPolicyAllowed]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <$true | $false>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <$true | $false>]
    [-ResetPasswordOnNextLogon <$true | $false>]
   [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-SamAccountName <String>]
   [-SendModerationNotifications <Never | Internal | Always>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   [-RemovedMailbox <RemovedMailboxIdParameter>]
   [-TargetAllMDBs]
   [-InactiveMailbox <MailboxIdParameter>]
   [-MailboxRegion <String>]
   [-SkipMailboxProvisioningConstraintValidation]
   [<CommonParameters>]
New-Mailbox
   [-Name] <String>
   -Password <SecureString>
   -WindowsLiveID <WindowsLiveId>
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-EvictLiveId]
   [-FirstName <String>]
   [-Force]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-MailboxPlan <MailboxPlanIdParameter>]
   [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
   [-ManagedFolderMailboxPolicyAllowed]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <$true | $false>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <$true | $false>]
    [-ResetPasswordOnNextLogon <$true | $false>]
   [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-SamAccountName <String>]
   [-SendModerationNotifications <Never | Internal | Always>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   -MicrosoftOnlineServicesID <WindowsLiveId>
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   [-RemovedMailbox <RemovedMailboxIdParameter>]
   [-TargetAllMDBs]
   -InactiveMailbox <MailboxIdParameter>
   [-MailboxRegion <String>]
   [-SkipMailboxProvisioningConstraintValidation]
   [<CommonParameters>]
New-Mailbox
   [-Name] <String>
   [-Password <SecureString>]
   [-Room]
   [-UserPrincipalName <String>]
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-Force]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
   [-ManagedFolderMailboxPolicyAllowed]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <$true | $false>]
   [-Office <String>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-Phone <String>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <$true | $false>]
   [-ResetPasswordOnNextLogon <$true | $false>]
   [-ResourceCapacity <Int32>]
   [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-SamAccountName <String>]
   [-SendModerationNotifications <Never | Internal | Always>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   [-TargetAllMDBs]
   [-MailboxRegion <String>]
   [-SkipMailboxProvisioningConstraintValidation]
   [<CommonParameters>]
New-Mailbox
   [-Name] <String>
   [-Password <SecureString>]
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-Force]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-MailboxPlan <MailboxPlanIdParameter>]
   [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
   [-ManagedFolderMailboxPolicyAllowed]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <$true | $false>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <$true | $false>]
    [-ResetPasswordOnNextLogon <$true | $false>]
   [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-SamAccountName <String>]
   [-SendModerationNotifications <Never | Internal | Always>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   -LinkedDomainController <String>
   -LinkedMasterAccount <UserIdParameter>
   [-LinkedRoom]
   [-UserPrincipalName <String>]
   [-LinkedCredential <PSCredential>]
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   [-Office <String>]
   [-Phone <String>]
   [-ResourceCapacity <Int32>]
   [-TargetAllMDBs]
   [-MailboxRegion <String>]
   [-SkipMailboxProvisioningConstraintValidation]
   [<CommonParameters>]
New-Mailbox
   [-Name] <String>
   [-Password <SecureString>]
   [-UserPrincipalName <String>]
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-Force]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
   [-ManagedFolderMailboxPolicyAllowed]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <$true | $false>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <$true | $false>]
   [-ResetPasswordOnNextLogon <$true | $false>]
    [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-SamAccountName <String>]
   [-SendModerationNotifications <Never | Internal | Always>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   [-AccountDisabled]
   [-MailboxPlan <MailboxPlanIdParameter>]
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   [-TargetAllMDBs]
   -FederatedIdentity <String>
   -MicrosoftOnlineServicesID <WindowsLiveId>
   [-MailboxRegion <String>]
   [-RemovedMailbox <RemovedMailboxIdParameter>]
   [-SkipMailboxProvisioningConstraintValidation]
   [<CommonParameters>]
New-Mailbox
   [-Name] <String>
   [-Password <SecureString>]
   [-Shared]
   [-UserPrincipalName <String>]
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-Force]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
   [-ManagedFolderMailboxPolicyAllowed]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <$true | $false>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <$true | $false>]
   [-ResetPasswordOnNextLogon <$true | $false>]
    [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-SamAccountName <String>]
   [-SendModerationNotifications <Never | Internal | Always>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   [-Discovery]
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   [-TargetAllMDBs]
   -MicrosoftOnlineServicesID <WindowsLiveId>
   [-InactiveMailbox <MailboxIdParameter>]
   [-MailboxPlan <MailboxPlanIdParameter>]
   [-MailboxRegion <String>]
   [-RemovedMailbox <RemovedMailboxIdParameter>]
   [-SkipMailboxProvisioningConstraintValidation]
   [<CommonParameters>]
New-Mailbox
   [-Name] <String>
   [-UseExistingLiveId]
   -WindowsLiveID <WindowsLiveId>
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-Force]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-MailboxPlan <MailboxPlanIdParameter>]
   [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
   [-ManagedFolderMailboxPolicyAllowed]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <$true | $false>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <$true | $false>]
    [-ResetPasswordOnNextLogon <$true | $false>]
   [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-SamAccountName <String>]
   [-SendModerationNotifications <Never | Internal | Always>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   [-RemovedMailbox <RemovedMailboxIdParameter>]
   [-TargetAllMDBs]
   -Password <SecureString>
   [-EvictLiveId]
   [-InactiveMailbox <MailboxIdParameter>]
   [-MailboxRegion <String>]
   [-SkipMailboxProvisioningConstraintValidation]
   [<CommonParameters>]
New-Mailbox
   [-Name] <String>
   -UserPrincipalName <String>
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-Force]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-MailboxPlan <MailboxPlanIdParameter>]
   [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
   [-ManagedFolderMailboxPolicyAllowed]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <$true | $false>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <$true | $false>]
    [-ResetPasswordOnNextLogon <$true | $false>]
   [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-SamAccountName <String>]
   [-SendModerationNotifications <Never | Internal | Always>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   -FederatedIdentity <String>
   -WindowsLiveID <WindowsLiveId>
   [-EvictLiveId]
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   [-RemovedMailbox <RemovedMailboxIdParameter>]
   [-TargetAllMDBs]
   [-AccountDisabled]
   [-Password <SecureString>]
   [-MailboxRegion <String>]
   [-SkipMailboxProvisioningConstraintValidation]
   [<CommonParameters>]
New-Mailbox
   [-Name] <String>
   -EnableRoomMailboxAccount <$true | $false>
   [-MicrosoftOnlineServicesID <WindowsLiveId>]
   [-Room]
   [-UserPrincipalName <String>]
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-Force]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <$true | $false>]
   [-ResetPasswordOnNextLogon <$true | $false>]
   [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-RoomMailboxPassword <SecureString>]
   [-SamAccountName <String>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-TargetAllMDBs]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   [-Arbitration]
   [-Migration]
   [-Password <SecureString>]
   [-MailboxRegion <String>]
   [-SkipMailboxProvisioningConstraintValidation]
   [<CommonParameters>]
New-Mailbox
   [-Name] <String>
   [-Equipment]
   [-Password <SecureString>]
   [-UserPrincipalName <String>]
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-Force]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <$true | $false>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <$true | $false>]
   [-ResetPasswordOnNextLogon <$true | $false>]
   [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-SamAccountName <String>]
   [-SendModerationNotifications <Never | Internal | Always>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-TargetAllMDBs]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   [-MailboxRegion <String>]
   [-SkipMailboxProvisioningConstraintValidation]
   [<CommonParameters>]
New-Mailbox
   [-Name] <String>
   -LinkedDomainController <String>
   -LinkedMasterAccount <UserIdParameter>
   [-Password <SecureString>]
   [-UserPrincipalName <String>]
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-Force]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-LinkedCredential <PSCredential>]
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <$true | $false>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <$true | $false>]
   [-ResetPasswordOnNextLogon <$true | $false>]
   [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-SamAccountName <String>]
   [-SendModerationNotifications <Never | Internal | Always>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-TargetAllMDBs]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   [-MailboxRegion <String>]
   [-SkipMailboxProvisioningConstraintValidation]
   [<CommonParameters>]
New-Mailbox
   [-Name] <String>
   [-Password <SecureString>]
   [-UserPrincipalName <String>]
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-Force]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <$true | $false>]
   [-ResetPasswordOnNextLogon <$true | $false>]
   [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-SamAccountName <String>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-TargetAllMDBs]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   [-Scheduling]
   [-MailboxRegion <String>]
   [-SkipMailboxProvisioningConstraintValidation]
   [<CommonParameters>]
New-Mailbox
   [-Name] <String>
   [-Password <SecureString>]
   [-UserPrincipalName <String>]
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-Force]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <$true | $false>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <$true | $false>]
   [-ResetPasswordOnNextLogon <$true | $false>]
   [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-SamAccountName <String>]
   [-SendModerationNotifications <Never | Internal | Always>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-TargetAllMDBs]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   [-Shared]
   [-MailboxRegion <String>]
   [-SkipMailboxProvisioningConstraintValidation]
   [<CommonParameters>]
New-Mailbox
   [-Name] <String>
   [-Password <SecureString>]
   [-Shared]
   [-UserPrincipalName <String>]
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-Force]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <$true | $false>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <$true | $false>]
   [-ResetPasswordOnNextLogon <$true | $false>]
   [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-SamAccountName <String>]
   [-SendModerationNotifications <Never | Internal | Always>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-TargetAllMDBs]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   [-MailboxRegion <String>]
   [-SkipMailboxProvisioningConstraintValidation]
   [<CommonParameters>]
New-Mailbox
   [-Name] <String>
   [-Password <SecureString>]
   [-UserPrincipalName <String>]
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-Force]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <$true | $false>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <$true | $false>]
   [-ResetPasswordOnNextLogon <$true | $false>]
   [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-SamAccountName <String>]
   [-SendModerationNotifications <Never | Internal | Always>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-TargetAllMDBs]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   [-Arbitration]
   [-MailboxRegion <String>]
   [-OfficeGraph]
   [-ProvisionedForOfficeGraph]
   [-SkipMailboxProvisioningConstraintValidation]
   [<CommonParameters>]
New-Mailbox
   [-Name] <String>
   [-PublicFolder]
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-Force]
   [-HoldForMigration]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-IsExcludedFromServingHierarchy <$true | $false>]
   [-LastName <String>]
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <$true | $false>]
   [-ResetPasswordOnNextLogon <$true | $false>]
   [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-SamAccountName <String>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-TargetAllMDBs]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   [-AuditLog]
   -UserPrincipalName <String>
   [-MailboxRegion <String>]
   [-SkipMailboxProvisioningConstraintValidation]
   [<CommonParameters>]
New-Mailbox
   [-Name] <String>
   -UserPrincipalName <String>
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-Force]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <$true | $false>]
   [-ResetPasswordOnNextLogon <$true | $false>]
   [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-SamAccountName <String>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-TargetAllMDBs]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   [-Discovery]
   [-Password <SecureString>]
   [-MailboxRegion <String>]
   [-SkipMailboxProvisioningConstraintValidation]
   [<CommonParameters>]
New-Mailbox
   [-Name] <String>
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-Force]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   [-ModeratedBy <MultiValuedProperty>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <$true | $false>]
   [-ResetPasswordOnNextLogon <$true | $false>]
   [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-SamAccountName <String>]
   [-SendModerationNotifications <Never | Internal | Always>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-TargetAllMDBs]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   -EnableRoomMailboxAccount <$true | $false>
   [-MicrosoftOnlineServicesID <WindowsLiveId>]
   [-Room]
   [-UserPrincipalName <String>]
   [-MailboxRegion <String>]
   [-RoomMailboxPassword <SecureString>]
   [-SkipMailboxProvisioningConstraintValidation]
   [<CommonParameters>]
New-Mailbox
   [-Name] <String>
   [-AuxAuditLog]
   [-UserPrincipalName <String>]
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-Force]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   [-MailboxRegion <String>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <$true | $false>]
   [-ResetPasswordOnNextLogon <$true | $false>]
   [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-SamAccountName <String>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-SkipMailboxProvisioningConstraintValidation]
   [-TargetAllMDBs]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   [<CommonParameters>]
New-Mailbox
   [-Name] <String>
   [-PublicFolder]
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-Force]
   [-HoldForMigration]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-IsExcludedFromServingHierarchy <$true | $false>]
   [-LastName <String>]
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   [-MailboxRegion <String>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <$true | $false>]
   [-ResetPasswordOnNextLogon <$true | $false>]
   [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-SamAccountName <String>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-SkipMailboxProvisioningConstraintValidation]
   [-TargetAllMDBs]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   [<CommonParameters>]
New-Mailbox
   [-Name] <String>
   [-SupervisoryReviewPolicy]
   [-UserPrincipalName <String>]
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-Force]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   [-MailboxRegion <String>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <$true | $false>]
   [-ResetPasswordOnNextLogon <$true | $false>]
   [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-SamAccountName <String>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-SkipMailboxProvisioningConstraintValidation]
   [-TargetAllMDBs]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   [<CommonParameters>]
New-Mailbox
   [-Name] <String>
   [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
   [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-Archive]
   [-ArchiveDatabase <DatabaseIdParameter>]
   [-Confirm]
   [-Database <DatabaseIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-FirstName <String>]
   [-Force]
   [-ImmutableId <String>]
   [-Initials <String>]
   [-LastName <String>]
   [-MailboxProvisioningConstraint <MailboxProvisioningConstraint>]
   [-MailboxProvisioningPreferences <MultiValuedProperty>]
   [-MailboxRegion <String>]
   [-ModeratedBy <MultiValuedProperty>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RemotePowerShellEnabled <$true | $false>]
   [-ResetPasswordOnNextLogon <$true | $false>]
   [-RetentionPolicy <MailboxPolicyIdParameter>]
   [-RoleAssignmentPolicy <MailboxPolicyIdParameter>]
   [-SamAccountName <String>]
   [-SendModerationNotifications <Never | Internal | Always>]
   [-SharingPolicy <SharingPolicyIdParameter>]
   [-SkipMailboxProvisioningConstraintValidation]
   [-TargetAllMDBs]
   [-ThrottlingPolicy <ThrottlingPolicyIdParameter>]
   [-WhatIf]
   [<CommonParameters>]

Description

You need to be assigned permissions before you can run this cmdlet. Although this topic lists all parameters for the cmdlet, you may not have access to some parameters if they're not included in the permissions assigned to you. To find the permissions required to run any cmdlet or parameter in your organization, see Find the permissions required to run any Exchange cmdlet (https://technet.microsoft.com/library/mt432940.aspx).

Examples

-------------------------- Example 1 --------------------------

$password = Read-Host "Enter password" -AsSecureString; New-Mailbox -UserPrincipalName chris@contoso.com -Alias chris -Database "Mailbox Database 1" -Name ChrisAshton -OrganizationalUnit Users -Password $password -FirstName Chris -LastName Ashton -DisplayName "Chris Ashton" -ResetPasswordOnNextLogon $true

This example creates a user Chris Ashton in Active Directory and creates a mailbox for the user. The mailbox is located on Mailbox Database 1. The password must be reset at the next logon. To set the initial value of the password, this example creates a variable ($password), prompts you to enter a password, and assigns that password to the variable as a SecureString object.

-------------------------- Example 2 --------------------------

New-Mailbox -UserPrincipalName confmbx@contoso.com -Alias confmbx -Name ConfRoomMailbox -Database "Mailbox Database 1" -OrganizationalUnit Users -Room -ResetPasswordOnNextLogon $true

This example creates a user in Active Directory and a resource mailbox for a conference room. The resource mailbox is located in Mailbox Database 1. The password must be reset at the next logon. You are prompted for the value of the initial password because it's not specified.

-------------------------- Example 3 --------------------------

New-Mailbox -UserPrincipalName confroom1010@contoso.com -Alias confroom1010 -Name "Conference Room 1010" -Room -EnableRoomMailboxAccount $true -RoomMailboxPassword (ConvertTo-SecureString -String P@ssw0rd -AsPlainText -Force)

This example creates an enabled user account in Active Directory and a room mailbox for a conference room in an on-premises Exchange organization. The RoomMailboxPassword parameter specifies the password for the user account.

-------------------------- Example 4 --------------------------

New-Mailbox -Shared -Name "Sales Department" -DisplayName "Sales Department" -Alias Sales; Set-Mailbox -Identity Sales -GrantSendOnBehalfTo MarketingSG; Add-MailboxPermission -Identity Sales -User MarketingSG -AccessRights FullAccess -InheritanceType All

This example creates the shared mailbox "Sales Department" and grants Full Access and Send on Behalf permissions for the security group "MarketingSG". Users who are members of the security group will be granted the permissions to the mailbox.

This example assumes that you've already created a mail-enabled security group named "MarketingSG" by using the New-DistributionGroup cmdlet.

Required Parameters

-AccountDisabled

This parameter is available only in on-premises Exchange.

The AccountDisabled switch specifies that the user account associated with the mailbox is disabled. You don't need to specify a value with this switch.

The mailbox is created, and the associated account is created, but the account is disabled, so you can't log on to the mailbox.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-Arbitration

This parameter is available only in on-premises Exchange.

The Arbitration switch specifies that the mailbox you're creating is an arbitration mailbox. You don't need to specify a value with this switch.

Arbitration mailboxes are system mailbox that are used for storing different types of system data and for managing messaging approval workflow.

Note: To create an arbitration mailbox that's used to store audit log settings or data, you need to use the AuditLog or AuxAuditLog switches instead of the Arbitration switch.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-ArchiveDomain

This parameter is available only in on-premises Exchange.

The ArchiveDomain parameter specifies the domain in the cloud-based service where the archive that's associated with this mailbox exists. For example, if the SMTP email address of the user is tony@contoso.com, the SMTP domain could be archive.contoso.com.

Only use this parameter if the archive is hosted in the cloud-based service.

Type:SmtpDomain
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-AuditLog

The AuditLog switch specifies the mailbox is an arbitration mailbox that's used to store audit log settings. You don't need to specify a value with this switch.

Notes:

  • This switch is required only if you're creating this type of arbitration mailbox.

  • The Arbitration switch doesn't work for creating this type of arbitration mailbox.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016
-AuxAuditLog

The AuxAuditLog switch specifies the mailbox is an arbitration mailbox that's used to store audit log data. You don't need to specify a value with this switch.

Notes:

  • This switch is required only if you're creating this type of arbitration mailbox.

  • The Arbitration switch doesn't work for creating this type of arbitration mailbox.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016
-Discovery

The Discoveryswitch specifies that the mailbox is a Discovery mailbox. You don't need to specify a value with this switch.

This switch is required only if you're creating a Discovery mailbox.

Discovery mailboxes are created as target mailboxes for Discovery searches. After being created or enabled, a Discovery mailbox can't be repurposed or converted to another type of mailbox. For more information, see In-Place eDiscovery (https://technet.microsoft.com/library/dd298021.aspx).

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-EnableRoomMailboxAccount

The EnableRoomMailboxAccount parameter specifies whether to enable the disabled user account that's associated with this room mailbox. Valid values are:

  • $true: The disabled account that's associated with the room mailbox is enabled. You also need to use the RoomMailboxPassword with this value. This allows the account to log on to the room mailbox.

  • $false: The account that's associated with the room mailbox is disabled. You can't use the account to logon to the room mailbox. This is the default value.

You need to use this parameter with the Room switch.

Typically, the account that's associated with a room mailbox is disabled. However, you need to enable the account for features like the Lync Room System or the Skype for Business Room System.

In Exchange Online, a room mailbox with an associated enabled account doesn't require a license.

Type:$true | $false
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016
-Equipment

The Equipment switch specifies that the resource mailbox is an equipment mailbox. You don't need to specify a value with this switch.

This switch is required only if you're creating an equipment mailbox.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-FederatedIdentity

This parameter is available only in the cloud-based service.

The FederatedIdentity parameter associates an on-premises Active Directory user with a user in the cloud.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ImportLiveId

This parameter is available only in the cloud-based service.

The ImportLiveID switch specifies whether to import an unmanaged Microsoft account (formerly known as a Windows Live ID) into the cloud-based domain. You don't need to specify a value with this switch.

An unmanaged Microsoft account was created in the domain before the domain was enrolled in the cloud-based service. Importing a Microsoft account into the domain lets you save any settings associated with the Microsoft account, like instant messaging contacts. However, the Microsoft account is now subject to the security and privacy policies of the organization.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-LinkedDomainController

This parameter is available only in on-premises Exchange.

The LinkedDomainController parameter specifies the domain controller in the forest where the user account resides, if the mailbox is a linked mailbox. The domain controller in the forest where the user account resides is used to get security information for the account specified by the LinkedMasterAccount parameter. Use the fully qualified domain name (FQDN) of the domain controller that you want to use as the value for this parameter.

This parameter is required only if you're creating a linked mailbox.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-LinkedMasterAccount

The LinkedMasterAccount parameter specifies the master account in the forest where the user account resides, if the mailbox is a linked mailbox. The master account is the account that the mailbox is linked to. The master account grants access to the mailbox. You can use any value that uniquely identifies the master account.

For example:

  • Name

  • Display name

  • Distinguished name (DN)

  • Canonical DN

  • GUID

Type:UserIdParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-LinkedRoom

This parameter is available only in on-premises Exchange.

The LinkedRoom switch specifies that the mailbox is a linked resource mailbox. You don't need to specify a value with this switch.

A linked resource mailbox is useful in a scenario where you have an account in an authentication forest and you want it to be directly linked to a resource mailbox in resource forest.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016
-MicrosoftOnlineServicesID

This parameter is available only in the cloud-based service.

The MicrosoftOnlineServicesID parameter specifies the user ID for the object. This parameter only applies to objects in the cloud-based service. It isn't available for on-premises deployments.

Type:WindowsLiveId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Migration

The Migration switch specifies that the mailbox is a migration mailbox. You don't need to specify a value with this switch.

This switch is required only if you're creating a migration mailbox.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016
-Name

The Name parameter specifies the unique name of the mailbox. The maximum length is 64 characters. If the value contains spaces, enclose the value in quotation marks (").

Type:String
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-PublicFolder

The PublicFolder switch specifies that the mailbox is a public folder mailbox. You don't need to specify a value with this switch.

This switch is required only if you're creating a public folder mailbox.

Public folder mailboxes are specially designed mailboxes that store the hierarchy and content of public folders. The first public folder mailbox created in your Exchange organization is called the primary hierarchy mailbox. It contains the writeable copy of the hierarchy of public folders for the organization and public folder content. There can be only one writeable copy of the public folder hierarchy in your organization. All other public folder mailboxes are called secondary public folder mailboxes and contain a read-only copy of the hierarchy and the content for public folders.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016
-Room

The Room switch specifies that the resource mailbox is a room mailbox. You don't need to specify a value with this switch.

This switch is required only if you're creating a room mailbox.

When you use this switch, a logon-disabled account is created with the room mailbox, which prevents users from signing in to the mailbox. When you use the EnableRoomMailboxAccount and RoomMailboxPassword parameters, you can mail-enable the associated account.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-Scheduling

This parameter is reserved for internal Microsoft use.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016
-Shared

The Shared parameter specifies that the mailbox is a shared mailbox. You don't need to specify a value with this switch.

This switch is required only if you're creating a shared mailbox.

A shared mailbox is a mailbox where multiple users can log on to access the mailbox contents. The mailbox isn't associated with any of the users that can log on. It's associated with a disabled user account.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-SupervisoryReviewPolicy

PARAMVALUE: SwitchParameter

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016
-UseExistingLiveId

This parameter is available only in the cloud-based service.

The UseExistingLiveId switch specifies whether to use the specified Microsoft account (formerly known as a Windows Live ID) that already exists in the cloud-based domain. The specified Microsoft account can't have a mail user associated with it.

You don't need to specify a value with this switch.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WindowsLiveID

This parameter is available only in the cloud-based service.

The WindowsLiveID parameter specifies the Microsoft account (formerly known as a Windows Live ID) of the mailbox.

Type:WindowsLiveId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-ActiveSyncMailboxPolicy

The ActiveSyncMailboxPolicy parameter specifies the mobile device mailbox policy that's applied to the mailbox. You can use any value that uniquely identifies the policy. For example:.

  • Name

  • Distinguished name (DN)

  • GUID

If you don't use this parameter, the default mobile device mailbox policy is used.

Type:MailboxPolicyIdParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-AddressBookPolicy

This parameter is available only in on-premises Exchange.

The AddressBookPolicy parameter specifies the address book policy that's applied to the mailbox. You can use any value that uniquely identifies the address book policy. For example:

  • Name

  • Distinguished name (DN)

  • GUID

For more information about address book policies, see Address book policies (https://technet.microsoft.com/library/hh529948.aspx).

Type:AddressBookMailboxPolicyIdParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-Alias

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 addresses for the same recipient (also known as proxy addresses). A recipient can have only one Alias value.

The value of Alias can contain letters, numbers and the characters !, #, $, %, &, ', *, +, -, /, =, ?, ^, _, `, {, |, } and ~. Periods (.) are allowed, but each period must be surrounded by other valid characters (for example, help.desk). Unicode characters from U+00A1 to U+00FF are also allowed. The maximum length of the Alias value is 64 characters.

When you create a recipient without specifying an email address, the Alias value you specify is used to generate the primary email address (<alias>@<domain>). Supported Unicode characters are mapped to best-fit US-ASCII text characters. For example, U+00F6 (ö) is changed to oe in the primary email address.

If you don't use the Alias parameter when you create a recipient, the value of a different required parameter is used for the Alias property value:

  • Recipients with user accounts (for example, user mailboxes, and mail users): The left side of the MicrosoftOnlineServicesID or UserPrincipalName parameter is used. For example, helpdesk@contoso.com results in the Alias property value helpdesk.

  • Recipeints without user accounts (for example, room mailboxes, mail contacts, and distribution groups): The value of the Name parameter is used. Spaces are removed and unsupported characters are converted to question marks (?).

If you modify the Alias value of an existing recipient, the primary email address is automatically updated only in environments where the recipient is subject to email address policies (the EmailAddressPolicyEnabled property is True for the recipient).

The Alias parameter never generates or updates the primary email address of a mail contact or a mail user.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-ArbitrationMailbox

This parameter is available only in on-premises Exchange.

The ArbitrationMailbox parameter specifies the arbitration mailbox that's used to manage the moderation process for this recipient. You can use any value that uniquely identifies the arbitration mailbox.

For example:

  • Name

  • Display name

  • Alias

  • Distinguished name (DN)

  • Canonical DN

  • <domain name>\<account name>

  • Email address

  • GUID

  • LegacyExchangeDN

  • SamAccountName

  • User ID or user principal name (UPN)

Type:MailboxIdParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-Archive

The Archiveswitch specifies that an archive mailbox is created for this mailbox. You don't need to specify a value with this switch.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-ArchiveDatabase

This parameter is available only in on-premises Exchange.

The ArchiveDatabase parameter specifies the Exchange database that contains the archive that's associated with this mailbox. You can use any value that uniquely identifies the database. For example:

  • Name

  • Distinguished name (DN)

  • GUID

Type:DatabaseIdParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-Confirm

The Confirm switch specifies whether to show or hide the confirmation prompt. How this switch affects the cmdlet depends on if the cmdlet requires confirmation before proceeding.

  • Destructive cmdlets (for example, Remove-* cmdlets) have a built-in pause that forces you to acknowledge the command before proceeding. For these cmdlets, you can skip the confirmation prompt by using this exact syntax: -Confirm:$false.

  • Most other cmdlets (for example, New-* and Set-* cmdlets) don't have a built-in pause. For these cmdlets, specifying the Confirm switch without a value introduces a pause that forces you acknowledge the command before proceeding.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-Database

This parameter is available only in on-premises Exchange.

The Database parameter specifies the mailbox database that contains the mailbox. You can use any value that uniquely identifies the database. For example:

  • Name

  • Distinguished name (DN)

  • GUID

Use the Get-MailboxDatabase cmdlet to see the available mailbox databases.

Type:DatabaseIdParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-DisplayName

The DisplayName parameter specifies the display name of the mailbox. The display name is visible in the Exchange admin center, in address lists, and in Outlook. The maximum length is 256 characters. If the value contains spaces, enclose the value in quotation marks (").

If you don't use the DisplayName parameter, the value of the Name parameter is used for the display name.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-DomainController

This parameter is available only in on-premises Exchange.

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 (FQDN). For example, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-EvictLiveId

This parameter is available only in the cloud-based service.

The EvictLiveId switch specifies whether to remove an unmanaged Microsoft account (formerly known as a Windows Live ID) from the cloud-based domain. An unmanaged Microsoft account was created in the domain before the domain was enrolled in the cloud-based service. Evicting a Microsoft account from the domain lets you save any settings associated with the Microsoft account, like instant messaging contacts.

You don't need to specify a value with this switch.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-FirstName

The FirstName parameter specifies the user's first name.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-Force

The Force switch specifies whether to suppress warning or confirmation messages. You can use this switch to run tasks programmatically where prompting for administrative input is inappropriate. You don't need to specify a value with this switch.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-HoldForMigration

The HoldForMigration switch specifies whether to prevent any client or user, except the Microsoft Exchange Mailbox Replication service (MRS) process, from logging on to a public folder mailbox. You don't need to specify a value with this switch.

You need to use this parameter when you create the first public folder, which is called the hierarchy mailbox, in your organization.

Use this parameter only if you plan to migrate legacy Exchange 2010 public folders to Exchange 2016. If you use this switch but don't have legacy public folders to migrate, you won't be able to create any public folders.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016
-ImmutableId

The ImmutableId parameter is used by GAL synchronization (GALSync) and specifies a unique and immutable identifier in the form of an SMTP address for an Exchange mailbox used for federated delegation when requesting Security Assertion Markup Language (SAML) tokens. If federation is configured for this mailbox and you don't set this parameter when you create the mailbox, Exchange creates the value for the immutable ID based upon the mailbox's ExchangeGUID and the federated account namespace, for example, 7a78e7c8-620e-4d85-99d3-c90d90f29699@mail.contoso.com.

You need to set the ImmutableId parameter if Active Directory Federation Services (AD FS) is deployed to allow single sign-on into an off-premises mailbox and AD FS is configured to use a different attribute than ExchangeGUID for sign-on token requests. Both, Exchange and AD FS must request the same token for the same user to ensure proper functionality for a cross-premises Exchange deployment scenario.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-InactiveMailbox

This parameter is available only in the cloud-based service.

The InactiveMailbox parameter specifies the inactive mailbox that you want to recover. To find inactive mailboxes, run the command Get-Mailbox -InactiveMailboxOnly | FL Name,PrimarySmtpAddress,DistinguishedName,ExchangeGuid and then use the DistinguishedName or ExchangeGuid property values to identify the inactive mailbox for this parameter (values guaranteed to be unique).

Type:MailboxIdParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Initials

The Initials parameter specifies the user's middle initials.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-IsExcludedFromServingHierarchy

The IsExcludedFromServingHierarchy parameter prevents users from accessing the public folder hierarchy on this public folder mailbox. For load-balancing purposes, users are equally distributed across public folder mailboxes by default. When this parameter is set on a public folder mailbox, that mailbox isn't included in this automatic load-balancing and won't be accessed by users to retrieve the public folder hierarchy. However, if an administrator has set the DefaultPublicFolderMailbox property on a user mailbox to a specific public folder mailbox, the user will still access the specified public folder mailbox even if the IsExcludedFromServingHierarchy parameter is set for that public folder mailbox.

Type:$true | $false
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016
-LastName

The LastName parameter specifies the user's last name.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-LinkedCredential

This parameter is available only in on-premises Exchange.

The LinkedCredential parameter specifies credentials to use to access the domain controller specified by the LinkedDomainController parameter. This parameter is optional, even if you're enabling a linked mailbox.

This parameter requires you to create a credentials object by using the Get-Credential cmdlet. For more information, see Get-Credential (https://go.microsoft.com/fwlink/p/?linkId=142122).

Type:PSCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-MailboxPlan

This parameter is available only in the cloud-based service.

The MailboxPlan parameter specifies the mailbox plan to applytothe mailbox. You can use any value that uniquely identifies the mailbox plan. For example:

  • Name

  • Alias

  • Display name

  • Distinguished name (DN)

  • GUID

A mailbox plan specifies the permissions and features that are available to a mailbox. In Office 365, mailbox plans correspond to the subscriptions and licenses that administrators purchase and assign in the Office 365 admin center.

You can see the available mailbox plans by using the Get-MailboxPlan cmdlet.

Type:MailboxPlanIdParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MailboxProvisioningConstraint

This parameter is reserved for internal Microsoft use.

Type:MailboxProvisioningConstraint
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016
-MailboxProvisioningPreferences

This parameter is reserved for internal Microsoft use.

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016
-MailboxRegion

This parameter is reserved for internal Microsoft use.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016
-ManagedFolderMailboxPolicy

The ManagedFolderMailboxPolicy parameter specifies the managed folder mailbox policy to enable for the mailbox that you create.

Type:MailboxPolicyIdParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010
-ManagedFolderMailboxPolicyAllowed

The ManagedFolderMailboxPolicyAllowed parameter specifies whether to bypass the warning that messaging records management (MRM) features aren't supported for e-mail clients using versions of Microsoft Outlook earlier than Office Outlook 2007. When a managed folder mailbox policy is assigned to a mailbox using the ManagedFolderMailboxPolicy parameter, the warning appears by default unless the ManagedFolderMailboxPolicyAllowed parameter is used.

Outlook 2003 Service Pack 3 clients are supported but are provided limited functionality for MRM.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010
-ModeratedBy

The ModeratedBy parameter specifies one or more moderators for this recipient. A moderator approves messages sent to the recipient before the messages are delivered. A moderator must be a mailbox, mail user, or mail contact in your organization. You can use any value that uniquely identifies the moderator.

For example:

  • Name

  • Display name

  • Alias

  • Distinguished name (DN)

  • Canonical DN

  • Email address

  • GUID

To enter multiple values, use the following syntax: <value1>,<value2>,...<valueX>. If the values contain spaces or otherwise require quotation marks, use the following syntax: "<value1>","<value2>",..."<valueX>".

You need to use this parameter to specify at least one moderator when you set the ModerationEnabled parameter to the value $true.

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-ModerationEnabled

The ModerationEnabled parameter specifies whether moderation is enabled for this recipient. Valid value are:

  • $true: Moderation is enabled for this recipient. Messages sent to this recipient must be approved by a moderator before the messages are delivered.

  • $false: Moderation is disabled for this recipient. Messages sent to this recipient are delivered without the approval of a moderator. This is the default value.

You use the ModeratedBy parameter to specify the moderators.

Type:$true | $false
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-Office

The Office parameter specifies the user's physical office name or number.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-OfficeGraph

This parameter is reserved for internal Microsoft use.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016
-OrganizationalUnit

The OrganizationalUnit parameter specifies the location in Active Directory where the new mailbox is created.

Valid input for this parameter is an organizational unit (OU) or domain that's visible using the Get-OrganizationalUnit cmdlet. You can use any value that uniquely identifies the OU or domain. For example:

  • Name

  • Canonical name

  • Distinguished name (DN)

  • GUID

Type:OrganizationalUnitIdParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-Password

The Password parameter specifies the password for the mailbox (the user account that's associated with the mailbox). This parameter isn't required if you're creating a linked mailbox, resource mailbox, or shared mailbox, because the associated user accounts are disabled for these types of mailboxes.

This parameter uses the syntax (ConvertTo-SecureString -String '<password>' -AsPlainText -Force). Or, to be prompted to enter the password and store it as a variable, run the command $password = Read-Host "Enter password" -AsSecureString, and then use the value $password for this parameter.

Type:SecureString
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-Phone

The Phone parameter specifies the user's telephone number.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-PrimarySmtpAddress

The PrimarySmtpAddress parameter specifies the primary return email address that's used for the recipient. If it's available on this cmdlet, you can't use the EmailAddresses and PrimarySmtpAddress parameters in the same command.

If you use the PrimarySmtpAddress parameter to specify the primary email address, the command sets the EmailAddressPolicyEnabled property of the mailbox to False, which means the email addresses of the mailbox aren't automatically updated by email address policies.

Type:SmtpAddress
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-ProvisionedForOfficeGraph

This parameter is reserved for internal Microsoft use.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016
-RemoteArchive

This parameter is available only in on-premises Exchange.

The RemoteArchive switch specifies that a remote archive mailbox is created for this mailbox. A remote archive exists in the cloud-based service. You don't need to specify a value with this switch.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-RemotePowerShellEnabled

The RemotePowerShellEnabled parameter specifies whether the user has access to remote PowerShell. Valid values are:

  • $true: The user has access to Exchange Online PowerShell, the Exchange Management Shell, and the Exchange admin center (EAC). This is the default value.

  • $false: The user has doesn't have access to Exchange Online PowerShell, the Exchange Management Shell, or the EAC.

Access to remote PowerShell is required even if you're trying to open the Exchange Management Shell or the EAC on the local Exchange server.

A user's experience in any of these management interfaces is still controlled by the role-based access control (RBAC) permissions that are assigned to them.

Type:$true | $false
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-RemovedMailbox

This parameter is reserved for internal Microsoft use.

Type:RemovedMailboxIdParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016
-ResetPasswordOnNextLogon

The ResetPasswordOnNextLogon parameter specifies whether the user is required to change their password the next time they log on to their mailbox. Valid values are:

  • $true: The user is required to change their password the next time they log on to their mailbox.

  • $false: The user isn't required to change their password the next time they log on to their mailbox. This is the default value.

Type:$true | $false
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-ResourceCapacity

The ResourceCapacity parameter specifies the capacity of the resource mailbox. For example, you can use this parameter to identify the number of seats in a conference room (room mailbox) or in a vehicle (equipment mailbox). A valid value is an integer.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-RetentionPolicy

This parameter is available only in on-premises Exchange.

The RetentionPolicy parameter specifies the retention policy that you want applied to this mailbox. You can use any value that uniquely identifies the policy. For example:

  • Name

  • Distinguished Name (DN)

  • GUID

Retention policies consist of tags that are applied to mailbox folders and mail items to determine the period of time that the items should be retained.

Use the Get-RetentionPolicy cmdlet to see the available retention policies.

If you don't use this parameter, the retention policy named Default MRM Policy is applied to the mailbox.

Type:MailboxPolicyIdParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-RoleAssignmentPolicy

The RoleAssignmentPolicy parameter specifies the role assignment policy that's applied to the mailbox. You can use any value that uniquely identifies the role assignment policy. For example:

  • Name

  • Distinguished name (DN)

  • GUID

In Office 365, if you don't use this parameter, the default role assignment policy named Default Role Assignment Policy is automatically applied to the mailbox. In on-premises Exchange, no role assignment policy is automatically applied to the mailbox.

Use the Get-RoleAssignmentPolicy cmdlet to see the available role assignment policies. For more information about assignment policies, see Understanding management role assignment policies (https://technet.microsoft.com/library/dd638100.aspx).

Type:MailboxPolicyIdParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-RoomMailboxPassword

Use the RoomMailboxPassword parameter to configure the password for a room mailbox that has a logon-enabled account (the EnableRoomMailboxAccount parameter is set to the value $true.)

To use this parameter, you need to be a member of one of the following role groups:

  • Office 365: The Organization Management role group via the Mail Recipients, Reset Password, and User Options roles, the Help Desk role group via the Reset Password and User Options roles, or the Recipient Management role group via the Mail Recipients and Reset Password roles.

  • On-premises Exchange: The Organization Management role group via the Mail Recipients and User Options roles, the Recipient Management role group via the Mail Recipients role, or the Help Desk role group via the User Options role. The Reset Password role also allows you to use this parameter, but it isn't assigned to any role groups by default.

This parameter uses the syntax (ConvertTo-SecureString -String '<password>' -AsPlainText -Force). Or, to be prompted to enter the password and store it as a variable, run the command $password = Read-Host "Enter password" -AsSecureString, and then use the value $password for this parameter.

Type:SecureString
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016
-SamAccountName

This parameter is available only in on-premises Exchange.

The SamAccountName parameter (also known as the pre-Windows 2000 user account or group name) specifies an object identifier that's compatible with older versions of Microsoft Windows client and server operating systems. The value can contain letters, numbers, spaces, periods (.), and the characters !, #, $, %, ^, &, -, _, {, }, and ~. The last character can't be a period. Unicode characters are allowed, but accented characters may generate collisions (for example, o and ö match). The maximum length is 20 characters.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-SendModerationNotifications

The SendModerationNotifications parameter specifies when moderation notification messages are sent. Valid values are:

  • Always: Notify all senders when their messages aren't approved. This is the default value.

  • Internal: Notify senders in the organization when their messages aren't approved.

  • Never: Don't notify anyone when a message isn't approved.

This parameter is only meaningful when moderation is enabled (the ModerationEnabled parameter has the value $true).

Type:Never | Internal | Always
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-SharingPolicy

This parameter is available only in on-premises Exchange.

The SharingPolicy parameter specifies the sharing policy that's applied to the mailbox. You can use any value that uniquely identifies the sharing policy. For example:

  • Name

  • Distinguished name (DN)

  • GUID

Use the Get-SharingPolicy cmdlet to see the available sharing policies.

If you don't use this parameter, the sharing policy named Default Sharing Policy is applied to the mailbox.

Type:SharingPolicyIdParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-SkipMailboxProvisioningConstraintValidation

This parameter is reserved for internal Microsoft use.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016
-TargetAllMDBs

This parameter is reserved for internal Microsoft use.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016
-ThrottlingPolicy

This parameter is available only in on-premises Exchange.

The ThrottlingPolicy parameter specifies the throttling policy that's applied to the mailbox. You can use any value that uniquely identifies the throttling policy. For example:

  • Name

  • Distinguished name (DN)

  • GUID

Use the Get-ThrottlingPolicy cmdlet to see the available throttling policies.

By default, no throttling policy is applied to the mailbox.

Type:ThrottlingPolicyIdParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-UserPrincipalName

This parameter is available only in on-premises Exchange.

The UserPrincipalName parameter specifies the logon name for the user account. The UPN uses an email address format <username>@<domain>. Typically, the <domain> value is the domain where the user account resides.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016
-WhatIf

The WhatIf switch simulates the actions of the command. You can use this switch to view the changes that would occur without actually applying those changes. You don't need to specify a value with this switch.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

Inputs

To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types (https://go.microsoft.com/fwlink/p/?LinkId=616387). If the Input Type field for a cmdlet is blank, the cmdlet doesn't accept input data.

Outputs

To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types (https://go.microsoft.com/fwlink/p/?LinkId=616387). If the Output Type field is blank, the cmdlet doesn't return data.