Scripts de Orchestrator

Publicar en Orchestrator

La siguiente tabla describe todos los parámetros que se pueden utilizar con Publish-Orchestrator.ps1.

Parámetro	Descripción
-action	Obligatorio. Indica el tipo de escenario que quieres iniciar. Las siguientes opciones están disponibles: Deploy - especifica que se trata de una instalación limpia; Update - especifica que actualizas tu instancia de 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	Obligatorio. La contraseña de token de Azure para el ID principal de servicio.
-azureSubscriptionId	Obligatorio. El ID de suscripción de Azure para el App Service que aloja Orchestrator.
-azureAccountTenantId	Obligatorio. El ID de tenant de Azure.
-resourceGroupName	Obligatorio. El nombre del grupo de recursos de Azure que contiene Orchestrator App Service.
-appServiceName	Obligatorio. El nombre de Orchestrator Azure App Service.
-hostAdminPassword	Obligatorio solo para implementaciones nuevas, cuando -action está establecido en Deploy. Especifica una contraseña personalizada para el administrador del host. Ten en cuenta que las contraseñas deben tener al menos 8 caracteres y deben tener al menos un carácter en minúscula y un dígito.
-isHostPassOneTime	Opcional. Te permite aplicar un restablecimiento de la contraseña en el primer inicio de sesión para el administrador del host. Si se omite este parámetro, la contraseña de administrador del host no será una contraseña de un solo uso.
-defaultTenantAdminPassword	Obligatorio solo para implementaciones nuevas, cuando -action está establecido en Deploy. Especifica una contraseña personalizada para el administrador de tenants predeterminado. Ten en cuenta que las contraseñas deben tener al menos 8 caracteres y deben tener al menos un carácter en minúscula y un dígito.
-isDefaultTenantPassOneTime	Opcional. Te permite aplicar un restablecimiento de la contraseña en el primer inicio de sesión para el administrador del tenant predeterminado. Si se omite este parámetro, la contraseña de administrador del tenant no será una contraseña de un solo uso.
-package	Obligatorio. Indica la ruta completa del archivo UiPath.Orchestrator.Web.zip.
-activitiesPackagePath	Opcional. Especifica la ruta completa del archivo UiPathActivities.zip, incluido de forma predeterminada, a partir de la versión v2018.4.4, en UiPathOrchestrator.zip. Esto te permite instalar la fuente de actividad local en Azure en el momento de la instalación. Ten en cuenta que este parámetro solo puede utilizarse con el tipo de repositorio Legacy. De lo contrario, tendrá que configurarse manualmente.
-testAutomationFeatureEnabled	Opcional. Este parámetro habilita el módulo Probar automatización para las colas de datos de prueba, la ejecución de pruebas y la programación. Puedes habilitar esta característica en función de uno de los siguientes escenarios: Comenzar de cero con una instalación de Orchestrator limpia Configure the following settings for your App Service before running the Publish-Orchestrator.ps1 script using the -testAutomationFeatureEnabled parameter: AppSettings: TestAutomation.ModuleEnabledKey=: establecer en pTrueara habilitar el módulo Probar automatización. AppSettings: Key=TestAutomation.FeatureEnabledByDefault: establecer en True para habilitar el módulo Probar automatización de forma predeterminada.De forma predeterminada, esta característica está deshabilitada a menos que se habilite de forma explícita. ConnectionString: Name=TestAutomation: establece la cadena de conexión de la base de datos de Probar automatización. Puedes utilizar una cadena de conexión similar a la utilizada para Orchestrator o una completamente diferente.Por ejemplo: 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 Asegúrate de marcar esta configuración como Deployment slot setting, especialmente, si utilizas ranuras del tipo intercambio en caliente (hotswap). Habilitar Probar automatización después de la instalación de Orchestrator Si ya has implementado Orchestrator sin habilitar el módulo Probar automatización, ejecuta el script Publish-Orchestrator.ps1 con los mismos parámetros que para una actualización y añade el parámetro -testAutomationFeatureEnabled . Actualizar Orchestrator Si actualizas tu instancia de Orchestrator, ejecuta el script Publish-Orchestrator.ps1 con los mismos parámetros que para una actualización, y añade el parámetro -testAutomationFeatureEnabled.
-robotsElasticSearchUrl	Opcional. Esto solo se debe utilizar si quieres utilizar Elasticsearch para los registros. Facilita la URL de Elasticsearch como el valor, por ejemplo "http://elasticserver:9200". Si tu instancia de Orchestrator requiere autenticación, facilita los parámetros ElasticSearchUsername, ElasticSearchPassword, elasticSearchDiagnosticsUsername y elasticSearchDiagnosticsPassword.
-robotsElasticSearchTargets	Opcional. Este parámetro te permite enviar registros de UiPath Robot solo al servidor de Elasticsearch configurado. Facilita la URL de Elasticsearch como el valor, por ejemplo "http://elasticserver:9200". Ten en cuenta que solo puede utilizarse junto con el parámetro -robotsElasticSearchUrl. Si no facilitas este parámetro, los registros de UiPath Robot se envían a la base de datos SQL configurada y Elasticsearch.
-robotsElasticSearchUsername	Opcional. Este parámetro te permite indicar el nombre de usuario de tu instancia de Elasticsearch si está habilitada su autenticación.
-robotsElasticSearchPassword	Opcional. Este parámetro te permite indicar la contraseña de tu instancia de Elasticsearch si está habilitada su autenticación.
-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.
-useQuartzClustered	Opcional. Un conmutador que indica que se trata de una instalación agrupada.
-loadBalancerUseRedis	Opcional. Utiliza Redis como base de datos para distribuir mensajes y caché a y desde todos los equipos conectados a través de tu equilibrador de carga. Si -redisConnectionString está especificado, se establecerá automáticamente en true, de lo contrario, se establecerá en 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. Ejemplos: con SSL habilitado: -redisConnectionString "docs123.redis.cache.windows.net:6380,password=******,ssl=True" sin SSL habilitado: -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	Opcional. Define el destino en el que se guardarán los medios de ejecución y los paquetes. Puede completarse con los siguientes destinos: FileSystem - such as storageType "FileSystem" . This is the default value in both update scenarios and clean installations, even if the parameter is not specified. Azure - such as storageType "Azure" . Amazon - such as storageType "Amazon" . Minio - such as storageType "Minio" . Si has invalidado el parámetro UiPath.Orchestrator.dll.config Storage.Type en la sección Configuración de Azure App Service, al actualizar tendrás que traspasar este valor como un parámetro de script a Publish-Orchestrator.ps1.
-storageLocation	Opcional. Define la ubicación real en la que se guardarán los medios de ejecución y los paquetes. Particularidades: FileSystem - provide an absolute path in the RootPath=.\Storage format, such as storageLocation "RootPath=C:\FolderName\AnotherFolderName" . This is the default value in both update scenarios and clean installations, even if the parameter is not specified. Azure - provide a connection string, such as storageLocation "DefaultEndpointsProtocol=https;AccountName=usr;AccountKey=...;EndpointSuffix=core.windows.net" . Amazon - provide a connection string, such as storageLocation" "EndpointRegion=eu-west-3;accessKey=AKIAZGUEIGXUJ3BBI4MW;secretKey=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;useHttp=false" . Minio - provide a connection string, such as storageLocation" "host=localhost:9001;accessKey=YVKYFJ0ZY246KDKP0634;secretKey=bdBEk2ubhIFsTNPuQ80PjKL+oqZBj67HoSWBFnw1" . More information on these deployments types is available here. Si has invalidado el parámetro UiPath.Orchestrator.dll.config Storage.Location en la sección Configuración de Azure App Service, al actualizar tendrás que traspasar este valor como un parámetro de script a Publish-Orchestrator.ps1.
-standbyslotname	Opcional. Solo puede utilizarse en escenarios de actualización. Si se especifica, el script implementa Orchestrator en la ranura del App Service indicada en lugar de la de producción. Además, se realizará una ranura de intercambio con la ranura de producción, sin tiempo de inactividad. Prerrequisitos: la ranura del servicio de aplicaciones en espera debe apuntar a una base de datos SQL diferente. the standby slot Connection String must be made slot sticky (by selecting the Slot Setting box in Azure Portal). el archivo UiPath.Orchestrator.dll.config de la ranura de producción debe copiarse a la ranura en espera desde la ranura de producción.
-productionSlotName	Opcional. Solo puede utilizarse si la ranura de la implementación de Orchestrator App Service es diferente a la ranura del servicio de aplicaciones predeterminada de producción establecida por 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. Ten en cuenta que la configuración existente se combinará con la nueva.
-stopApplicationBeforePublish	Opcional. Si está presente, detiene la aplicación antes de su implementación y la inicia después de que esta finalice.
-unattended	Opcional. Si está presente, la implementación continúa sin confirmación del usuario.
-bucketsAvailableProviders	Opcional. Una cadena que contiene una lista de proveedores de depósitos separados por comas que quieres habilitar. Si no se especifica, se establece el valor predeterminado en Orchestrator,Amazon,Azure,Minio. También tienes la posibilidad de habilitar el proveedor FileSystem añadiéndolo a esa lista. Precaución: si utilizas el proveedor FileSystem y actualizas a la versión 20.10.7 o posteriores, deberás traspasar un valor que incluya FileSystem para este parámetro. Si no lo haces, este proveedor estará deshabilitado y ya no podrás utilizar esos depósitos.
-bucketsFileSystemAllowlist	Obligatorio solo cuando se selecciona FileSystem como proveedor de depósitos. La lista de ubicaciones en la que quieres permitir que se creen depósitos para el proveedor FileSystem. Si habilitas el proveedor FileSystem, también deberás traspasar un valor para este parámetro. Los valores son una lista de rutas de acceso UNC, separadas por el símbolo de la pleca | (p. ej., \\mysharedstorage\mybyckets\|\\myotherserver\myotherbuckets).

