使用 Azure 脚本进行更新

警告： 请记住，这些信息与您要升级到的目标版本有关，与升级前的版本无关。因此，在继续之前，请确保阅读正确的详细信息。

重要提示：

• 如果您使用 Active Directory (AD) 并计划升级到 2023.4.0，我们强烈建议您直接跳到 2023.4.3 版本，因为 2023.4.0、2023.4.1 和 2023.4.2 会受到 AD 问题的影响。

• 如果您以前没有这样做过（例如，从 v2019.10 升级），请确保已为以下项目创建了应用程序服务：
  • 身份服务器
  • Webhook 服务
  • 资源目录服务
• 在运行 Publish-Orchestrator.ps1 脚本之前，请确保卸载 AzureRM PowerShell 模块。我们建议使用 Az 模块作为替代方案。不支持同时安装 AzureRM 和 Az 模块。
• 如果未检测到所需的 Az 版本，并且在运行脚本时存在 AzureRM，则即使在无人值守的安装上，系统也会提示您确认是否删除 AzureRM。
• 如果在使用任何先前版本的模块时升级到 Az v6.0.0，则系统会弹出以下消息：WARNING: The version 'x.x.x' of module 'Az.<Name>' is currently in use. Retry the operation after closing the applications.。为了解决此问题，请确保在新的 PowerShell 会话中执行 Publish-Orchestrator.ps1。

1. Download the latest available UiPathOrchestrator.zip archive.
2. Unblock the UiPathOrchestrator.zip file using the PowerShell command Unblock-File. For example, Unblock-File .\UiPathOrchestrator.zip.
3. Unarchive UiPathOrchestrator.zip.
4. 在要更新的 Orchestrator 实例上的 PowerShell 中运行 Publish-Orchestrator.ps1 脚本。考虑到，如果 UiPath.Orchestrator.dll.config（先前为 web.config）设置未显式指定为脚本参数，则会将其保留。
5. 如下所示，在 PowerShell 中的 Identity Server 实例上运行 Publish-IdentityServer.ps1。
6. 如下所示，在 PowerShell 中的 Webhooks 服务实例上运行 Publish-Webhooks.ps1。
7. 如下所示，在 PowerShell 中的源目录服务实例上运行 Publish-ResourceCatalog.ps1。
8. 使用此处描述的参数，在 PowerShell 中运行 MigrateTo-ResourceCatalog.ps1 脚本。
9. 如果要更新多节点 Orchestrator 实例，请使用 FLUSHALL 或 FLUSHDB 命令刷新所有 Redis 缓存密钥。 有关它们的更多信息，请参见 此处 和 此处。

10. 在 Azure 门户中打开网页应用程序，然后导航到配置 > 常规设置并检查以下设置：

    • Stack 应该设置为 .NET Core。
    • Platform 应该设置为 64 Bit。
    • 如果您不使用 Azure SignalR 服务，则应将Web sockets 设置为 On

11. Start the Orchestrator app service. Enjoy using Orchestrator on your Azure Portal.

12. 在已连接到 Orchestrator 的所有机器人计算机上重新启动 UiPath 机器人服务。

Publish-Orchestrator.ps1 更新

将最新的 Publish-Orchestrator.ps1 脚本下载到本地计算机后，请按下方所示运行脚本以更新 Orchestrator：

.\Publish-Orchestrator.ps1 -action Update -package .\UiPath.Orchestrator.Web.zip -stopApplicationBeforePublish -azureSubscriptionId "<azure_subscription_id>" -azureAccountTenantId "<azure_account_tenant_id>" -azureAccountApplicationId "<azure_application_id>" -azureAccountPassword "<azure_account_password>" -resourceGroupName "<resourcegroup_name>" -appServiceName "<app_service_name>" -confirmBlockClassicExecutions -Verbose

要包括“测试自动化”、“Insights”和“更新服务器”模块，请按如下方式运行脚本：

.\Publish-Orchestrator.ps1 -action Update -package .\UiPath.Orchestrator.Web.zip -stopApplicationBeforePublish -azureSubscriptionId "<azure_subscription_id>" -azureAccountTenantId "<azure_account_tenant_id>" -azureAccountApplicationId "<azure_application_id>" -azureAccountPassword "<azure_account_password>" -resourceGroupName "<resourcegroup_name>" -appServiceName "<app_service_name>" -confirmBlockClassicExecutions -testAutomationFeatureEnabled -insightsFeatureEnabled -updateServerFeatureEnabled -Verbose

Publish-IdentityServer.ps1 更新

重要提示：如果之前未执行过此类操作（例如从 v2019.10 升级），请确保已为 Identity Server 创建应用程序服务。请确保 Publish-IdentityServer.ps1 脚本针对 Identity Server 应用程序服务。

将最新的 Publish-IdentityServer.ps1 脚本下载到本地计算机后，请按下方所示运行脚本以更新身份服务器 Azure 网页应用程序：

.\Publish-IdentityServer.ps1 ` -action Update ` -azureSubscriptionId "<azure_subscription_id>" ` -azureAccountTenantId "<azure_tenant_id>" ` -azureAccountApplicationId "<azure_application_id>" ` -azureAccountPassword "<azure_account_password>" ` -orchestratorURL "https://<orchestratorURL>" ` -identityServerUrl "https://<IdentityServerURL>/identity" ` -orchDetails @{ resourceGroupName = "<resourcegroup_name>"; appServiceName = "<appservice_name>"; targetSlot = "Production" } ` -identityServerDetails @{ resourceGroupName = "<resourcegroup_name>"; appServiceName = "<appservice_name>"; targetSlot = "Production" } ` -package "UiPath.IdentityServer.Web.zip" ` -cliPackage "UiPath.IdentityServer.Migrator.Cli.zip" ` -resourceCatalogUrl "<resource_catalog_url>" ` -stopApplicationBeforePublish ` -unattended

Publish-Webhooks.ps1 更新

重要提示： 如果您以前没有这样做过（例如 从 v2019.10升级），请确保已为 Webhooks 服务创建应用程序服务。 确保 Publish-Webhooks.ps1 脚本以 Webhooks 应用程序服务为目标。

将最新的 UiPath.WebhookService.Web.zip 存档下载并提取至本地计算机后，请按下方所示运行 Publish-Webhooks.ps1 脚本以更新身份服务器 Azure 网页应用程序：

.\Publish-Webhooks.ps1 ` -action Update ` -package "UiPath.WebhookService.Web.zip" ` -azureAccountApplicationId "<azure_application_id>" ` -azureAccountPassword "<azure_account_password>" ` -azureSubscriptionId "<subscription_id>" ` -azureAccountTenantId "<azure_tenant_id>" ` -resourceGroupName "<resourcegroup_name>" ` -appServiceName "<appservice_name>" ` -stopApplicationBeforePublish

Publish-ResourceCatalog.ps1 更新

将最新的 Publish-ResourceCatalog.ps1 脚本下载到本地计算机后，请按下方所示运行脚本以更新资源目录服务：

.\Publish-ResourceCatalog.ps1 -action update -package "UiPath.ResourceCatalogService-Win64.zip" -azureSubscriptionId "<azure_subscription_id>" -azureAccountTenantId "<azure_account_tenant_id>" -azureAccountApplicationId "<azure_application_id>" -azureAccountPassword "<azure_account_password>" -resourceGroupName "<resourcegroup_name>" -appServiceName "<appservice_name>"

重要提示：升级资源目录服务时，必须运行 MigrateTo-ResourceCatalog.ps1 脚本。