Windows Configuration Designer (WCD) le permite crear un paquete de aprovisionamiento — un archivo .ppkg — que se ejecuta automáticamente cuando se inserta en un nuevo dispositivo Windows durante la experiencia fuera de la caja (OOBE). Puede usarlo para nombrar el dispositivo, crear una cuenta de administrador local, unirse a una red inalámbrica e instalar el agente Level, todo antes de que el usuario final toque el teclado.

Este artículo explica cómo crear un paquete de aprovisionamiento que instale el agente Level como parte de la configuración del nuevo dispositivo.

⚙️ REQUISITOS PREVIOS

Windows Configuration Designer instalado (descargar gratis desde Microsoft Store)
Una cuenta Level con permiso para agregar dispositivos
Una unidad USB para implementar el paquete

🎬 VÍDEO

Cómo funciona

WCD produce un archivo .ppkg. Windows reconoce este formato de archivo durante OOBE — cuando un nuevo dispositivo arranca por primera vez y llega a la pantalla de selección de idioma/configuración, insertar una unidad USB con el archivo .ppkg hace que Windows salga de OOBE y ejecute el paquete de aprovisionamiento.

En el paquete, un script de PowerShell se conecta a una red inalámbrica e instala el agente Level. Todo el paso de aprovisionamiento toma algunos segundos. Una vez completado, el dispositivo aparece en Level y está listo para más automatización.

Instalación con Windows Configuration Designer

Paso 1: Crear un nuevo proyecto

Abra Windows Configuration Designer.
Haga clic en Provision Desktop Devices.
Ingrese un nombre de proyecto y elija una ubicación de guardado.
Haga clic en Finalizar para abrir el asistente.

Paso 2: Configurar el asistente

El asistente tiene seis pasos. Esto es lo que debe hacer en cada uno.

1 — Configurar dispositivo

Ingrese una plantilla de nombre de computadora. Una convención común es CompanyName-%Serial%, que antepone su nombre de empresa al número de serie del dispositivo.

2 — Configurar red

Puede configurar una red inalámbrica aquí, pero la conexión inalámbrica puede no estar establecida cuando se ejecute el script de instalación de Level. Déjelo en blanco — el script de PowerShell en el Paso 4 maneja la configuración inalámbrica de manera más confiable.

3 — Gestión de cuentas

Configure una cuenta de administrador local aquí. Si el dispositivo necesita unirse al dominio, omita el paso de unión al dominio — eso se puede manejar a través de una automatización Level después de la inscripción.

4 — Agregar aplicaciones

Aquí es donde ocurre la instalación de Level. Agregará un script de PowerShell que se conecta a la red inalámbrica e instala el agente Level.

5 — Agregar certificados

Sin cambios necesarios.

6 — Finalizar

Haga clic en Crear para generar el archivo .ppkg.

Paso 3: Preparar el script de PowerShell

Copie el script a continuación en un editor de texto y guárdelo como un archivo .ps1. Actualice tres valores antes de guardar:

Línea 2: Reemplace Put Your SSID Here con el nombre de su red inalámbrica
Línea 3: Reemplace Put Your Wi-Fi Password Here con su contraseña inalámbrica
Cerca del final: Pegue su comando de instalación Level donde se indica (obténgalo de Agregar nuevo dispositivo → Windows → Comando de una línea en 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

💡 CONSEJO: El script registra su salida en C:\temp\LevelInstall.txt en el dispositivo de destino. Consulte este archivo si el agente Level no aparece después del aprovisionamiento.

⚠️ ADVERTENCIA: La contraseña inalámbrica se almacena en texto sin cifrar en el archivo .ps1 e incrustada en el .ppkg. Trate el paquete de aprovisionamiento como un archivo sensible y limite quién tiene acceso a él.

Paso 4: Agregar el script al paquete

De vuelta en el asistente de WCD en el paso Agregar aplicaciones:

Haga clic en + para agregar una aplicación.
Asígnele un nombre (por ejemplo, « Instalar agente Level »).
En el campo Ruta del instalador, busque y seleccione su archivo .ps1.
En el campo Argumentos de línea de comandos, ingrese:

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

Reemplace your_script.ps1 con el nombre de archivo real.

Deje todos los demás valores en sus predeterminados y haga clic en Agregar.

Paso 5: Generar e implementar el paquete

Complete los pasos restantes del asistente y haga clic en Crear en la página Finalizar.
Copie el archivo .ppkg generado en una unidad USB. Solo se necesita el .ppkg — el script .ps1 está incrustado.

Para implementar en un nuevo dispositivo:

Encienda el dispositivo. Arrancará en OOBE y mostrará la pantalla de selección de idioma.
No responda a ninguna solicitud de OOBE.
Inserte la unidad USB.
Windows detecta el archivo .ppkg y comienza el aprovisionamiento automáticamente.

El dispositivo se renombra, crea la cuenta de administrador local, se conecta a la red inalámbrica e instala el agente Level. Luego aparece en su Lista de dispositivos Level.

ℹ️ NOTA: El proceso de aprovisionamiento toma algunos segundos. El dispositivo se reiniciará una o dos veces como parte del proceso — esto es esperado.

FAQ

¿Puedo usar esto para dispositivos que se unirán a un dominio? Sí — configure la cuenta de administrador local en el asistente, omita el paso de unión al dominio, y maneje la unión al dominio más tarde a través de una automatización Level después de la inscripción del dispositivo.
¿Y si mi red no usa WPA2 PSK? El perfil inalámbrico en el script está configurado para WPA2 PSK. Si su red utiliza un método de autenticación diferente (WPA3, 802.1X, etc.), actualice los valores <authentication> y <encryption> en el perfil XML en consecuencia.
El dispositivo fue aprovisionado pero Level no aparece — ¿qué sucedió? Consulte C:\temp\LevelInstall.txt en el dispositivo para el registro de instalación. Las causas comunes: la red inalámbrica no se unió antes de que expirara el tiempo de espera de conectividad, o una herramienta AV/EDR bloqueó la descarga de Level. Consulte Detecciones falsas de AV/EDR e Solución de problemas sin conexión.
¿Necesito crear un nuevo paquete para cada grupo de dispositivos en Level? Sí — la clave de instalación incrustada en el script determina en qué grupo aterriza el dispositivo. Cree un .ppkg separado por grupo, o use una sola clave de instalación sin grupo y mueva los dispositivos después.
¿Puedo usar una red cableada en lugar de inalámbrica? Sí — elimine el perfil inalámbrico y las secciones netsh wlan del script y simplifique la verificación de conectividad para simplemente verificar que downloads.level.io sea alcanzable.