Parámetros que persisten en la actualización

Los siguientes valores del parámetro UiPath.Orchestrator.dll.config migrarán automáticamente y persistirán al llevar a cabo una actualización. Para cambiarlos, suministra nuevos valores al llamar al script 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

Ejemplos

Instalación de nodo único

El siguiente ejemplo te permite llevar a cabo una instalación limpia de Orchestrator en un nodo, utilizar Elasticsearch para los registros y guardar paquetes en Azure Blob Storage y sus metadatos en la base de datos SQL. El procedimiento tiene lugar de forma -unattended y registra sus pasos en el nivel -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" `
-hostAdminPassword "12345qwert" `
-defaultTenantAdminPassword "12345qwert" `
-storageType "Azure" `
-storageLocation "DefaultEndpointsProtocol=https;AccountName=usr;AccountKey=...;EndpointSuffix=core.windows.net" `
-robotsElasticSearchUrl "http://docelasticserver:9200" `
-verbose

Instalación multinodo

El siguiente ejemplo te permite llevar a cabo una instalación limpia de Orchestrator en múltiples nodos y utilizar Elasticsearch para los registros y Redis para la distribución de mensajes y la caché. Los paquetes se guardan en Azure Blob Storage y sus metadatos en la base de datos SQL. El procedimiento tiene lugar de forma -unattended y registra sus pasos en el nivel -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" `
-useQuartzClustered `
-redisConnectionString "docs123.redis.cache.windows.net:6380,passwprd=******,ssl=True" `
-azureSignalRConnectionString "Endpoint=https://doctest.signalr.net;AccessKey=*****;Version=1.0;" `
-robotsElasticSearchUrl "http://docelasticserver:9200" `
-hostAdminPassword "12345qwert" `
-defaultTenantAdminPassword "12345qwert" `
-storageType "Azure" `
-storageLocation "DefaultEndpointsProtocol=https;AccountName=usr;AccountKey=...;EndpointSuffix=core.windows.net" `
-verbose

Actualización multinodo

El siguiente ejemplo te permite actualizar un Orchestrator multinodo existente a la versión más reciente disponible sin cambiar ninguna configuración preexistente. El procedimiento tiene lugar de forma -unattended y registra sus pasos en el nivel -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

El siguiente ejemplo te permite actualizar un Orchestrator multinodo existente a la versión más reciente disponible y cambiar solo el valor de los parámetros Webhooks.Enabled y Telemetry.Enabled a false. El procedimiento tiene lugar de forma -unattended y registra sus pasos en el nivel -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