Skip to content

Get-MgmtGraphDeviceConfigurationAssignment

MgmtGraph: Audits Intune device configuration assignments

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

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

    [string]$AssignmentId
)

Process {
    try {
        $params = @{
            'DeviceConfigurationId' = $ConfigurationId
            'ErrorAction'           = 'Stop'
        }

        if ($AssignmentId) {
            $params.Add('DeviceConfigurationAssignmentId', $AssignmentId)
        }
        else {
            $params.Add('All', $true)
        }

        $assignments = Get-MgDeviceManagementDeviceConfigurationAssignment @params
        
        $results = foreach ($a in $assignments) {
            [PSCustomObject]@{
                ConfigurationId = $ConfigurationId
                AssignmentId    = $a.Id
                Target          = $a.Target.OdataType
                GroupId         = $a.Target.GroupId
                Timestamp       = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
            }
        }

        Write-Output $results
    }
    catch {
        throw
    }
}

Specifies the ID of the device configuration profile.

Optional. Specifies the ID of a specific assignment to retrieve. If omitted, all assignments for the profile are listed.

An interactive directory of PowerShell scripts.