Zum Hauptinhalt springen

Installation mit Windows Configuration Designer

Verwenden Sie Windows Configuration Designer, um ein Bereitstellungspaket zu erstellen, das Level auf neuen Windows-Geräten während OOBE bereitstellt.

Einführung

Mit Windows Configuration Designer (WCD) können Sie ein Bereitstellungspaket erstellen — eine .ppkgDatei — die automatisch ausgeführt wird, wenn sie während des Out-of-Box-Erlebnisses (OOBE) auf einem neuen Windows-Gerät eingefügt wird. Sie können damit das Gerät benennen, ein lokales Administratorkonto erstellen, eine drahtlose Netzwerk beitreten und den Level-Agent installieren, alles bevor der Endbenutzer jemals die Tastatur berührt.

In diesem Artikel wird die Erstellung eines Bereitstellungspakets durchlaufen, das den Level-Agent als Teil der neuen Geräteeinrichtung installiert.

⚙️ VORAUSSETZUNGEN

🎬 VIDEO

How It Works

WCD produces a .ppkg Datei. Windows erkennt dieses Dateiformat während OOBE — wenn ein neues Gerät zum ersten Mal startet und den Sprache-/Einrichtungsbildschirm erreicht, wird das Einfügen eines USB-Sticks mit dem .ppkgDie Datei verursacht Windows Verlassen von OOBE und Ausführung des Bereitstellungspakets stattdessen.

Im Paket tritt ein PowerShell-Skript einem drahtlosen Netzwerk bei und installiert den Level-Agent. Der gesamte Bereitstellungsschritt dauert einige Sekunden. Nach Abschluss wird das Gerät in Level angezeigt und ist bereit für weitere Automatisierung.

Installation mit Windows Configuration Designer

Schritt 1: Neues Projekt erstellen

  1. Öffnen Sie Windows Configuration Designer.

  2. Klicken Sie auf Desktopgeräte bereitstellen.

  3. Geben Sie einen Projektnamen ein und wählen Sie einen Speicherort aus.

  4. Klicken Sie auf Finishum den Assistenten zu öffnen.

Provision Desktop Devices

Schritt 2: Konfigurieren Sie den Assistenten

Der Assistent hat sechs Schritte. Hier ist, was bei jedem zu tun ist.

1 — Gerät einrichten

Geben Sie eine Computernamenvorlage ein. Eine häufige Konvention ist CompanyName-%Serial%, der Ihren Unternehmensname der Seriennummer des Geräts voranstellt.

2 — Netzwerk einrichten

Hier können Sie ein drahtloses Netzwerk konfigurieren, aber die drahtlose Verbindung wird möglicherweise nicht hergestellt, bis das Level-Installationsskript ausgeführt wird. Lassen Sie dies leer — das PowerShell-Skript in Schritt 4 behandelt die drahtlose Einrichtung zuverlässiger.

3 — Kontenverwaltung

Richten Sie hier ein lokales Administratorkonto ein. Wenn das Gerät einer Domäne beigetreten werden muss, überspringen Sie den Domänenbeitritt — das kann später über eine Level-Automatisierung nach der Registrierung erfolgen.

4 — Anwendungen hinzufügen

Hier findet die Level-Installation statt. Sie fügen ein PowerShell-Skript hinzu, das einem drahtlosen Netzwerk beitritt und den Level-Agent installiert.

5 — Zertifikate hinzufügen

Keine Änderungen erforderlich.

6 — Finish

Klicken Sie auf Create to generate the .ppkg file.

Schritt 3: PowerShell-Skript vorbereiten

Kopieren Sie das untenstehende Skript in einen Text-Editor und speichern Sie es als.ps1 Datei. Aktualisieren Sie drei Werte vor dem Speichern:

  • Line 2: Replace Put Your SSID Here mit Ihrem drahtlosen Netzwerknamen

  • Line 3: Replace Put Your Wi-Fi Password Here mit Ihrem drahtlosen Passwort

  • Near the end: Fügen Sie Ihren Level-Installationsbefehl ein, wo angegeben (holen Sie ihn sich vonNeues Gerät hinzufügen → Windows → Einzeilenbefehl in Level)

param(
    [string]$SSID = "Put Your SSID Here",
    [string]$PSK = "Put Your Wi-Fi Password Here"
)

# Create temp folder for logging
$TempFolder = 'C:\temp'
if (Test-Path -Path $TempFolder) {
    "$TempFolder exists."
} else {
    "$TempFolder doesn't exist. Creating it now."
    mkdir $TempFolder
}

Start-Transcript -Append "$TempFolder\LevelInstall.txt"

# Create a wireless profile
$guid = New-Guid
$HexArray = $SSID.ToCharArray() | ForEach-Object {
    [System.String]::Format("{0:X}", [System.Convert]::ToUInt32($_))
}
$HexSSID = $HexArray -join ""

@"
<?xml version="1.0"?>
<WLANProfile xmlns="http://www.microsoft.com/networking/WLAN/profile/v1">
  <name>$($SSID)</name>
  <SSIDConfig>
    <SSID>
      <hex>$($HexSSID)</hex>
      <name>$($SSID)</name>
    </SSID>
  </SSIDConfig>
  <connectionType>ESS</connectionType>
  <connectionMode>auto</connectionMode>
  <MSM>
    <security>
      <authEncryption>
        <authentication>WPA2PSK</authentication>
        <encryption>AES</encryption>
        <useOneX>false</useOneX>
      </authEncryption>
      <sharedKey>
        <keyType>passPhrase</keyType>
        <protected>false</protected>
        <keyMaterial>$($PSK)</keyMaterial>
      </sharedKey>
    </security>
  </MSM>
  <MacRandomization xmlns="http://www.microsoft.com/networking/WLAN/profile/v3">
    <enableRandomization>false</enableRandomization>
    <randomizationSeed>1451755948</randomizationSeed>
  </MacRandomization>
