Orchestrator 脚本

发布到 Orchestrator

下表介绍了可与 Publish-Orchestrator.ps1一起使用的所有参数。

参数	描述
-action	Mandatory. Indicates the type of scenario you want to start. The following options are available: Deploy - 指定它为全新安装； Update - 指定要更新 Orchestrator 实例。
-azureAccountApplicationId	Mandatory. The Azure service principal ID. Please note that the used service principal needs to be assigned the Contributor role to the app service at the subscription scope.
-azureAccountPassword	Mandatory. The Azure token password for the service principal ID.
-azureSubscriptionId	Mandatory. The Azure subscription ID for the App Service that hosts Orchestrator.
-azureAccountTenantId	Mandatory. The Azure tenant ID.
-resourceGroupName	Mandatory. The name of the Azure Resource Group that contains the Orchestrator App Service.
-appServiceName	Mandatory. The Orchestrator Azure App Service name.
-package	Mandatory. Indicate the full path of the UiPath.Orchestrator.Web.zip archive.
-activitiesPackagePath	Optional. Specify the full path of the UiPathActivities.zip archive, which is included by default, starting with v2018.4.4, in UiPathOrchestrator.zip. This enables you to install the local activity feed in Azure at install-time. Please note that this parameter can be used only with the Legacy repository type. Otherwise, it has to be manually set up.
-testAutomationFeatureEnabled	可选。此参数启用测试自动化模块，用于测试数据队列、测试执行和计划。您可以基于以下情况之一启用此功能： 通过 Orchestrator 清洁安装重新启动 Configure the following settings for your App Service before running the Publish-Orchestrator.ps1 script using the -testAutomationFeatureEnabled parameter: AppSettings：密钥=TestAutomation.ModuleEnabled - 设置为 True 以启用测试自动化模块。 AppSettings: Key=TestAutomation.FeatureEnabledByDefault - 设置为 True 将默认启用测试自动化模块。默认情况下，除非显式启用，否则禁用此功能。 ConnectionString：名称=TestAutomation - 设置测试自动化数据库连接字符串。可以使用与 Orchestrator 相同的连接字符串，也可以使用不同的连接字符串。例如： Server=13.13.13.13;Initial Catalog=UiPath;Persist Security Info=False;User ID=dbUser;Password=pass123; MultipleActiveResultSets=False;Encrypt=True; Connection Timeout=30;TrustServerCertificate=True 确保将这些设置标记为 Deployment slot setting，尤其是在使用热插拔插槽的情况下。 启用 Orchestrator 安装后测试自动化 如果您已经部署了 Orchestrator 而未启用测试自动化模块， 请使用与升级时相同的参数运行 Publish-Orchestrator.ps1 脚本，并添加 -testAutomationFeatureEnabled 参数。 升级 Orchestrator 如果升级 Orchestrator 实例，请在运行 Publish-Orchestrator.ps1 脚本之前将 -testAutomationFeatureEnabled 参数添加到该脚本中。 For more details about upgrading Orchestrator, see Publish-Orchestrator.ps1 Update.
-updateServerFeatureEnabled	可选。此参数启用“更新服务器”模块。您可以在以下任一情况下启用此功能： 使用全新的 Orchestrator 安装重新启动 Configure the following settings for your App Service before running the Publish-Orchestrator.ps1 script using the -updateServerFeatureEnabled parameter: AppSettings：密钥=UpdateServer.ModuleEnabled - 设置为 True 以启用更新服务器模块。 AppSettings：密钥=UpdateServer.FeatureEnabledByDefault - 设置为 True 以默认启用更新服务器模块。默认情况下，除非显式启用，否则禁用此功能。 ConnectionString：名称=UpdateServer - 设置更新服务器数据库连接字符串。可以使用与 Orchestrator 相同的连接字符串，也可以使用不同的连接字符串。例如： Server=13.13.13.13;Initial Catalog=UiPath;Persist Security Info=False;User ID=dbUser;Password=pass123; MultipleActiveResultSets=False;Encrypt=True; Connection Timeout=30;TrustServerCertificate=True 在 Orchestrator 安装后启用更新服务器 如果您已经部署了 Orchestrator 而未启用“更新服务器”模块， 请使用与升级时相同的参数运行 Publish-Orchestrator.ps1 脚本，并添加 -updateServerFeatureEnabled 参数。 升级 Orchestrator 如果升级 Orchestrator 实例，请在运行 Publish-Orchestrator.ps1 脚本之前将 -updateServerFeatureEnabled 参数添加到该脚本中。 For more details about upgrading Orchestrator, see Publish-Orchestrator.ps1 Update.
-robotsElasticSearchUrl	Optional. This should be used only if you want to use Elasticsearch for logging. Provide the Elasticsearch URL as the value, such as "http://elasticserver:9200". If your Orchestrator instance requires authentication, provide the ElasticSearchUsername, ElasticSearchPassword, elasticSearchDiagnosticsUsername, and elasticSearchDiagnosticsPassword parameters.
-robotsElasticSearchTargets	Optional. This parameter enables you to send Robot logs only to the configured Elasticsearch server. Provide the Elasticsearch URL as the value, such as "http://elasticserver:9200". Please note that it can only be used in conjunction with the -robotsElasticSearchUrl parameter. If you do not provide this parameter, Robot logs are sent to both the configured SQL database and Elasticsearch.
-robotsElasticSearchUsername	Optional. This parameter enables you to indicate the username for your Elasticsearch instance if its authentication is enabled.
-robotsElasticSearchPassword	Optional. This parameter enables you to indicate the password for your Elasticsearch instance if its authentication is enabled.
-serverElasticSearchDiagnosticsUsername	Optional. This parameter enables you to indicate the username for your Elasticsearch instance if its authentication is enabled. This parameter together with elasticSearchDiagnosticsPassword "Password" are required for internal Orchestrator logs.
-serverElasticSearchDiagnosticsPassword	Optional. This parameter enables you to indicate the password for your Elasticsearch instance if its authentication is enabled. This parameter together with elasticSearchDiagnosticsUsername "Username" are required for internal Orchestrator logs.
-loadBalancerUseRedis	Optional. Use Redis as a database to distribute messages and cache to and from all the machines connected through your load balancer. If -redisConnectionString is specified, it is automatically set to true, otherwise it is set to false.
-redisConnectionString	Optional. It can only be used if loadBalancerUseRedis is set to true. A connection string that enables you to set up your Redis server, which contains the URL of the server, the password, and port used with Redis. It is also possible to enable SSL encrypted connections between the Orchestrator nodes and the Redis service. For more information, please click here. 示例: 启用 SSL - -redisConnectionString "docs123.redis.cache.windows.net:6380,password=******,ssl=True" 未启用 SSL - -redisConnectionString "docs123.redis.cache.windows.net:6380,password=******,ssl=False"
-azureSignalRConnectionString	Optional. Helps you enable Azure SignalR Service, facilitating a direct communication between your Robot fleet and the SignalR Service - Orchestrator no longer intermediates it. Please note that, if enabled, Robots with a version lower than 2019.2 rely only on the Heartbeat protocol to communicate to Orchestrator, meaning that any command given from Orchestrator is picked up by a Robot only every 30 seconds. Example: -azureSignalRConnectionString "Endpoint=https://doctest.signalr.net;AccessKey=M1ug+sBu07hyyi12AgyJ52SEd4OgC2Mm6BvllVHCC9c=;Version=1.0;"
-storageType	Optional. Defines the target where execution media and packages are to be saved. It can be populated with the following targets: FileSystem - 如 storageType "FileSystem"。这是更新方案和全新安装中的默认值，即使未指定参数也是如此。 Azure - 如 storageType "Azure"。 Amazon - 如 storageType "Amazon"。 Minio - 如 storageType "Minio"。 如果已覆盖 Azure 应用程序服务“配置”部分的 UiPath.Orchestrator.dll.config Storage.Type 参数，则在升级时，需要将此值作为脚本参数传递给 Publish-Orchestrator.ps1。
-storageLocation	Optional. Defines the actual location where execution media and packages are to be saved. Particularities: 文件系统 - 使用 RootPath=.\Storage 格式提供绝对路径，例如 storageLocation "RootPath=C:\FolderName\AnotherFolderName"。这是更新方案和全新安装中的默认值，即使未指定参数也是如此。 Azure - 提供连接字符串，例如 storageLocation "DefaultEndpointsProtocol=https;AccountName=usr;AccountKey=...;EndpointSuffix=core.windows.net"。 Amazon - 提供连接字符串，例如 storageLocation" "EndpointRegion=eu-west-3;accessKey=AKIAZGUEIGXUJ3BBI4MW;secretKey=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;useHttp=false"。 Minio - 提供连接字符串，例如 storageLocation" "host=localhost:9001;accessKey=YVKYFJ0ZY246KDKP0634;secretKey=bdBEk2ubhIFsTNPuQ80PjKL+oqZBj67HoSWBFnw1"。 More information on these deployments types is available here. 如果已覆盖 Azure 应用程序服务“配置”部分的 UiPath.Orchestrator.dll.config Storage.Location 参数，则在升级时，需要将此值作为脚本参数传递给 Publish-Orchestrator.ps1。
-standbyslotname	可选。它只能在升级方案中使用。如果指定，脚本将在指定的应用程序服务槽（而不是生产槽）中部署 Orchestrator。此外，交换槽与生产槽一起执行，没有停机时间。 先决条件： 备用应用程序服务插槽必须指向其他 SQL 数据库。 the standby slot Connection String must be made slot sticky (by selecting the Slot Setting box in Azure Portal). 必须将生产插槽 UiPath.Orchestrator.dll.config 文件从生产插槽复制到备用插槽。
-productionSlotName	Optional. It can be used only if the Orchestrator App Service deployment slot is different from the default Production App Service Slot set by Azure.
-appSettings	Optional. Key-value pairs of application settings that are pushed to the Azure App Service Configuration section after deployment. Keep in mind that this only applies to settings from the App Settings section of the UiPath.Orchestrator.dll.config file. You can use this parameter to change specific settings that are not exposed through the Publish-Orchestrator.ps1 script. For the rest, please use their dedicated parameter while deploying the script. 请注意，现有设置将与新设置合并。
-stopApplicationBeforePublish	可选。如果存在，它会在部署之前停止应用程序，并在部署完成后启动应用程序。
-unattended	可选。 如果存在，则部署将继续，无需任何用户确认。
-bucketsAvailableProviders	可选。一个字符串，其中包含您要启用的存储桶提供程序的列表（以逗号分隔）。如果未指定，则默认为 Orchestrator,Amazon,Azure,Minio。您还可以选择通过将文件系统提供程序添加到该列表中来启用它。 注意：如果使用文件系统提供程序并升级到 20.10.7 或更高版本，则必须为此参数传递包含 FileSystem 的值。否则，该提供程序将被禁用，并且您将不再能够使用这些存储桶。
-bucketsFileSystemAllowlist	只有当文件系统被选为存储桶提供程序时必需。您要允许在其中为文件系统提供程序创建存储桶的位置列表。如果启用文件系统提供程序，则还必须为此参数传递一个值。值是一系列 UNC 路径，由管道符号 | 分隔（例如 \\mysharedstorage\mybyckets\|\\myotherserver\myotherbuckets）。
-azureUSGovernmentLogin	可选。此参数仅用于美国政府部署。

