Déploiement des ressources sur Orchestrator

Prérequis

• Créez un fichier CSV qui contient les ressources que vous souhaitez déployer sur Orchestrator.

  Le fichier CSV doit comporter les trois colonnes suivantes : name , type , value et description .

• Exécutez le fichier CLI exe (pour l'héritage Windows) ou dll (pour Windows/Linux/macOS).

• Ajoutez les étendues d'application d'accès à l'API Orchestrator requises.

Pour plus d'informations sur le fichier .csv, consultez l'exemple dans le tableau suivant.

name	Type	valeur	Description
asset_1_name	text	"J'ai un commentaire"	asset_1_description
asset_2_name	Integer	1	asset_2_description
asset_3_name	Bool	false	asset_3_description
asset_4_name	InformationsIdentification	username:password	asset_4_description

Pour déployer des ressources sur Orchestrator, procédez comme suit :

1. Exécutez la tâche asset à l'aide de uipcli asset. Vous pouvez remarquer une liste des sous-tâches disponibles.
2. Spécifiez les paramètres requis et exécutez la sous-tâche deploy . Le tableau suivant décrit les paramètres requis :

Paramètre	Description
Assets File (pos. 0) ( Requis )	Le nom du fichier CSV qui contient les ressources que vous souhaitez déployer.
Orchestrator URL (pos. 1) ( Requis )	Il s'agit de l'URL de votre Orchestrator.
Orchestrator Tenant (pos. 2)	Le locataire de l'instance Orchestrator où vous souhaitez déployer vos ressources. Obligatoire lorsque vous ciblez Automation Cloud. Facultatif pour Automation Suite et la version autonome d'Orchestrator (MSI local), où le locataire fait partie de l'URL.
-u , ou --username ( Requis si vous utilisez l' authentification de base , via un nom d'utilisateur et un mot de passe)	Le nom d'utilisateur utilisé pour l'authentification auprès d'Orchestrator. Vous devez l'associer au mot de passe correspondant.
-p , ou --password ( Requis si vous utilisez l' authentification de base , via un nom d'utilisateur et un mot de passe)	Le mot de passe utilisé pour l'authentification auprès d'Orchestrator. Vous devez l'associer au nom d'utilisateur correspondant.
-t , ou --token ( Requis si vous utilisez l'authentification basée sur jeton )	Le jeton d’actualisation OAuth2 utilisé pour l’authentification auprès d’Orchestrator. Vous devez l'associer au Nom du compte et à l' ID client .
-a , ou --accountName ( Requis si vous utilisez l'authentification basée sur jeton )	Le nom du compte Orchestrator CloudRPA. Vous devez l'associer au jeton d'actualisation OAuth2 et à l' ID client .
-A , or --accountForApp	Le nom du compte Orchestrator CloudRPA (nom de l’organisation). Vous devez l’associer à l’ID d’application, à la clé secrète de l’application et à l’étendue de l’application pour une application externe.
-I , ou --applicationId ( Requis si vous utilisez l'authentification d'application externe )	ID d’application externe Vous devez l'associer au compte d'application, à l'ID d'application et à l'étendue de l'application.
-S , ou --applicationSecret ( Requis si vous utilisez l'authentification d'application externe )	La clé secrète de l'application externe. Vous devez l'associer au compte d'application, à l'ID d'application et à l'étendue de l'application.
--applicationScope ( Facultatif pour l'authentification d'application externe )	La liste des étendues d'application, séparées par des espaces simples. Facultatif lors de l'utilisation de l'authentification d'application externe, les étendues par défaut sont automatiquement appliquées. Vous devez l’associer à l ’ ID d’application , à la clé secrète de l’ application et à l’étendue de l’application pour l’application externe
-o , or --organizationUnit	Le nom du dossier Orchestrator (unité d'organisation). Pour saisir des sous-dossiers, assurez-vous de saisir à la fois le nom du dossier parent et le nom du sous-dossier. Par exemple, utilisez AccountingTeam\TeamJohn.
-l , or --language	La langue utilisée dans l'interface utilisateur d'Orchestrator.
--traceLevel	Afficher la trace des événements.
--identityUrl	L'URL de votre Identity Server. Requis lorsque Orchestrator s'exécute sur UiPath Automation Suite ou sur la version autonome d'Orchestrator (MSI local). Non nécessaire pour Automation Cloud — la CLI résout le serveur d'identité à partir de l'URL du cloud.
--help	Affiche les paramètres et des exemples de cette commande.
--version	Affiche les informations de version.
--ca-cert	Un ou plusieurs fichiers de certificat CA racine approuvés (PEM, DER ou PKCS#7) utilisés lors de la validation des certificats TLS Orchestrator et Identity Server. Répétez l'indicateur ou séparez plusieurs chemins par des virgules. Voir Approbation de certificats personnalisés pour plus de détails.
--pinnedpubkey	Épingler la clé publique du certificat de feuille de serveur. Format: sha256//<base64>. Vérifié en plus de la validation standard du certificat. Voir Approbation de certificats personnalisés pour plus de détails.

Astuce :

Pour les instances Orchestrator signées par une autorité de certification privée (telle qu'UiPath Automation Suite), cette commande accepte également les paramètres --ca-cert et --pinnedpubkey . Voir Approbation de certificats personnalisés pour des scénarios et des exemples.

Remarque :

Lorsque vous utilisez l'authentification d'application externe sans spécifier le paramètre --applicationScope , la CLI applique automatiquement les étendues Orchestrator suivantes par défaut :

OR.Assets OR.BackgroundTasks OR.Execution OR.Folders OR.Robots.Read OR.Machines.Read OR.Jobs OR.TestSets OR.TestSetExecutions OR.Monitoring OR.Settings.Read

Utilisation

uipcli asset deploy <assets_file> <orchestrator_url> <orchestrator_tenant> [-u <orchestrator_user> -p <orchestrator_pass>] [-t <auth_token> -a <account_name>] [-A <organization_name> -I <application_id> -S <application_secret> --applicationScope <application_scope>] [-o <folder_name>] [-l <language>] [--traceLevel <None|Critical|Error|Warning|Information|Verbose>] [--identityUrl <identity_url>]

Exemples de commande minimum

• uipcli asset deploy "C:\userprofile\assets.csv" "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -u "orchestratorUsername" -p "********" -o "FolderName" --traceLevel "Information"
• uipcli asset deploy "C:\userprofile\assets.csv" "https://orch-23-10-paas.cloudapp.azure.com/" "TenantName" -I "76000552-3e4f-4590-9317-cdb420001f1d" -S '********' --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" --identityUrl "https://orch-23-10-paas.cloudapp.azure.com/identity" -o "FolderName" --traceLevel "Information"
• uipcli asset deploy "C:\userprofile\assets.csv" "https://automation-suite.base.url.com/" "TenantName" -A "organizationName" -I "3f6239b9-e0e8-465e-a429-d9ffd1d9e57a" -S '********' --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" -o "FolderName" --traceLevel "Information
• uipcli asset deploy "C:\userprofile\assets.csv" "https://cloud.uipath.com/" "TenantName" -A "organizationName" -I "becc663c-8f1e-409a-a75f-c00330d80bc8" -S '********' --applicationScope "OR.Folders OR.BackgroundTasks OR.TestSets OR.TestSetExecutions OR.TestSetSchedules OR.Settings.Read OR.Robots.Read OR.Machines.Read OR.Execution OR.Assets OR.Users.Read OR.Jobs OR.Monitoring" -o "FolderName" --traceLevel "Information"