Set-User

SharePoint Online: Configures properties on an existing user

Script

#Requires -Version 5.1
#Requires -Modules Microsoft.Online.SharePoint.PowerShell

[CmdletBinding()]
Param(
    [Parameter(Mandatory = $true)]
    [string]$LoginName,
    [Parameter(Mandatory = $true)]
    [string]$Site,
    [bool]$IsSiteCollectionAdmin
)

Process {
    try {
        $cmdArgs = @{ ErrorAction = 'Stop'; LoginName = $LoginName; Site = $Site }
        if ($PSBoundParameters.ContainsKey('IsSiteCollectionAdmin')) { $cmdArgs.Add('IsSiteCollectionAdmin', $IsSiteCollectionAdmin) }
        $result = Set-SPOUser @cmdArgs | Select-Object *
        if ($null -ne $result) { foreach ($item in $result) { $item | Add-Member -NotePropertyName Timestamp -NotePropertyValue (Get-Date -Format "yyyy-MM-dd HH:mm:ss") -PassThru -Force } }
    }
    catch { throw }
}

Customize

LoginName string

User login name

Site string

Full URL of the site collection

IsSiteCollectionAdmin bool

Set whether the user is a site collection administrator