更新时保留的参数

执行更新时，系统会自动迁移并保留以下 UiPath.Orchestrator.dll.config 参数值。 要更改它们，请在调用 Publish-Orchestrator.ps1 脚本时提供新值。

-NuGet.Packages.ApiKey
-NuGet.Activities.ApiKey
-NuGet.Packages.Path
-NuGet.Activities.Path
-machineKey/@decryption
-machineKey/@decryptionKey
-machineKey/@validationKey
-EncryptionKey
-NuGet.Repository.Type
-Storage.Type
-Storage.Location
-LoadBalancer.Redis.ConnectionString
-LoadBalancer.UseRedis
-Scalability.AzureSignalR.ConnectionString
-nlog/targets/target/@name=robotElasticBuffer/@name=RobotElastic/@uri
-nlog/targets/target/@name=robotElasticBuffer/@name=RobotElastic/@username
-nlog/targets/target/@name=robotElasticBuffer/@name=RobotElastic/@password
-nlog/rules/logger/@name=Robot.*/@writeTo
-nlog/targets/target/@name=serverElasticBuffer/@name=serverElastic/@uri
-nlog/targets/target/@name=serverElasticBuffer/@name=serverElastic/@username
-nlog/targets/target/@name=serverElasticBuffer/@name=serverElastic/@password
-nlog/targets/target/@name=serverElasticBuffer/@name=serverElastic/@index
-nlog/rules/logger/@name=*/@writeTo

