automation-ops
latest
false
Wichtig :
Bitte beachten Sie, dass dieser Inhalt teilweise mithilfe von maschineller Übersetzung lokalisiert wurde.
Automation Ops Benutzerhandbuch
Automation CloudAutomation Cloud Public SectorAutomation Suite
Last updated 23. Okt. 2024

Über UiPath-CLI

UiPath® bietet eine Befehlszeilenschnittstelle (CLI), mit der Sie bestimmte vordefinierte Aufgaben für die Verwaltung und das Testen von RPA-Paketen ausführen können. Der Zweck der UiPath-CLI ist es, diese Funktionen einfach und ohne Plugin mit Drittanbieter-Tools wie GitLab, Jenkins und vielen anderen zu integrieren.

Hinweis:

UiPath CLI kann mit dem Orchestrator verwendet werden, der über die Automation Cloud™, die Automation Suite oder eigenständig bereitgestellt wird.

Häufige Anwendungsfälle für die UiPath-CLI sind:

  • Packen von Studio-Projekten in NuGet-Pakete.
  • Bereitstellen von NuGet-Paketen im Orchestrator.
  • Ausführen von Aufträgen im Orchestrator.
  • Ausführen von Testsätzen im Orchestrator.

UiPath CLI besteht aus zwei Typen:

  1. UiPath.CLI.Windows

    • Wird nur auf Windows-Geräten ausgeführt.
    • Erstellt Windows – Legacy-,Windows-und plattformübergreifende Projekte.
  2. UiPath.CLI

    • Läuft nur auf Linux-Geräten.
    • Erstellt nur plattformübergreifende Projekte.
Hinweis:
  • UiPath-CLI unterstützt keine SSO-Verbindung.

  • Die UiPath-CLI kann nicht verwendet werden, um Projekte zu erstellen, die Lokale Trigger verwenden.

  • Der UiPath-CLI fehlt die Funktionalität zum Signieren eines Pakets – eine Funktion, die verfügbar ist, wenn Sie das Paket über Studio veröffentlichen. In diesem Fall besteht die einzige Option darin, das Paket zu signieren, nachdem es mit der UiPath-CLI erstellt wurde. Weitere Informationen finden Sie unter dem Signierungsbefehl. Diese Signaturoption funktioniert auch für Azure DevOps und Jenkins.

Voraussetzungen

Hier können Sie die Kompatibilität zwischen der CLI-Version, der erforderlichen .NET-Version und der Ziel-Roboterversion überprüfen.

CLI-Version

.NET-Version erforderlich

Zielroboterversion für die erstellten Automatisierungen

24.10

.NET 8

24.10+

23.10

.NET 6

23.10+

23.4

.NET 6

23.4+

Für UiPath.CLI.Windows müssen Sie auch .NET Desktop Runtime installieren, das auch mit .NET SDK mitgeliefert wird.

Herunterladen der UiPath-CLI

Sie können jede Version der UiPath-CLI aus dem offiziellen öffentlichen UiPath-Feed herunterladen.

  1. Rufen Sie den offiziellen öffentlichen Feed von UiPathauf.
  2. Geben Sie in der Suchleiste Nach Schlüsselwörtern filtern uipath.cli ein.
  3. Wählen Sie eine der folgenden Optionen aus:
    • UiPath.CLI - UiPath-CLI, die für Linux-Geräte entwickelt wurde
    • UiPath.CLI.Windows – UiPath-CLI für Windows-Geräte
  4. Wechseln Sie zur Registerkarte Versionen , und wählen Sie eine Version der CLI aus, die Sie herunterladen möchten.
  5. Wählen Sie Herunterladen aus.
  6. Öffnen Sie den Ordner, in den die NUPKG-Datei heruntergeladen wurde, klicken Sie mit der rechten Maustaste darauf und extrahieren Sie die Datei in einen Ordner.
Ergebnisse: Ein Ordner mit demselben Namen wie die NUPKG-Datei wird erstellt. Dieser Ordner enthält den Inhalt der UiPath CLI. Der Einstiegspunkt für alle Vorgänge ist uipcli.exe (für UiPath.CLI.Windows) oder uipcli.dll (für UiPath.CLI) im Ordner tools .

UiPath.CLI.Windows-Kompatibilitätsmatrix

Die Version von UiPath Studio, die Sie zum Erstellen Ihrer Projekte verwenden, muss mit der Version von UiPath.CLI.Windows übereinstimmen.

Legende: available - kompatibel; Nicht verfügbar - nicht kompatibel.

Orchestrator

Projekttyp

UiPath.CLI.Windows 23.10

UiPath.CLI.Windows 23.6

UiPath.CLI.Windows 22.10

2023.10.x hat PaaS

Windows – Legacy

available

available

available

