Deinstallieren von Bereitstellungen

Wenn eine Lösungsbereitstellung nicht mehr benötigt wird, können Sie sie aus der Zielumgebung deinstallieren. Dadurch wird die Bereitstellungskonfiguration entfernt und alle zugehörigen Prozesse deaktiviert.

Tipp:

Für Orchestrator-Instanzen, die von einer privaten Zertifizierungsstelle signiert wurden (z. B. UiPath Automation Suite), akzeptiert dieser Befehl auch --ca-cert und --pinnedpubkey Parameter. Szenarien und Beispiele finden Sie unter Vertrauenswürdigen benutzerdefinierten Zertifikaten .

Was wird deinstalliert?

Deinstallieren einer Bereitstellung:

• Entfernt die Bereitstellung aus dem Zielordner im Orchestrator.
• Deaktiviert alle in der Lösung enthaltenen Prozesse.
• Stoppt alle laufenden Trigger oder Zeitpläne.
• Bereinigt bereitstellungsspezifische Konfigurationen.
• Löscht das Paket nicht aus Lösungen (verwenden Sie dafür Delete-package).

Befehlssyntax

uipcli solution deploy-uninstall <deployment-name> [options]

Parameter:

Parameter	Beschreibung	Erforderlich
<deployment-name>	Name der zu deinstallierenden Bereitstellung	Ja
-U	Orchestrator-URL	Ja
-T	Name des Mandanten	Ja
-A	Name der Organisation	Ja
-I	Externe App-ID	Ja
-S	Externer App-Schlüssel	Ja
--applicationScope	Erforderliche Scopes	Ja
--traceLevel	Protokollierungsstufe	Nein
--ca-cert	Datei(en) der vertrauenswürdigen Stammzertifizierungsstelle (PEM, DER oder PKCS#7) für das TLS-Zertifikat von Orchestrator/Identity. Wiederholen oder durch Komma trennen. Siehe Vertrauenswürdigen benutzerdefinierten Zertifikaten.	Nein
--pinnedpubkey	Heften Sie den öffentlichen Blattschlüssel an (sha256//<base64>). Siehe Vertrauenswürdigen benutzerdefinierten Zertifikaten.	Nein

Authentication

Siehe Authentifizierung und Scopes für erforderliche Scopes und Einrichtung einer externen App.

Beispiel

uipcli solution deploy-uninstall MySolution-Prod-v1.2.3 \
  -U https://cloud.uipath.com/ \
  -T DefaultTenant \
  -A myorg \
  -I 12345678-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
  -S **** \
  --applicationScope "AutomationSolutions Solutions.Deployments Solutions.Deployments.Read Solutions.Deployments.Write Solutions.Packages Solutions.Packages.Read Solutions.Packages.Write" \
  --traceLevel Information

Was passiert während der Deinstallation

Wenn Sie eine Bereitstellung deinstallieren:

1. Deaktivierung – Die Bereitstellung wird als inaktiv markiert.
2. Prozessbereinigung – Alle Prozesse in der Lösung werden aus dem Ordner entfernt.
3. Triggerbereinigung – Geplante Trigger werden angehalten und entfernt.
4. Konfigurationsbereinigung – Bereitstellungsspezifische Bindungen und Konfigurationen werden gelöscht.
5. Paketaufbewahrung – Das Paket verbleibt in Lösungen und kann erneut bereitgestellt werden.

Deinstallieren vs. Löschen

Es ist wichtig, den Unterschied zu verstehen:

Betrieb	Was es tut	Einsatzbereich
Deinstallieren	Entfernt Bereitstellung aus Ordner	Wenn Sie eine Bereitstellung deaktivieren, das Paket aber für die zukünftige Verwendung behalten möchten
Paket löschen	Entfernt Paket aus der Lösungsverwaltung	Wenn Sie eine Paketversion endgültig entfernen möchten

Typischer Bereinigungsworkflow:

# 1. First, uninstall all deployments using the package
uipcli solution deploy-uninstall MySolution-Dev-1.2.3 ...
uipcli solution deploy-uninstall MySolution-Test-1.2.3 ...

# 2. Then delete the package if no longer needed
uipcli solution delete-package MySolution -v 1.2.3 ...

Best Practices

1. Nur erforderliche Bereitstellungen beibehalten

Sammeln Sie keine alten Bereitstellungen. Deinstallieren Sie sie als Teil Ihrer Bereitstellungspipeline:

# After successful deployment, always clean up
uipcli solution deploy-uninstall <old-deployment-name> ...

2. Verwenden Sie die Benennung der Bereitstellung für die Bereinigung

Version in Bereitstellungsnamen einbeziehen, um die Bereinigung zu erleichtern:

# Good naming convention
MySolution-Prod-v1.2.3

# Easy to identify and uninstall old versions
for old_version in 1.2.1 1.2.2; do
  uipcli solution deploy-uninstall MySolution-Prod-v$old_version ...
done

Nächste Schritte

Nach dem Deinstallieren von Bereitstellungen:

1. Löschen Sie Pakete , wenn sie nicht mehr benötigt werden.
2. Überprüfen Sie andere Bereitstellungen im Ordner auf Bereinigungsmöglichkeiten.
3. Dokumentieren Sie den Bereitstellungsverlauf zu Prüfungszwecken.