Set-MsOUserProperties

MSOnline: Update Azure AD user properties

Script

#Requires -Version 5.1

[CmdletBinding()]
Param(
    [Parameter(Mandatory = $true, ParameterSetName = 'Id')]
    [guid]$UserObjectId,
    [Parameter(Mandatory = $true, ParameterSetName = 'Name')]
    [string]$UserName,
    [Parameter(ParameterSetName = 'Name')]
    [Parameter(ParameterSetName = 'Id')]
    [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,
    [guid]$TenantId
)

Process {
    try {
        if ($PSCmdlet.ParameterSetName -eq 'Id') { $user = Get-MsolUser -ObjectId $UserObjectId -TenantId $TenantId -ErrorAction Stop }
        else { $user = Get-MsolUser -SearchString $UserName -TenantId $TenantId -ErrorAction Stop | Select-Object -First 1 }

        [hashtable]$setArgs = @{'ErrorAction' = 'Stop'; 'ObjectId' = $user.ObjectId; 'TenantId' = $TenantId}
        $stringParams = @('DisplayName','FirstName','LastName','PostalCode','City','Street','PhoneNumber','MobilePhone','Department','Title','Country','State','UsageLocation')
        foreach ($p in $stringParams) {
            $val = Get-Variable -Name $p -ValueOnly
            if (-not [System.String]::IsNullOrWhiteSpace($val)) { $setArgs.Add($p, $val) }
        }

        Set-MsolUser @setArgs
        $result = Get-MsolUser -ObjectId $user.ObjectId -TenantId $TenantId -ErrorAction Stop | Select-Object *
        $result | Add-Member -NotePropertyName Timestamp -NotePropertyValue (Get-Date -Format 'yyyy-MM-dd HH:mm:ss') -PassThru -Force
    }
    catch { throw }
}

Customize

UserObjectId guid

Unique ID of the user

UserName string

Display name, Sign-In Name or UPN of 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

City string

City

Street string

Street address

PhoneNumber string

Phone number

MobilePhone string

Mobile phone number

Department string

Department

Title string

Job title

Country string

Country

State string

State or province

UsageLocation string

Usage location (ISO country code)

TenantId guid

Unique ID of the tenant