< Back
New-PartnerCustomerUser
Post
NAME New-PartnerCustomerUser
SYNOPSIS
Creates a new user in the specified customer Azure Active Directory tenant.
SYNTAX
New-PartnerCustomerUser -CustomerId <String> -DisplayName <String> [-FirstName <String>] [-ForceChangePassword]
[-LastName <String>] -Password <SecureString> [-UsageLocation <String>] -UserPrincipalName <String> [-Confirm]
[-WhatIf] [<CommonParameters>]
DESCRIPTION
The New-PartnerCustomerUser cmdlet creates a new user in the tenant Azure Active Directory.
PARAMETERS
-CustomerId <String>
The customer identifier.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-DisplayName <String>
The display name for the new customer user.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-FirstName <String>
The first name for the new customer user.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-ForceChangePassword [<SwitchParameter>]
Forces user to change password during next login.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-LastName <String>
The last name for the new customer user.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Password <SecureString>
The password for the new custom user as a secure string
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-UsageLocation <String>
The location where the customer user will use software and services. Service availability varies by region.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-UserPrincipalName <String>
The user principal name (UPN) for the new customer user, including the onmicrosoft.com domain name.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
None
OUTPUTS
Microsoft.Store.PartnerCenter.PowerShell.Models.Users.PSCustomerUser
NOTES
-------------------------- 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.
RELATED LINKS
Online Version: https://docs.microsoft.com/powershell/m ... stomerUser
SYNOPSIS
Creates a new user in the specified customer Azure Active Directory tenant.
SYNTAX
New-PartnerCustomerUser -CustomerId <String> -DisplayName <String> [-FirstName <String>] [-ForceChangePassword]
[-LastName <String>] -Password <SecureString> [-UsageLocation <String>] -UserPrincipalName <String> [-Confirm]
[-WhatIf] [<CommonParameters>]
DESCRIPTION
The New-PartnerCustomerUser cmdlet creates a new user in the tenant Azure Active Directory.
PARAMETERS
-CustomerId <String>
The customer identifier.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-DisplayName <String>
The display name for the new customer user.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-FirstName <String>
The first name for the new customer user.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-ForceChangePassword [<SwitchParameter>]
Forces user to change password during next login.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-LastName <String>
The last name for the new customer user.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Password <SecureString>
The password for the new custom user as a secure string
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-UsageLocation <String>
The location where the customer user will use software and services. Service availability varies by region.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-UserPrincipalName <String>
The user principal name (UPN) for the new customer user, including the onmicrosoft.com domain name.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
None
OUTPUTS
Microsoft.Store.PartnerCenter.PowerShell.Models.Users.PSCustomerUser
NOTES
-------------------------- 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.
RELATED LINKS
Online Version: https://docs.microsoft.com/powershell/m ... stomerUser