Set-MsOGroupProperties

MSOnline: Update Azure AD group properties

Script

#Requires -Version 5.1

[CmdletBinding()]
Param(
    [Parameter(Mandatory = $true, ParameterSetName = 'Id')]
    [guid]$GroupObjectId,
    [Parameter(Mandatory = $true, ParameterSetName = 'Name')]
    [string]$GroupName,
    [Parameter(ParameterSetName = 'Name')]
    [Parameter(ParameterSetName = 'Id')]
    [string]$Description,
    [Parameter(ParameterSetName = 'Name')]
    [Parameter(ParameterSetName = 'Id')]
    [string]$DisplayName,
    [Parameter(ParameterSetName = 'Name')]
    [Parameter(ParameterSetName = 'Id')]
    [guid]$TenantId
)

Process {
    try {
        if ($PSCmdlet.ParameterSetName -eq 'Id') { $grp = Get-MsolGroup -ObjectId $GroupObjectId -TenantId $TenantId -ErrorAction Stop }
        else { $grp = Get-MsolGroup -SearchString $GroupName -TenantId $TenantId -ErrorAction Stop | Select-Object -First 1 }

        [hashtable]$setArgs = @{'ErrorAction' = 'Stop'; 'ObjectId' = $grp.ObjectId; 'TenantId' = $TenantId}
        if (-not [System.String]::IsNullOrWhiteSpace($Description)) { $setArgs.Add('Description', $Description) }
        if (-not [System.String]::IsNullOrWhiteSpace($DisplayName)) { $setArgs.Add('DisplayName', $DisplayName) }

        Set-MsolGroup @setArgs
        $result = Get-MsolGroup -ObjectId $grp.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

GroupObjectId guid

Unique ID of the group to update

GroupName string

Display name of the group to update

Description string

New description for the group

DisplayName string

New display name for the group

TenantId guid

Unique ID of the tenant