Functions/Set-AutopilotComputernameAndGrouptag.ps1


function Set-AutopilotComputernameAndGrouptag {
    <#
    .SYNOPSIS
        Set computernames and grouptags in Windows Autopilot from a CSV file
    .DESCRIPTION
        Use if you want to set computernames to something else instead of the serialnumber and random number options available in Intune.
        This function can also set grouptags
 
        Parameter CsvFile can be a local file or a URL
        Example template for CSV file:
            SerialNumber,AssetTag,GroupTag
            ABC1234,Laptop1,SharedLaptop
            DEF5678,Computer1,SharedDesktop
            XYZ9876,Laptop2,PersonalLaptop
            QWE1289,Laptop3,PersonalLaptop
 
        If you don't want to set either Computername or grouptag, you can leave the column blank or remove it completely.
 
    .NOTES
 
    .LINK
 
    .EXAMPLE
        Set-AutopilotComputernameAndGrouptag -CsvFile https://storageaccount.blob.core.windows.net/intune/DevicesSerialNumberAndAssetTag.csv -ComputernamePrefix "Custcode-" -StartAutopilotSync
        Sets computername and grouptag based on the Azure storage CSV file with prefix "Custcode-" (example: "Custcode-Laptop1") and starts the Autopilot sync process.
 
    .EXAMPLE
        Set-AutopilotComputernameAndGrouptag -CsvFile https://storageaccount.blob.core.windows.net/intune/DevicesSerialNumberAndAssetTag.csv -ComputernamePrefix "Company-" -WhatIf
        Runs the command but does not change any computernames or grouptags in Autopilot.
 
 
    #>


    [CmdletBinding()]
    param (
        [Parameter()] [string] $ComputernamePrefix,
        [Parameter()] [string] $ComputernameSuffix,
        [Parameter()] [string] $CsvFile,
        [Parameter()] [switch] $StartAutopilotSync,
        [Parameter()] [switch] $WhatIf
    )



    if (-not(Get-MgUser -ea 0)) {
        Write-Error "MgGraph not connected, please connect with Connect-MgGraph"
        break
    }

    if ((Get-MgProfile).Name -ne "beta") {
        Select-MgProfile beta
    }


    if (-not(Get-MgDeviceManagementWindowAutopilotDeviceIdentity -Top 1)) {
        Write-Error "No Autopilot devices found"
        break
    }



    $Config = @{
        Prefix        = $ComputernamePrefix
        Suffix        = $ComputernameSuffix
        SourceCSVFile = $CsvFile
        LocalCSVFile  = "$($env:TEMP)\DevicesSerialNumberAndAssetTag.csv"
    }


    $Autopilotdevices = Get-MgDeviceManagementWindowAutopilotDeviceIdentity -All
    # $Autopilotdevices | Format-Table

    Remove-Item $Config.LocalCSVFile -Force -ea 0
    Start-BitsTransfer -Source $Config.SourceCSVFile -Destination $Config.LocalCSVFile -ErrorAction Stop

    $DeviceImport = Import-Csv $Config.LocalCSVFile
    # $DeviceImport | Format-Table


    foreach ($ID in $DeviceImport) {

        $CurrentAutopilotDevice = $Autopilotdevices | Where-Object serialNumber -EQ $ID.SerialNumber

        # $CurrentAutopilotDevice



        foreach ($c in $CurrentAutopilotDevice) {
            if ($ID.Grouptag) {
                if ($c.groupTag -ne $ID.Grouptag) {
                    if (-not($WhatIf)) {
                        # Set-AutopilotDevice -id $($c.id) -groupTag $($ID.Grouptag)
                        Update-MgDeviceManagementWindowAutopilotDeviceIdentityDeviceProperty -WindowsAutopilotDeviceIdentityId $($c.id) -GroupTag $($ID.Grouptag)
                    }
                    Write-Output "$($ID.SerialNumber) - Update-MgDeviceManagementWindowAutopilotDeviceIdentityDeviceProperty -WindowsAutopilotDeviceIdentityId $($c.id) -GroupTag $($ID.Grouptag)"
                }
            }
            if ($ID.AssetTag) {
                $NewComputerName = "$($Config.Prefix)$($ID.AssetTag)$($Config.Suffix)"
                if ($c.displayName -ne $NewComputerName) {
                    if (-not($WhatIf)) {
                        # Set-AutopilotDevice -id $($c.id) -displayName $NewComputerName
                        Update-MgDeviceManagementWindowAutopilotDeviceIdentityDeviceProperty -WindowsAutopilotDeviceIdentityId $($c.id) -DisplayName $($NewComputerName)
                    }
                    Write-Output "$($ID.SerialNumber) - Update-MgDeviceManagementWindowAutopilotDeviceIdentityDeviceProperty -WindowsAutopilotDeviceIdentityId $($c.id) -DisplayName $($NewComputerName)"
                }
            }

        }

    }

    if ($StartAutopilotSync) {
        if (-not($WhatIf)) {
            Sync-MgDeviceManagementWindowAutopilotSetting
        }
    }


    Remove-Item $config.LocalCSVFile -Force -ErrorAction 0

    ###


}