2023.10.x hat PaaS

Windows

available

available

available

2023.10.x hat PaaS

Plattformübergreifend

available

available

available

2021.10.x Lokal (On-Premises)

Windows – Legacy

available

available

available

2021.10.x Lokal (On-Premises)

Windows

available

available

available

2021.10.x Lokal (On-Premises)

Plattformübergreifend

available

available

available

2021.10.x PaaS

Windows – Legacy

available

available

available

2021.10.x PaaS

Windows

available

available

available

2021.10.x PaaS

Plattformübergreifend

available

available

available

2022.4.x

Windows – Legacy

available

available

available

2022.4.x

Windows

available

available

available

2022.4.x

Plattformübergreifend

available

available

available

2022.10.x

Windows – Legacy

available

available

available

2022.10.x

Windows

available

available

available

2022.10.x

Plattformübergreifend

available

available

available

2023.4.xWindows – Legacy

available

available

available

2023.4.xWindows

available

available

available

2023.4.xPlattformübergreifend

available

available

available

Cloud

Windows – Legacy

available

available

available

Cloud

Windows

available

available

available

Cloud

Plattformübergreifend

available

available

available

UiPath.CLI-Kompatibilitätsmatrix

Die Version von UiPath Studio, die Sie zum Erstellen Ihrer Projekte verwenden, muss mit der Version von UiPath.CLI übereinstimmen. Wenn Sie beispielsweise Projekte mit UiPath Studio 2021.10 erstellen, Sie müssen die Version 21.10 von UiPath.CLI verwenden.

Legende: available - kompatibel; Nicht verfügbar - nicht kompatibel.

OrchestratorProjekttypUiPath.CLI 23.10UiPath.CLI 23.6UiPath.CLI 22.10UiPath.CLI 22.4UiPath.CLI 21.10

2023.10.x hat PaaS

Windows – Legacy

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

2023.10.x hat PaaS

Windows

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

2023.10.x hat PaaS

Plattformübergreifend

available

available

available

available

available

2021.10.x Lokal (On-Premises)

Windows – Legacy

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

available

available

2021.10.x Lokal (On-Premises)

Windows

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

2021.10.x Lokal (On-Premises)

Plattformübergreifend

available

available

available

available

available

2021.10.x PaaS

Windows – Legacy

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

available

available

2021.10.x PaaS

Windows

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

2021.10.x PaaS

Plattformübergreifend

available

available

available

available

available

2022.4.x

Windows – Legacy

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

available

available

2022.4.x

Windows

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

2022.4.x

Plattformübergreifend

available

available

available

available

available

2022.10.x

Windows – Legacy

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

available

available

2022.10.x

Windows

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

2022.10.x

Plattformübergreifend

available

available

available

available

available

2023.4.xWindows – Legacy

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

available

available

2023.4.xWindows

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

2023.4.xPlattformübergreifend

available

available

available

available

available

Cloud

Windows – Legacy

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

available

available

Cloud

Windows

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

Nicht verfügbar

Cloud

Plattformübergreifend

available

available

available

available

available

Verwalten von NuGet-Feeds

In diesem Abschnitt wird beschrieben, wie Sie die integrierten NuGet-Feeds verwalten können. Darüber hinaus erhalten Sie Informationen darüber, wie Sie benutzerdefinierte NuGet-Feeds gemäß Ihren spezifischen Projektanforderungen verwenden können.

Deaktivieren der integrierten NuGet-Feeds

Standardmäßig sucht uipcli nach Abhängigkeiten in den folgenden integrierten Feeds: Sie können festlegen, dass uipcli die integrierten Feeds nicht verwendet, indem Sie den Parameter --disableBuiltInNugetFeeds festlegen. Dieser Parameter kann für die folgenden Aufgaben verwendet werden: analyze, pack und test run. Wenn Sie uipcli mit einer Konfigurationsdatei ausführen, legen Sie "disableBuiltInNugetFeeds": true fest.
docs image
docs image

Verwenden benutzerdefinierter NuGet-Feeds

Sie können benutzerdefinierte Feeds beim Packen einer Automatisierung verwenden.

Verwenden von benutzerdefinierter nuget.config in der UiPath-CLI

Führen Sie die folgenden Schritte aus, um den benutzerdefinierten Feed zu verwenden:

  1. Erstellen Sie eine benutzerdefinierte nuget.config -Datei mit dem folgenden Format:
    <?xml version="1.0" encoding="utf-8"?>
    <configuration>
      <packageSources>
        <add key="test custom feed" value="custom_feed_url" />
      </packageSources>
    </configuration><?xml version="1.0" encoding="utf-8"?>
    <configuration>
      <packageSources>
        <add key="test custom feed" value="custom_feed_url" />
      </packageSources>
    </configuration>
  2. Platzieren Sie die benutzerdefinierte nuget.config -Datei in dem Ordner, in dem uipcli zwischengespeichert wird:
    docs image

