commandline.info

Troubleshooting Playbooks

Schritt-fuer-Schritt Loesungen fuer typische Paketierungs- und Deployment-Probleme in Enterprise-Umgebungen.

Playbook: MSI Fehler 1603

  1. Deployment mit vollem Logging erneut ausfuehren.
  2. Log auf "Return value 3" und direkte Vorfaelle davor pruefen.
  3. Schreibrechte auf Zielordner/Registry sicherstellen.
  4. Blockierende Prozesse vor Installation beenden.
$msi = 'C:\Packages\App\app.msi'
$log = 'C:\Temp\app-1603-debug.log'
Start-Process msiexec.exe -ArgumentList "/i `"$msi`" /qn /L*v `"$log`"" -Wait
Select-String -Path $log -Pattern 'Return value 3' -Context 0,8

Playbook: Installation laeuft nicht an (1618 / Locked State)

  1. Pruefen, ob parallel ein anderer Installer aktiv ist.
  2. Pending Reboot Status kontrollieren.
  3. Maintenance-Window einplanen und erneut ausrollen.
# Aktive msiexec Prozesse pruefen
Get-Process -Name msiexec -ErrorAction SilentlyContinue

# Pending Reboot quick check
$paths = @(
  'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\WindowsUpdate\Auto Update\RebootRequired',
  'HKLM:\SYSTEM\CurrentControlSet\Control\Session Manager'
)
$paths | ForEach-Object { Test-Path $_ }

Playbook: PSADT Deployment analysieren

  1. PSADT Logdatei im Standardpfad oeffnen.
  2. Auf Severity 3 (Error) und Exit-Code-Mapping schauen.
  3. Installer-Exit-Code mit Intune/MECM Return Codes abgleichen.
$logRoot = Join-Path $env:WINDIR 'Logs\Software'
Get-ChildItem $logRoot -Filter '*.log' |
  Sort-Object LastWriteTime -Descending |
  Select-Object -First 5 FullName, LastWriteTime

# Fehlerstellen markieren
Select-String -Path "$logRoot\*.log" -Pattern 'severity 3|exit code|error' -SimpleMatch

Mini-Checkliste vor jedem Rollout