Set-MgmtGraphGroup

MgmtGraph: Updates Microsoft Graph group properties

Script

#Requires -Version 5.1
#Requires -Modules Microsoft.Graph.Groups

[CmdletBinding()]
Param (
    [Parameter(Mandatory = $true, Position = 0)]
    [string]$Identity,

    [string]$DisplayName,

    [string]$Description,

    [ValidateSet('Public', 'Private')]
    [string]$Visibility,

    [string]$MailNickname
)

Process {
    try {
        $params = @{
            'GroupId'     = $Identity
            'Confirm'     = $false
            'ErrorAction' = 'Stop'
        }

        if ($PSBoundParameters.ContainsKey('DisplayName')) { $params.Add('DisplayName', $DisplayName) }
        if ($PSBoundParameters.ContainsKey('Description')) { $params.Add('Description', $Description) }
        if ($PSBoundParameters.ContainsKey('Visibility')) { $params.Add('Visibility', $Visibility) }
        if ($PSBoundParameters.ContainsKey('MailNickname')) { $params.Add('MailNickname', $MailNickname) }

        if ($params.Count -gt 3) {
            Update-MgGroup @params
            
            $result = [PSCustomObject]@{
                GroupId   = $Identity
                Action    = "GroupUpdated"
                Status    = "Success"
                Timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
            }
            Write-Output $result
        }
        else {
            Write-Warning "No properties specified to update for group '$Identity'."
        }
    }
    catch {
        throw
    }
}

Customize

Identity string

Specifies the ID of the group to update.

DisplayName string

Optional. Specifies the new display name.

Description string

Optional. Specifies the new description.

Visibility string

Optional. Specifies the new visibility level (Public, Private).

MailNickname string

Optional. Specifies the new mail alias.