> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bestehende Verteilung aktualisieren

> Bring Geräte, auf denen Langdock schon läuft, auf das aktuelle Deployment-Kit oder das macOS-PKG. So bekommen sie die Wasserzeichen-Kamera und geräteweite Updates ohne Neuinstallation.

## Eine bestehende Verteilung aktualisieren

Du hast die Langdock Desktop-App schon verteilt? Mit diesen Schritten bringst du deine Geräte auf das aktuelle Release aus dem [Enterprise-Guide für Langdock Desktop](https://docs.langdock.com/de/admin/desktop-app/deploy.md). Langdock bleibt dabei die ganze Zeit installiert, und alle behalten ihre Anmeldung und ihre App-Daten. Nutze sie, wenn Langdock die User bittet, sich wegen eines Updates oder der Wasserzeichen-Kamera für Meetings an ihre IT zu wenden, oder wenn du von der reinen MSIX oder der DMG auf die verwalteten Pakete wechselst.

Wähle den Abschnitt, der zu deiner Verteilung passt:

| Du hast verteilt | Weiter mit |
| - | - |
| Die Win32-App in Intune (`.intunewin`) | [Win32-App in Intune](#win32-app-in-intune) |
| Die MSIX als Line-of-Business-App in Intune | [Line-of-Business-App in Intune](#line-of-business-app-in-intune) |
| Die MSIX oder das Kit mit Configuration Manager, Gruppenrichtlinien oder einem anderen Tool | [Andere Windows-Tools](#andere-windows-tools) |
| Die DMG auf Macs | [Von der DMG zum PKG](#von-der-dmg-zum-pkg) |

[Prüfe danach ein Gerät](#ein-gerät-prüfen).

## Kits vor 1.0.15

Die Deployment-Kits bis 1.0.14 registrieren die Wasserzeichen-Kamera nicht und legen keine Update-Aufgabe an. Auf Geräten, die du mit einem davon verteilt hast, richtet sich die Kamera nie von selbst ein:

* Solange du die automatischen Updates nicht abgeschaltet hast, aktualisiert sich Langdock für jede Person selbst, ohne Administratorrechte. So lässt sich die Kamera nicht registrieren. Schreibt dein Workspace das Meeting-Wasserzeichen vor, bittet die neuere Version die User stattdessen, sich an ihre IT zu wenden.
* Das `Deploy.ps1` des alten Kits meldet Langdock weiter als installiert. Intune führt die Installation also nie wieder aus.

Aktualisiere diese Geräte einmal mit den Schritten für dein Tool unten. Bei der Win32-App in Intune ersetzt du Paket und Erkennungsskript in der App, die du schon hast. **Supersedence** brauchst du nicht. Auch nachdem sich Langdock selbst aktualisiert hat, ist auf dem Gerät noch die Version des alten Kits bereitgestellt. Das neue `Deploy.ps1` meldet Langdock deshalb als nicht installiert, und Intune führt `Deploy.cmd Install` aus. Ab dann hält die Update-Aufgabe des Kits Langdock und die Kamera aktuell.

Ob ein Gerät eines dieser Kits hat, siehst du mit `Get-ScheduledTask -TaskPath '\Langdock\'` in einer PowerShell mit Administratorrechten. Kits vor 1.0.15 legen dort keine Aufgabe an.

## Win32-App in Intune

Aktualisiere die Langdock-App, die du schon in Intune hast. Leg keine zweite an.

**1. Neues Kit herunterladen**

Lade das Deployment-Kit für [x64](https://desktop.langdock.com/global/stable/download/win-msix-kit-x64) oder [ARM64](https://desktop.langdock.com/global/stable/download/win-msix-kit-arm64) herunter und entpacke es. Du brauchst daraus `Application.intunewin` und `Deploy.ps1` als Erkennungsskript. Hast du eine App pro Architektur, wiederhole die Schritte mit jedem Kit.

**2. Paket ersetzen**

Gehe im Intune Admin Center zu **Apps** > **Windows** und öffne die Langdock-App. Klicke unter **Properties** neben **App information** auf **Edit**, dann auf **Select file to update**, und lade `Application.intunewin` aus dem neuen Kit hoch.

Prüfe **Program**: **Install command** ist `Deploy.cmd Install` oder `Deploy.cmd Install -RemovePersonalInstall`, **Uninstall command** ist `Deploy.cmd Uninstall` und **Install behavior** ist **System**. **App Version** kannst du auf die neue Version ändern, das Feld ist aber nur eine Beschriftung. Intune installiert deswegen nichts.

**3. Erkennungsregel umstellen**

Klicke neben **Detection rules** auf **Edit**. Lass **Use a custom detection script** ausgewählt und lade `Deploy.ps1` aus dem neuen Kit hoch. Setze **Run script as 32-bit process on 64-bit clients** und **Enforce script signature check** auf **No**.

Erst dieser Schritt bringt Intune dazu, erneut zu installieren. Das Skript meldet Langdock nur als installiert, wenn die Version des Kits oder eine neuere auf dem Gerät ist. Auf allen anderen Geräten führt Intune beim nächsten Check-in `Deploy.cmd Install` aus dem neuen Paket aus. Das aktualisiert Langdock, registriert die [Wasserzeichen-Kamera](https://docs.langdock.com/de/admin/desktop-app/deploy.md#wasserzeichen-kamera-für-meetings) und legt die Aufgabe an, die [Langdock aktuell hält](https://docs.langdock.com/de/admin/desktop-app/updates.md#updates-unter-windows-steuern). Schneller geht es auf einem Gerät mit **Synchronisieren** im Unternehmensportal unter **Einstellungen**. Unter Windows 10 überspringt ein Kit neuer als Desktop 1.0.15 die Kamera, und die Installation ist erfolgreich. Intune zeigt Kits bis 1.0.15 weiterhin als fehlgeschlagen an. Langdock selbst ist dann aktualisiert. Mehr dazu unter [Wasserzeichen-Kamera für Meetings](https://docs.langdock.com/de/admin/desktop-app/deploy.md#wasserzeichen-kamera-für-meetings).

**4. Zuweisung behalten**

Lass die App als **Required** denselben Gerätegruppen zugewiesen. Alle bekommen die neue Version bei ihrer nächsten Anmeldung oder über das eigene Update der App. Ab dann bieten spätere Versionen **Neu starten zum Aktualisieren** an.

Hast du die automatischen Updates abgeschaltet, damit Intune jeder Version folgen kann? Mit der `Deploy.ps1` aus dem Kit als Erkennungsskript kannst du sie [wieder einschalten](https://docs.langdock.com/de/admin/desktop-app/updates.md#updates-wieder-einschalten), und die Aufgabe des Kits hält Langdock aktuell.

> [!WARNING]
>
> Deinstalliere die alte App nicht, und leg die neue Version nicht als eigene App mit **Supersedence** an, bei der **Uninstall previous version** auf **Yes** steht. Der alte Deinstallationsbefehl entfernt Langdock für alle User des Geräts, und Windows löscht ihre App-Daten mit. Dann müssen sich alle neu anmelden.

## Line-of-Business-App in Intune

Die reine MSIX installiert Langdock ohne die Wasserzeichen-Kamera und ohne die Update-Aufgabe. Nur das Deployment-Kit registriert die Kamera. Wechsle deshalb einmal auf die Win32-App.

**1. Win32-App hinzufügen**

Richte die Win32-App wie in den [Intune-Schritten](https://docs.langdock.com/de/admin/desktop-app/deploy.md#intune) ein, mit `Deploy.ps1` aus dem Kit als Erkennungsskript. Das Kit muss neuer sein als die MSIX, die du verteilt hast. Bei derselben oder einer älteren Version zählt Intune die Geräte als installiert und führt das Kit nie aus. Dann bekommen sie weder die Kamera noch die Update-Aufgabe. Hast du das aktuelle Release schon als MSIX verteilt, warte auf das nächste. Weise die App als **Required** denselben Gerätegruppen zu wie die Line-of-Business-App.

**2. Warten, bis die Geräte Installed melden**

Öffne die Win32-App und prüfe **Device install status**. Beide Apps installieren dasselbe Langdock. Es bleibt also während des Wechsels auf den Geräten.

**3. Zuweisung der Line-of-Business-App entfernen**

Öffne die Line-of-Business-App, gehe zu **Properties** und entferne ihre Zuweisung. Weise sie nicht als **Uninstall** zu. Ihre Deinstallation entfernt Langdock für alle auf dem Gerät, auch die Kopie aus dem Kit.

Hast du die automatischen Updates nur wegen der Line-of-Business-App abgeschaltet? Dann kannst du sie [wieder einschalten](https://docs.langdock.com/de/admin/desktop-app/updates.md#updates-wieder-einschalten), und die Aufgabe des Kits hält Langdock aktuell.

## Andere Windows-Tools

Installiere das neue Kit über das alte, so wie du die erste Version verteilt hast:

* **Configuration Manager mit dem Kit**: Ersetze die Dateien in der Inhaltsquelle durch das neue entpackte Kit, nutze dessen `Deploy.ps1` als Erkennungsskript und aktualisiere den Inhalt auf deinen Verteilungspunkten.
* **Configuration Manager mit dem Windows-App-Paket**: Dieses Paket registriert die Kamera nicht. Leg eine Script-Installer-Anwendung mit dem Kit an wie in den [Schritten für Configuration Manager](https://docs.langdock.com/de/admin/desktop-app/deploy.md#sccm) und verteile sie an dieselben Sammlungen. Lösche danach die Bereitstellung des Windows-App-Pakets. Verteile es nicht mit der Aktion **Uninstall**.
* **Gruppenrichtlinien**: Ersetze die Kit-Dateien auf der Freigabe durch das neue entpackte Kit. Das Startskript führt beim nächsten Systemstart `Deploy.cmd Install` daraus aus.
* **Matrix42 Empirum, ACMP, baramundi oder eigene Skripte**: Führe `Deploy.cmd Install` aus dem neuen Kit als SYSTEM aus. Hast du die reine MSIX mit `Add-AppxProvisionedPackage` oder DISM verteilt, wechsle auf das Kit, weil nur das Kit die Kamera registriert.

Führe vorher nicht `Deploy.cmd Uninstall` aus. Das entfernt Langdock und seine App-Daten für alle User des Geräts.

## Von der DMG zum PKG

Auf Macs, die Langdock aus der DMG bekommen haben, bringt das PKG den Langdock-Updater mit. Er installiert neue Versionen ohne Admin-Rechte.

**1. Konfigurationsprofil verteilen**

Verteile das [Konfigurationsprofil](https://docs.langdock.com/de/admin/desktop-app/deploy.md#macos) vor dem PKG. Es legt die Update-Richtlinie fest und erlaubt den Updater als Anmeldeobjekt, damit macOS den Usern nicht die Meldung „Hintergrundobjekte hinzugefügt“ zeigt. Behalte die Profile für die Wasserzeichen-Kamera und die Datenschutzberechtigungen, die du schon verteilst.

**2. PKG verteilen**

Füge das PKG deinem MDM hinzu wie in den [Schritten für macOS](https://docs.langdock.com/de/admin/desktop-app/deploy.md#macos). Es ersetzt `/Applications/Langdock.app`, du entfernst die DMG-Kopie also nicht vorher. Alle bleiben angemeldet, weil ihre App-Daten in ihrem Benutzerordner bleiben.

**3. DMG nicht mehr verteilen**

Entferne die DMG-App oder -Richtlinie aus deinem MDM, ohne Langdock zu deinstallieren, und beende das geplante [DMG-Installationsskript](https://docs.langdock.com/de/admin/desktop-app/deploy.md#macos). Sonst ersetzen dein MDM und der Updater Langdock beide.

Kopien, die User in den Ordner `Applications` in ihrem Benutzerordner gezogen haben, bleiben neben der PKG-Installation. Entferne sie mit dem [Skript zum Entfernen](https://docs.langdock.com/de/admin/desktop-app/deploy.md#macos).

## Ein Gerät prüfen

Unter Windows führst du diese Befehle in einer PowerShell mit Administratorrechten aus:

```powershell theme={null}
# Version: zeigt die Version des Kits oder eine neuere
Get-AppxProvisionedPackage -Online | Where-Object DisplayName -eq 'com.langdock.desktop.msix' | Select-Object Version

# Update-Aufgabe: listet "Update com.langdock.desktop.msix_b9czaxkzpqt8m", die als SYSTEM läuft
Get-ScheduledTask -TaskPath '\Langdock\'

# Die Aufgabe führt Bootstrap.ps1 aus dem aktuellen Kit aus
(Get-ScheduledTask -TaskPath '\Langdock\').Actions.Arguments

# Zustand des Updaters: lastRunResult ist "installed" bis zum ersten Lauf der Aufgabe, danach "completed"
Get-Content "$env:ProgramFiles\LangdockUpdater\com.langdock.desktop.msix_b9czaxkzpqt8m\updater-health.json"

# Wasserzeichen-Kamera: gibt 0 aus, wenn die Kamera registriert ist
$pkg = Get-AppxProvisionedPackage -Online | Where-Object DisplayName -eq 'com.langdock.desktop.msix' | Sort-Object { [version]$_.Version } | Select-Object -Last 1
$root = [Environment]::ExpandEnvironmentVariables($pkg.InstallLocation) -replace '\\AppxManifest\.xml$', ''
(Start-Process (Join-Path $root 'App\resources\helpers\LangdockWatermark.exe') '--extension-status' -Wait -PassThru -WindowStyle Hidden).ExitCode
```

Jede andere Zahl als `0` heißt, dass die Kamera nicht registriert ist. Führe `Deploy.cmd Install` erneut aus oder warte auf die Update-Aufgabe, die sie beim Systemstart und einmal täglich registriert. Unter Windows 11 finden die User danach in ihrer Meeting-App die Kamera, deren Name auf „Langdock Watermark“ endet.

Direkt nach der Kit-Installation ist `previousVersion` in `updater-health.json` leer, weil es noch keine frühere [Update-Logik](https://docs.langdock.com/de/admin/desktop-app/updates.md#so-bleibt-der-updater-aktuell) gibt, zu der der Updater zurückgehen könnte.

Auf einem Mac bestätigst du die PKG-Installation mit `pkgutil --pkg-info com.langdock.desktop` und prüfst die Status- und die Zustandsdatei des Updaters:

```bash theme={null}
cat "/Library/Application Support/Langdock/Updater/com.langdock.desktop/status.json"
cat "/Library/Application Support/Langdock/Updater/com.langdock.desktop/updater-health.json"
```

`state` ist `idle`, wenn Langdock aktuell ist. In der Zustandsdatei ist `lastRunResult` `completed` oder `waiting`, solange ein Update darauf wartet, dass Langdock beendet wird. Für andere Werte siehe [Langdock aktualisiert sich auf einem Mac nicht](https://docs.langdock.com/de/admin/desktop-app/deploy.md#fehlerbehebung).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.