示例

单节点安装

以下示例使您能够在一个节点上执行 Orchestrator 的全新安装，使用 Elasticsearch 进行日志记录，并将包保存在 Azure Blob 存储中，并将其元数据保存在 SQL 数据库中。 该过程以 -unattended 方式进行，并在 -verbose 级别记录其步骤。

.\Publish-Orchestrator.ps1 `
-action "Deploy" `
-unattended `
-package "E:\Work\Orch\Setup\UiPath.Orchestrator.Web.zip" `
-stopApplicationBeforePublish `
-azureSubscriptionId "8e34be72-1937-4aa0-b70e-81bab19gbf0a" `
-azureAccountTenantId "f8350d2a-n153-4d17-8927-902c51f72797" `
-azureAccountApplicationId "$AzureApplicationId" `
-azureAccountPassword "$AzurePassword" `
-resourceGroupName "DocTest-Orch-RG" `
-appServiceName "DocTests123" `
-storageType "Azure" `
-storageLocation "DefaultEndpointsProtocol=https;AccountName=usr;AccountKey=...;EndpointSuffix=core.windows.net" `
-robotsElasticSearchUrl "http://docelasticserver:9200" `
-verbose

多节点安装

以下示例使您能够在多个节点上执行 Orchestrator 的全新安装，并使用 Elasticsearch 进行日志记录，使用 Redis 进行缓存和消息分发。 包保存在 Azure Blob 存储中，其元数据保存在 SQL 数据库中。 该过程以 -unattended 方式进行，并在 -verbose 级别记录其步骤。

