卸载部署

当不再需要解决方案部署时，您可以将其从目标环境中卸载。这将删除部署配置并停用所有相关流程。

提示：

对于私有证书颁发机构签名的 Orchestrator 实例（例如 UiPath Automation Suite），此命令也接受--ca-cert和--pinnedpubkey参数。有关场景和示例，请参阅信任自定义证书。

什么是卸载?

卸载部署：

• 从 Orchestrator 中的目标文件夹中删除部署。
• 停用解决方案中包含的所有流程。
• 停止任何正在运行的触发器或计划。
• 清理特定于部署的配置。
• 不从解决方案中删除包（为此使用 Delete-package）。

命令语法

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

参数：

参数	描述	必填
<deployment-name>	要卸载的部署的名称	是
-U	Orchestrator URL	是
-T	租户名称	是
-A	组织名称	是
-I	外部应用程序 ID	是
-S	外部应用程序密码	是
--applicationScope	所需作用域	是
--traceLevel	日志记录级别	否
--ca-cert	Orchestrator/身份 TLS 证书的受信任根 CA 文件（PEM、DER 或 PKCS#7）。重复或用逗号分隔。请参阅信任自定义证书。	否
--pinnedpubkey	固定叶公钥 ( sha256//<base64> )。请参阅信任自定义证书。	否

身份验证

有关所需作用域和外部应用程序设置，请参阅身份验证和作用域。

示例

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

卸载期间会发生的情况

卸载部署时：

1. 停用- 部署被标记为非活动。
2. 流程清理- 将从文件夹中删除解决方案中的所有流程。
3. 触发器清理- 计划的触发器将停止并删除。
4. 配置清理- 删除特定于部署的绑定和配置。
5. 包保留- 包保留在解决方案中，并且可以重新部署。

卸载与删除

了解其中的区别非常重要：

操作	操作	何时使用
卸载	从文件夹中删除部署	当您要停用部署但保留包以备将来使用时
删除包	从解决方案管理中删除包	当要永久删除包版本时

典型的清理工作流：

# 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 ...

最佳实践

1. 仅保留必要的部署

不要累积旧的部署。在部署管道中将其卸载：

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

2. 使用部署命名进行清理

在部署名称中包含版本以使清理更容易：

# 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

后续步骤

卸载部署后：

1. 如果不再需要包，请将其删除。
2. 查看文件夹中的其他部署以获取清理机会。
3. 记录部署历史记录，以便进行审核。