Verwenden von benutzerdefinierten nuget.config in Azure DevOps

Sie müssen die Konfiguration aktualisieren und nuget.config $(Agent.ToolsDirectory)/uipclinach dem InstallPlatform Schritt in kopieren, wie im folgenden Beispiel gezeigt:
trigger:
- main

pool:
  vmImage: ubuntu-latest

stages:
- stage: Demo
  jobs:
    - job: Demo
      steps:
        - task: UiPathInstallPlatform@4
          inputs:
            cliVersion: 'X_23.6.8581.19168'
        
        - task: CopyFiles@2
          inputs:
            SourceFolder: '$(Build.SourcesDirectory)'
            Contents: 'nuget.config'
            TargetFolder: '$(Agent.ToolsDirectory)/uipcli'

        - task: UiPathPack@4
          inputs:
            versionType: 'AutoVersion'
            projectJsonPath: '$(Build.SourcesDirectory)/AutomationProjects/CrossPlatform/VB/ProjectWithCustomLibraryFromOrchestrator_CrossPlatform_VB/project.json'
            outputPath: '$(Build.ArtifactStagingDirectory)/Output'
            traceLevel: 'Information'trigger:
- main

pool:
  vmImage: ubuntu-latest

stages:
- stage: Demo
  jobs:
    - job: Demo
      steps:
        - task: UiPathInstallPlatform@4
          inputs:
            cliVersion: 'X_23.6.8581.19168'
        
        - task: CopyFiles@2
          inputs:
            SourceFolder: '$(Build.SourcesDirectory)'
            Contents: 'nuget.config'
            TargetFolder: '$(Agent.ToolsDirectory)/uipcli'

        - task: UiPathPack@4
          inputs:
            versionType: 'AutoVersion'
            projectJsonPath: '$(Build.SourcesDirectory)/AutomationProjects/CrossPlatform/VB/ProjectWithCustomLibraryFromOrchestrator_CrossPlatform_VB/project.json'
            outputPath: '$(Build.ArtifactStagingDirectory)/Output'
            traceLevel: 'Information'

Verwenden einer benutzerdefinierten nuget.config-Datei in Jenkins

Sie müssen die Konfiguration aktualisieren und nuget.config ${WORKSPACE}/CLInach dem InstallPlatform Schritt in kopieren, wie im folgenden Beispiel gezeigt:
pipeline {
    agent {
        label 'plugins-jenkins-lts-agent-01'
    }

    stages {
        stage('Clone') {
            steps {
                git (
                    branch: 'main',
                    url: 'https://github.com/al3xandru-uipath-qa/CI-Plugins-Customer-Support.git'
                )
            }
        }
        
        stage('Install Platform') {
            steps {
                UiPathInstallPlatform (
                    traceLevel: 'Information'
                )
            }
        }
        
        stage('Copy nuget.config') {
            steps {
                bat 'copy nuget.config CLI\\nuget.config'
            }
        }
        
        stage('Pack') {
            steps {
                UiPathPack (
                    outputPath: '${WORKSPACE}/Output',
                    projectJsonPath: '${WORKSPACE}/AutomationProjects/CrossPlatform/VB/ProjectWithCustomLibraryFromOrchestrator_CrossPlatform_VB/project.json',
                    traceLevel: 'Information',
                    version: AutoVersion()
                )
            }
        }
    }
}pipeline {
    agent {
        label 'plugins-jenkins-lts-agent-01'
    }

    stages {
        stage('Clone') {
            steps {
                git (
                    branch: 'main',
                    url: 'https://github.com/al3xandru-uipath-qa/CI-Plugins-Customer-Support.git'
                )
            }
        }
        
        stage('Install Platform') {
            steps {
                UiPathInstallPlatform (
                    traceLevel: 'Information'
                )
            }
        }
        
        stage('Copy nuget.config') {
            steps {
                bat 'copy nuget.config CLI\\nuget.config'
            }
        }
        
        stage('Pack') {
            steps {
                UiPathPack (
                    outputPath: '${WORKSPACE}/Output',
                    projectJsonPath: '${WORKSPACE}/AutomationProjects/CrossPlatform/VB/ProjectWithCustomLibraryFromOrchestrator_CrossPlatform_VB/project.json',
                    traceLevel: 'Information',
                    version: AutoVersion()
                )
            }
        }
    }
}

War diese Seite hilfreich?

Hilfe erhalten
RPA lernen – Automatisierungskurse
UiPath Community-Forum
Uipath Logo White
Vertrauen und Sicherheit
© 2005–2024 UiPath. Alle Rechte vorbehalten