New-MgmtGraphGroup

MgmtGraph: Creates a new Microsoft Graph group

Script

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

[CmdletBinding()]
Param (
    [Parameter(Mandatory = $true)]
    [string]$DisplayName,

    [Parameter(Mandatory = $true)]
    [string]$MailNickname,

    [string]$Description,

    [switch]$SecurityEnabled,

    [switch]$MailEnabled,

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

    [switch]$Microsoft365Group
)

Process {
    try {
        $params = @{
            'DisplayName'     = $DisplayName
            'MailNickname'    = $MailNickname
            'MailEnabled'     = $MailEnabled
            'SecurityEnabled' = $SecurityEnabled
            'Visibility'      = $Visibility
            'Confirm'         = $false
            'ErrorAction'     = 'Stop'
        }

        if ($Description) { $params.Add('Description', $Description) }
        
        if ($Microsoft365Group) {
            $params.Add('GroupTypes', @('Unified'))
        }

        $group = New-MgGroup @params
        
        $result = [PSCustomObject]@{
            DisplayName     = $group.DisplayName
            Id              = $group.Id
            Mail            = $group.Mail
            SecurityEnabled = $group.SecurityEnabled
            MailEnabled     = $group.MailEnabled
            Visibility      = $group.Visibility
            Status          = "GroupCreated"
            Timestamp       = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
        }

        Write-Output $result
    }
    catch {
        throw
    }
}

Customize

DisplayName string

Specifies the display name for the new group.

MailNickname string

Specifies the mail alias for the group. Required for M365 and mail-enabled groups.

Description string

Optional. Specifies a description for the group.

SecurityEnabled switch

Off

If set, creates a security group.

MailEnabled switch

Off

If set, creates a mail-enabled group.

Visibility string

Specifies the visibility level of the group. Valid values: Public, Private.

Microsoft365Group switch

Off

If set, creates a Microsoft 365 (Unified) group.