New-AzureRmADUser

NAME New-AzureRmADUser



SYNOPSIS

Creates a new active directory user.





SYNTAX

New-AzureRmADUser [-DefaultProfile <IAzureContextContainer>] -DisplayName <String> [-ForceChangePasswordNextLogin] [-ImmutableId <String>]

-Password <SecureString> -UserPrincipalName <String> [-Confirm] [-WhatIf] [<CommonParameters>]





DESCRIPTION

Creates a new active directory user (work/school account also popularly known as org-id). For more information:

https://msdn.microsoft.com/en-us/librar ... CreateUser





PARAMETERS

-DefaultProfile <IAzureContextContainer>

The credentials, account, tenant, and subscription used for communication with azure



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-DisplayName <String>

The name to display in the address book for the user. example 'Alex Wu'.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-ForceChangePasswordNextLogin [<SwitchParameter>]

It must be specified if the user must change the password on the next successful login (true). Default behavior is (false) to not change the

password on the next successful login.



Required? false

Position? named

Default value False

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-ImmutableId <String>

It needs to be specified only if you are using a federated domain for the user's user principal name (upn) property.



Required? false

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Password <SecureString>

Password for the user. It must meet the tenant's password complexity requirements. It is recommended to set a strong password.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-UserPrincipalName <String>

The user principal name. Example-'someuser@contoso.com'.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

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>]





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 (http://go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

None

This cmdlet does not accept any input.





OUTPUTS

Microsoft.Azure.Graph.RBAC.Version1_6.ActiveDirectory.PSADUser







NOTES









Example 1



PS C:\\> {{ Add example code here }}



{{ Add example description here }}







RELATED LINKS

Online Version: https://docs.microsoft.com/en-us/powers ... rermaduser

Get-AzureRmADUser

Set-AzureRmADUser

Remove-AzureRmADUser