</WLANProfile>
"@ | Out-File "$TempFolder\$guid.SSID"

netsh wlan add profile filename="$TempFolder\$guid.SSID" user=all
Start-Sleep -Seconds 5
Remove-Item "$TempFolder\$guid.SSID" -Force
netsh wlan connect name=$SSID

# Wait for network connectivity before downloading Level
$timeout = New-TimeSpan -Minutes 2
$endTime = (Get-Date).Add($timeout)
$testSite = "downloads.level.io"
while (!(Test-Connection -ComputerName $testSite -Quiet)) {
    Start-Sleep -Seconds 5
    if ((Get-Date) -gt $endTime) {
        "$testSite connectivity timeout exceeded. Network connectivity not established."
        break
    }
}

# Paste your Level install command on the line below
# Get it from: Level → Add new device → Windows → One-line command

Stop-Transcript

💡 TIP: Das Skript protokolliert seine Ausgabe in C:\temp\LevelInstall.txtauf dem Zielgerät. Überprüfen Sie diese Datei, wenn der Level-Agent nach der Bereitstellung nicht angezeigt wird.

⚠️ WARNUNG: Das drahtlose Passwort wird in Klartext im.ps1Datei und in die.ppkgeingebettet. Behandeln Sie das Bereitstellungspaket als vertrauliche Datei und beschränken Sie, wer darauf Zugriff hat.

Schritt 4: Skript zum Paket hinzufügen

Zurück im WCD-Assistent unter demAnwendungen hinzufügen step:

  1. Klicken Sie auf +eine Anwendung hinzuzufügen.

  2. Geben Sie ihm einen Namen (z. B. Level-Agent installieren).

  3. In the Installer PathFeld, navigieren Sie zu und wählen Sie Ihren .ps1 file.

  4. In the Befehlszeilenargumente field, enter:

powershell.exe -executionpolicy bypass -file "your_script.ps1"

Replace your_script.ps1mit dem aktuellen Dateinamen.

  1. Lassen Sie alle anderen Einstellungen auf ihren Standardwerten und klicken SieAdd.

Schritt 5: Paket generieren und bereitstellen

  1. Füllen Sie die verbleibenden Assistentenschritte aus und klicken SieCreate auf der Seite Finish.

  2. Kopieren Sie die generierte .ppkg Datei auf ein USB-Laufwerk. Nur die.ppkg is needed — the .ps1Skript ist darin eingebettet.

Zum Bereitstellen auf einem neuen Gerät:

  1. Schalten Sie das Gerät ein. Es startet in OOBE und zeigt den Sprachauswahlbildschirm an.

  2. Beantworten Sie keine OOBE-Eingabeaufforderungen.

  3. Stecken Sie das USB-Laufwerk ein.

  4. Windows erkennt die .ppkgDatei und beginnt automatisch mit der Bereitstellung.

Das Gerät benennt sich selbst um, erstellt das lokale Administratorkonto, tritt dem drahtlosen Netzwerk bei und installiert den Level-Agent. Es erscheint dann in Ihrem Level Device Listing .

OOBE Setup

ℹ️ HINWEIS:Der Bereitstellungsprozess dauert einige Sekunden. Das Gerät startet ein- oder zweimal im Rahmen des Prozesses neu — dies ist zu erwarten.

FAQ

  • Kann ich dies für Geräte verwenden, die einer Domäne beigetreten werden? Ja — richten Sie das lokale Administratorkonto im Assistenten ein, überspringen Sie den Domänenbeitrittschritt und handhaben Sie den Domänenbeitritt später über eine Level-Automatisierung nach der Geräteregistrierung.

  • Was ist, wenn mein Netzwerk kein WPA2 PSK verwendet? Das drahtlose Profil im Skript ist für WPA2 PSK konfiguriert. Wenn Ihr Netzwerk eine andere Authentifizierungsmethode verwendet (WPA3, 802.1X, usw.), aktualisieren Sie die<authentication> and <encryption> Werte im XML-Profil entsprechend.

  • Das Gerät wurde bereitgestellt, aber Level wird nicht angezeigt — was ist passiert? Check C:\temp\LevelInstall.txt auf dem Gerät für das Installationsprotokoll. Häufige Ursachen: Das drahtlose Netzwerk wurde nicht beigetreten, bevor die Konnektivitäts-Timeout abgelaufen ist, oder ein AV/EDR-Tool hat den Level-Download blockiert. Siehe AV/EDR-Fehldetektionen and Offline-Fehlerbehebung .

  • Muss ich für jede Gerätegruppe in Level ein neues Paket erstellen?Ja — der im Skript eingebettete Installationsschlüssel bestimmt, in welche Gruppe das Gerät fällt. Erstellen Sie ein separates.ppkg pro Gruppe, oder verwenden Sie einen einzelnen Installationsschlüssel ohne Gruppe und verschieben Sie Geräte später.

  • Kann ich statt drahtlos ein kabelgebundenes Netzwerk verwenden? Ja — entfernen Sie das drahtlose Profil undnetsh wlan Abschnitte aus dem Skript und vereinfachen Sie die Konnektivitätsprüfung auf einfach Überprüfung, dass downloads.level.io is reachable.

Verwandte Artikel
Windows Install
Installation über Gruppenrichtlinie
Installation über InTune
Uninstall Level
Windows Update Troubleshooting
Hat dies deine Frage beantwortet?