.\Publish-Orchestrator.ps1 `
-action "Deploy" `
-unattended `
-package "E:\Work\Orch\Setup\UiPath.Orchestrator.Web.zip" `
-stopApplicationBeforePublish `
-azureSubscriptionId "8e34be72-1937-4aa0-b70e-81bab19gbf0a" `
-azureAccountTenantId "f8350d2a-n153-4d17-8927-902c51f72797" `
-azureAccountApplicationId "$AzureApplicationId" `
-azureAccountPassword "$AzurePassword" `
-resourceGroupName "DocTest-Orch-RG" `
-appServiceName "DocTests123" `
-redisConnectionString "docs123.redis.cache.windows.net:6380,passwprd=******,ssl=True" `
-azureSignalRConnectionString "Endpoint=https://doctest.signalr.net;AccessKey=*****;Version=1.0;" `
-robotsElasticSearchUrl "http://docelasticserver:9200" `
-storageType "Azure" `
-storageLocation "DefaultEndpointsProtocol=https;AccountName=usr;AccountKey=...;EndpointSuffix=core.windows.net" `
-verbose

多节点更新

以下示例使您能够将现有的多节点 Orchestrator 升级到最新的可用版本，而无需更改任何预先存在的设置。 该过程以 -unattended 方式进行，并在 -verbose 级别记录其步骤。

Publish-Orchestrator.ps1 `
-action Update `
-unattended `
-package "E:\Work\Orch\Setup\UiPath.Orchestrator.Web.zip" `
-stopApplicationBeforePublish `
-azureSubscriptionId "8e34be72-1937-4aa0-b70e-81bab19gbf0a" `
-azureAccountTenantId "f8350d2a-n153-4d17-8927-902c51f72797" `
-azureAccountApplicationId "$AzureApplicationId" `
-azureAccountPassword "$AzurePassword" `
-resourceGroupName "DocTest-Orch-RG" `
-appServiceName "DocTests123" `
-verbose

以下示例使您能够将现有的多节点 Orchestrator 升级到最新的可用版本，同时仅将 Webhooks.Enabled 和 Telemetry.Enabled 参数的值更改为 false。 该过程以 -unattended 方式进行，并在 -verbose 级别记录其步骤。

Publish-Orchestrator.ps1 `
-action Update `
-unattended `
-package "E:\Work\Orch\Setup\UiPath.Orchestrator.Web.zip" `
-stopApplicationBeforePublish `
-azureSubscriptionId "8e34be72-1937-4aa0-b70e-81bab19gbf0a" `
-azureAccountTenantId "f8350d2a-n153-4d17-8927-902c51f72797" `
-azureAccountApplicationId "$AzureApplicationId" `
-azureAccountPassword "$AzurePassword" `
-resourceGroupName "DocTest-Orch-RG" `
-appServiceName "DocTests123" `
-appSettings @{"Webhooks.Enabled"="false"; "Telemetry.Enabled"="false"} `
-verbose