New-MsOUser

MSOnline: Create a user in Azure AD

Script

#Requires -Version 5.1

[CmdletBinding()]
Param(
    [Parameter(Mandatory = $true)]
    [string]$UserPrincipalName,
    [securestring]$Password,
    [Parameter(Mandatory = $true)]
    [string]$DisplayName,
    [string]$FirstName,
    [string]$LastName,
    [string]$PostalCode,
    [string]$City,
    [string]$Street,
    [string]$PhoneNumber,
    [string]$MobilePhone,
    [string]$Department,
    [string]$Title,
    [string]$Country,
    [string]$State,
    [string]$UsageLocation,
    [switch]$ForceChangePassword,
    [guid]$TenantId
)

Process {
    try {
        [hashtable]$newArgs = @{'ErrorAction' = 'Stop'; 'UserPrincipalName' = $UserPrincipalName; 'DisplayName' = $DisplayName; 'TenantId' = $TenantId}
        if ($null -ne $Password) { $newArgs.Add('Password', (New-Object System.Net.NetworkCredential('', $Password)).Password) }
        if (-not [System.String]::IsNullOrWhiteSpace($FirstName)) { $newArgs.Add('FirstName', $FirstName) }
        if (-not [System.String]::IsNullOrWhiteSpace($LastName)) { $newArgs.Add('LastName', $LastName) }
        if (-not [System.String]::IsNullOrWhiteSpace($UsageLocation)) { $newArgs.Add('UsageLocation', $UsageLocation) }
        if ($ForceChangePassword) { $newArgs.Add('ForceChangePassword', $true) }

        $result = New-MsolUser @newArgs | Select-Object *
        if ($null -eq $result) { Write-Output "Failed to create user"; return }
        $result | Add-Member -NotePropertyName Timestamp -NotePropertyValue (Get-Date -Format 'yyyy-MM-dd HH:mm:ss') -PassThru -Force
    }
    catch { throw }
}

Customize

UserPrincipalName string

User ID for this user

Password securestring

New password for the user

DisplayName string

Display name of the user

FirstName string

First name of the user

LastName string

Last name of the user

PostalCode string

Postal code of the user

City string

City of the user

Street string

Street address of the user

PhoneNumber string

Phone number of the user

MobilePhone string

Mobile phone number

Department string

Department of the user

Title string

Job title of the user

Country string

Country of the user

State string

State or province

UsageLocation string

Usage location (ISO country code)

ForceChangePassword switch

Off

User must change password on next sign-in

TenantId guid

Unique ID of the tenant