New-PCCustomerUser.md

New-PCCustomerUser

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

SYNTAX

New-PCCustomerUser [-TenantId <String>] -UsageLocation <String> -UserPrincipalName <String> -FirstName <String> -LastName <String> -DisplayName <String> -Password <SecureString> -ForceChangePassword <Boolean> [-SaToken <String>] [<CommonParameters>]

DESCRIPTION

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

PARAMETERS

-TenantId <String>

Specifies the tenant used for scoping this cmdlet.

Required?                    false
Position?                    named
Default value                $GlobalCustomerId
Accept pipeline input?       false
Accept wildcard characters?  false

-UsageLocation <String>

Specifies the location the user will be used.

Required?                    true
Position?                    named
Default value
Accept pipeline input?       false
Accept wildcard characters?  false

-UserPrincipalName <String>

Specifies the user name including the domain for the new user.

Required?                    true
Position?                    named
Default value
Accept pipeline input?       false
Accept wildcard characters?  false

-FirstName <String>

Specifies the first name of the new users.

Required?                    true
Position?                    named
Default value
Accept pipeline input?       false
Accept wildcard characters?  false

-LastName <String>

Specifies the last name for the new user.

Required?                    true
Position?                    named
Default value
Accept pipeline input?       false
Accept wildcard characters?  false

-DisplayName <String>

Specifies the display name for the new user.

Required?                    true
Position?                    named
Default value
Accept pipeline input?       false
Accept wildcard characters?  false

-Password <SecureString>

Specifies a secure string to be assigned as the password for the new user.

Required?                    true
Position?                    named
Default value
Accept pipeline input?       false
Accept wildcard characters?  false

-ForceChangePassword <Boolean>

Specifies whether the new user must change their password during the first logon.

Required?                    true
Position?                    named
Default value                False
Accept pipeline input?       false
Accept wildcard characters?  false

-SaToken <String>

Specifies an authentication token with your Partner Center credentials.

Required?                    false
Position?                    named
Default value                $GlobalToken
Accept pipeline input?       false
Accept wildcard characters?  false

INPUTS

OUTPUTS

NOTES

EXAMPLES

EXAMPLE 1

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