Export (0) Print
Expand All
Expand Minimize

New-EOPMailUser

Exchange 2013
 

Applies to: Exchange Online Protection

Topic Last Modified: 2014-10-15

This cmdlet is available only in Exchange Online Protection.

Use the New-EOPMailUser cmdlet to create mail users, also known as mail-enabled users, in Microsoft Exchange Online Protection ( EOP) standalone. This cmdlet isn't available in Exchange Enterprise CAL with Services (EOP Premium). In EOP Premium, use the New-MailUser cmdlet.

NoteNote:
Typically, EOP standalone customers that also have on-premises Active Directory organizations would use directory synchronization to create users and groups in EOP. However, if you can’t use directory synchronization, then you can use cmdlets to create and manage users and groups in EOP.
ImportantImportant:
This cmdlet uses a batch processing method that results in a propagation delay of a few minutes before the results of the cmdlet are visible.

For information about the parameter sets in the Syntax section below, see Syntax.

New-EOPMailUser -MicrosoftOnlineServicesID <WindowsLiveId> -Name <String> -Password <SecureString> [-Alias <String>] [-DisplayName <String>] [-ExternalEmailAddress <ProxyAddress>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-Organization <OrganizationIdParameter>] [-PrimarySmtpAddress <SmtpAddress>]

This example creates a mail user object for Ed Meadows while specifying several additional optional parameters and using an in-line method of password encryption.

New-EOPMailUser -Name EdMeadows -MicrosoftOnlineServicesID EdMeadows@Contoso.onmicrosoft.com -ExternalEmailAddress EdMeadows@tailspintoys.com -Password (ConvertTo-SecureString -String 'Pa$$w0rd' -AsPlainText -Force) -FirstName Ed -LastName Meadows -DisplayName "Ed Meadows" -Alias edm

You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the "Users, Contacts, and Role Groups" entry in the Feature permissions in EOP topic.

 

Parameter Required Type Description

MicrosoftOnlineServicesID

Required

Microsoft.Exchange.Data.WindowsLiveId

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.

Name

Required

System.String

The Name parameter specifies the name of the mail user object. The value specified in the Name parameter is also used for the DisplayName parameter if the DisplayName parameter isn't specified.

The Name parameter value can't exceed 64 characters.

Password

Required

System.Security.SecureString

The Password parameter the password for the mail-enabled user. You need to specify the value for this parameter by using the following syntax: (ConvertTo-SecureString -String '<password>' -AsPlainText -Force).

Alias

Optional

System.String

The Alias parameter specifies the alias of the mail user.

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, but they will be mapped to a best-fit US-ASCII text character if the Alias value is used to generate the email address.

DisplayName

Optional

System.String

The DisplayName parameter specifies the name of the mail user in the Exchange admin center (EAC).

ExternalEmailAddress

Optional

Microsoft.Exchange.Data.ProxyAddress

The ExternalEmailAddress parameter specifies the user's email address that's outside of the Exchange Online Protection organization. Email messages sent to the mail user are relayed to this external address.

FirstName

Optional

System.String

The FirstName parameter specifies the user's first name.

Initials

Optional

System.String

The Initials parameter specifies the user's middle initials.

LastName

Optional

System.String

The LastName parameter specifies the user's last name.

Organization

Optional

Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter

The Organization parameter is reserved for internal Microsoft use.

PrimarySmtpAddress

Optional

Microsoft.Exchange.Data.SmtpAddress

The PrimarySmtpAddress parameter specifies the primary email address for the mail user. If you don't use this parameter or the ExternalEmailAddress parameter, the value of the MicrosoftOnlineServicesID parameter is used as the primary email address.

To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types. If the Input Type field for a cmdlet is blank, the cmdlet doesn’t accept input data.

To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types. If the Output Type field is blank, the cmdlet doesn’t return data.

 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft