OrderID bzw. GroupTag für ein bestehendes Gerät im Windows Autopilot ändern

In der heutigen IT-Welt ist die effiziente Verwaltung von Geräten eine zentrale Aufgabe. Windows Autopilot bietet eine hervorragende Möglichkeit, neue Geräte bereitzustellen und zu konfigurieren. Doch was ist, wenn man die Konfiguration eines bereits registrierten Geräts ändern muss? In diesem Beitrag zeige ich dir, wie du die OrderID bzw. GroupTag eines bereits vorhandenen Geräts im Windows Autopilot ändern kannst.

Inhaltsverzeichnis

Voraussetzungen

Bevor wir loslegen, stelle sicher, dass du die notwendigen Berechtigungen und Tools installiert hast:

Microsoft Graph PowerShell SDK für die Authentifizierung und Kommunikation mit Intune.
WindowsAutopilotIntune PowerShell Modul für die Verwaltung von Autopilot-Geräten.

Schritt-für-Schritt Anleitung

1. Installiere das Autopilot-Modul

Zunächst müssen wir sicherstellen, dass die notwendigen PowerShell-Module installiert sind.

$nuget = Get-PackageProvider -Name NuGet -ListAvailable -ErrorAction Ignore
if (-not($nuget)) {
Install-PackageProvider -Name NuGet -Confirm:$false -Force
Write-Host "Installed NuGet"
} else {
Write-Host "NuGet already installed"
}

$module = Get-Module -ListAvailable -Name WindowsAutopilotIntune -ErrorAction Ignore
if (-not($module)) {
Install-Module -Name WindowsAutopilotIntune -Confirm:$false -Force
Write-Host "Installed WindowsAutopilotIntune"
} else {
Write-Host "WindowsAutopilotIntune already installed"
}

2. Verbindung zu Microsoft Graph herstellen

Wir müssen uns mit Microsoft Graph verbinden, um die Geräteinformationen abzurufen und zu ändern.

# Verbindung zu Microsoft Graph herstellen
Connect-MgGraph -Scopes "DeviceManagementServiceConfig.ReadWrite.All"

3. SerialNumber des Geräts identifizieren und OrderID bzw. GroupTag ändern

Nun identifizieren wir das Gerät anhand seiner Seriennummer und ändern die OrderID bzw. den GroupTag.

$serialNumber = "PF3HPXXX"

try {
$id = (Get-AutopilotDevice -serial $serialNumber).id
if ($id) {
# Ändere den GroupTag
Set-AutopilotDevice -id $id -GroupTag "SG_DV_Teacher_NB"
Write-Host "Changed group tag for device with serial number $serialNumber"
} else {
Write-Host "Device with serial number $serialNumber not found."
}
} catch {
$message = $_.Exception.Message
Write-Host "Failed to change group tag for device with serial number $serialNumber: $message"
}

Bulk-Bearbeitung: Mehrere Geräte gleichzeitig ändern

Manchmal müssen mehrere Geräte gleichzeitig geändert werden. Hier sind zwei Optionen für die Bulk-Bearbeitung.

Option 1: GroupTag anhand einer Liste von Seriennummern ändern

CSV-Datei vorbereiten: Erstelle eine CSV-Datei mit den Geräten, die geändert werden sollen. Die Datei sollte die Seriennummern enthalten.Beispiel für eine serialNumbers.csv

SerialNumber
PF3HPXXX
X1Y2Z3A4
B8C7D6E5

Skript zur Verarbeitung der CSV-Datei:

$serialNumbers = Import-Csv -Path „C:\path\to\serialNumbers.csv“ | Select-Object -ExpandProperty SerialNumber

Für jede Seriennummer das entsprechende Gerät finden und den GroupTag ändern:

# Liste der Seriennummern aus der CSV-Datei einlesen

foreach ($serialNumber in $serialNumbers) {
try {
$id = (Get-AutopilotDevice -serial $serialNumber).id
Set-AutopilotDevice -id $id -GroupTag "NewGroupTag"
Write-Host "Changed group tag for device with serial number $serialNumber"
} catch {
$message = $_.Exception.Message
Write-Host "Failed to change group tag for device with serial number $serialNumber: $message"
}
}

Option 2: GroupTag anhand eines bestehenden GroupTags ändern

Alten GroupTag definieren:

$oldGroupTag = "OldGroupTag"

Skript zur Verarbeitung der Geräte mit dem alten GroupTag:

# Liste der Geräte mit dem alten GroupTag abrufen
$devices = Get-AutopilotDevice -GroupTag $oldGroupTag

# Für jedes Gerät den GroupTag ändern
foreach ($device in $devices) {
    try {
        Set-AutopilotDevice -id $device.id -GroupTag "NewGroupTag"
        Write-Host "Changed group tag for device with serial number $($device.serialNumber)"
    } catch {
        $message = $_.Exception.Message
        Write-Host "Failed to change group tag for device with serial number $($device.serialNumber): $message"
    }
}

Zusammenfassung

Die Verwaltung von Geräten über Windows Autopilot kann dir viel Zeit und Aufwand ersparen, besonders bei der Bereitstellung neuer Geräte. Aber auch für bestehende Geräte bietet Autopilot Flexibilität. Mit dem obigen Skript kannst du einfach und effizient die OrderID bzw. GroupTag eines bereits registrierten Geräts ändern. Und mit den Optionen für die Bulk-Bearbeitung kannst du diese Änderungen sogar für mehrere Geräte gleichzeitig vornehmen. Dies kann besonders nützlich sein, wenn sich die Anforderungen oder die Zuordnung der Geräte ändern.