Share via


New-PartnerCustomerUser

Creates a new user in the specified customer Azure Active Directory tenant.

Syntax

New-PartnerCustomerUser
   -CustomerId <String>
   [-FirstName <String>]
   [-LastName <String>]
   -DisplayName <String>
   -UserPrincipalName <String>
   -Password <SecureString>
   [-ForceChangePassword]
   [-UsageLocation <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The New-PartnerCustomerUser cmdlet creates a new user in the tenant Azure Active Directory.

Examples

Example 1

PS C:\> New-PartnerCustomerUser -CustomerId 45916f92-e9c3-4ed2-b8c2-d87aa129905f -UsageLocation US -UserPrincipalName 'joe@contoso.onmicrosoft.com' -FirstName 'Joe' -LastName 'Smith' -DisplayName 'Joe Smith' -ForceChangePassword -Password $PasswordSecure

Creates a new user account.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CustomerId

The customer identifier.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

The display name for the new customer user.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-FirstName

The first name for the new customer user.

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

-ForceChangePassword

Forces user to change password during next login.

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

-LastName

The last name for the new customer user.

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

-Password

The password for the new custom user as a secure string

Type:SecureString
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-UsageLocation

The location where the customer user will use software and services. Service availability varies by region.

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

-UserPrincipalName

The user principal name (UPN) for the new customer user, including the onmicrosoft.com domain name.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

None

Outputs

Microsoft.Store.PartnerCenter.PowerShell.Models.Users.PSCustomerUser