Konfigurationsdateien

Configuration files for UiPath Robot, including UiPath.config and proxy.json, system environment variables, and instructions for restarting components after changes.

Neustarten von Roboterkomponenten

Sobald Sie Konfigurationsdateien bearbeitet haben, müssen Sie die relevanten Robot-Komponenten neu starten, damit die Änderungen wirksam werden. Die folgende Liste fasst zusammen, wie mehrere Komponenten auf Grundlage des Installationsmodus des Roboters neu gestartet werden.

Denken Sie daran, alle laufenden Arbeiten vor dem Neustart zu speichern, um zu vermeiden, dass ungespeicherter Fortschritt verloren geht.

• UiPath-Roboterdienst
  • Installation im Dienstmodus
    1. Öffnen Sie den Aufgabenmanager > Dienste.
    2. Look for the UiRobotSvc service, named UiPath Robot.
    3. Öffnen Sie das Kontextmenü für den Dienst und wählen Sie Neustart aus.
  • Installation im Benutzermodus – Beenden Sie den Assistant und starten Sie ihn dann neu oder:
    1. Öffnen Sie den Aufgabenmanager > Details.
    2. Wählen Sie den Prozess UiPath.Service.UserHost.exe aus.
    3. Wählen Sie Aufgabe beenden aus.
• UiPath RobotJS ServiceHost - Service Mode installations with the JavaScript add-on
  1. Öffnen Sie den Aufgabenmanager > Dienste.
  2. Suchen Sie nach dem Dienst UiPath RobotJS Service.
  3. Öffnen Sie das Kontextmenü für den Dienst und wählen Sie Neustart aus.
• UiPath Assistant
  1. Wählen Sie im Assistant Einstellungen und dann Beenden aus.
  2. Starten Sie Assistant neu.
• Widgets – Starten Sie den Assistant neu oder
  1. Öffnen Sie das Kontextmenü für das Assistant-Symbol in der Taskleiste.
  2. Widgets neu laden

uipath.config

Die Datei UiPath.config enthält wichtige Konfigurationsparameter für den Roboter. Als Administrator können Sie das Verhalten Ihrer Roboter anpassen, indem Sie die Liste der Parameter in der Konfigurationsdatei bearbeiten.

Hinweis:

Jede Umgebung kann bestimmte Hinweise benötigen, sodass Sie mit UiPath verschiedene Konfigurationen basierend auf der aktuellen Umgebung des Roboters anwenden können, sei es Entwicklung, Staging oder Produktion. Seien Sie beim Bearbeiten dieser Datei immer vorsichtig, da eine ungenaue Konfiguration Anwendungsprobleme verursachen kann.

Wichtig:

Beginnt mit Roboter 2025.10, Proxyeinstellungen werden in proxy.json konfiguriert, nicht in UiPath.config. Weitere Informationen finden Sie unter proxy.json.

Zugreifen auf die Datei

When you install your Robot, the system creates the UiPath.config file in the Robot installation folder.

To access it, navigate to %ProgramFiles%\UiPathPlatform\Robot\<version>\UiPath.config for a per-machine installation, or %LocalAppData%\Programs\UiPathPlatform\Robot\<version>\UiPath.config for a per-user installation. On update, the UiPath Platform Installer copies your UiPath.config and NuGet.config to the new version folder, so your edits are kept. It then resets Telemetry.Enabled, SkipHttpConfigurationSources and DisableSecureXaml in UiPath.config (and DefaultServiceUrl when SERVICE_URL is set) to the values of its installation parameters, so set those through the installer parameters. It also sets signatureValidationMode in NuGet.config from ENFORCE_SIGNED_EXECUTION and removes the trustedSigners node unless ENFORCE_SIGNED_EXECUTION is true.

Anpassbare Einstellungen

Die UiPath.config-Datei besteht aus den folgenden Parametern:

• Im Abschnitt connectionSettingsConfig

  • DefaultServiceUrl (string) – Legt die Standardadresse fest, die der Roboter verwendet, um eine Verbindung mit Orchestrator herzustellen.

    Beispiel:

    string DefaultServiceUrl = "https://cloud.uipath.com"
    

  • AutoSignIn (bool) – Aktiviert die Funktion zur automatischen Anmeldung für Assistant. Der Standardwert ist false.

    Beispiel:

    bool AutoSignIn = true.
    

  • EnforceDefaultServiceUrl (bool) - Enforces the address provided as DefaultServiceUrl to all users. Default value is false. Has no effect in Service Mode.

    Beispiel:

    bool EnforceDefaultServiceUrl = true.
    

• Im Abschnitt communicationSettingsConfig

  • MaxMessageSizeInMegabytes (Byte) – Legt die maximale Größe einer Nachricht fest, die das System senden oder empfangen kann, in MB. Der Standardwert ist 10.

    Dies wird verwendet, um Überlastung oder Prozessabstürze aufgrund der Verarbeitung zu großer Nachrichten zu vermeiden.

    Beispiel:

    byte MaxMessageSizeInMegabytes = 10;
    

  • InstallPackageTimeout (TimeSpan) – Legt das Zeitlimit für Paketinstallationen fest. Der Standardwert ist 20 Minuten.

    Wenn eine Paketinstallation länger als die definierte Zeit dauert, bricht das System die Installation ab.

    Beispiel:

    TimeSpan InstallPackageTimeout = TimeSpan.FromMinutes(20);
    

  • RequestTimeout (TimeSpan) – Definiert, wie lange das System auf eine Kommunikationsantwort wartet. Der Standardwert ist 40 Sekunden.

    Wenn das System im festgelegten Zeitraum keine Antwort erhält, hält es an und fährt fort.Dadurch werden Systemausfälle verhindert.

    Beispiel:

    TimeSpan RequestTimeout = TimeSpan.FromSeconds(40);
    

• Im Abschnitt packageSettingsConfig

  • PackagesInstallationFolder (string) - Sets the default directory where packages are installed. Default value is %UserProfile%\.nuget\packages. In Service Mode, the path is expanded for the user that runs each job.

  • SkipHttpConfigurationSources (bool) - Enables the system to ignore package sources configured with an HTTP or HTTPS URL, such as NuGet feeds. Default value is false.

    Das bedeutet, dass das System keine Pakete aus diesen Quellen abruft, was nützlich ist, wenn die Quellen nicht zuverlässig oder sicher sind.

  • DisableSecureXaml (bool) – Ermöglicht dem Roboter, potenziell unsichere Workflows auszuführen. Der Standardwert ist false.

  • DirectDownload (bool) - Stops the Robot from writing downloaded packages to the shared NuGet http-cache disk cache. The Robot still reads files that are already in the cache, and downloads the others every time it needs them. Default value is false.

  • NoCache (bool) - Stops the Robot from reading or writing the shared NuGet http-cache. The Robot uses a temporary folder that it discards instead. Unlike DirectDownload, the in-memory download cache still applies, so each package is downloaded once per restore. Default value is false.

  • PackageSaveWithoutNupkg (bool) – Ermöglicht das Speichern der Pakete ohne die .nupkg Datei. Der Standardwert ist false.

    Dies ist hilfreich, um die Downloadgröße zu reduzieren.

• Im Abschnitt analyticsSettingsConfig
  • Telemetry.Enabled (bool) - Allows UiPath to collect and send usage data for analysis. Default value is true. The UiPath Platform Installer sets it from its own telemetry setting when it installs or updates the Robot.
• Im Abschnitt robotCacheSettingsConfig

  • SessionCacheDuration (TimeSpan) – Definiert, wie lange die Daten aus einer bestimmten Sitzung im Cache aufbewahrt werden sollen, bevor sie verworfen werden. Der Standardwert ist 30 Sekunden.

    Dies ist hilfreich, um Daten wie Variable-Werte oder Details von Vorgängen wiederzuverwenden, anstatt sie neu zu erstellen oder erneut abzurufen.

    Beispiel:

    TimeSpan SessionCacheDuration = TimeSpan.FromSeconds(30);
    

  • GetResourceUrlCacheDuration (TimeSpan) – Definiert, wie lange die URLs für Ressourcen, wie APIs oder Webseiten, im Cache gespeichert werden. Der Standardwert ist eine (1) Stunde.

    Dies ist nützlich zur Optimierung der Leistung in Szenarien, in denen Ihre Roboter regelmäßig auf bestimmte Ressourcen zugreifen müssen.

    Beispiel:

    TimeSpan GetResourceUrlCacheDuration = TimeSpan.FromHours(1);
    

• Im Abschnitt robotJsSettingsConfig

  • ListenerPort (int) – Legt die Portnummer fest, auf der Robot.js auf eingehende Verbindungen hört. Der Standardwert ist 2323.

    Dadurch kann der Roboterdienst mit Webanwendungen interagieren, die auf lokalen oder Remote-Servern ausgeführt werden.

    Beispiel:

    int ListenerPort = 2323;
    

  • TokenExpiryInDays (int) - Sets the validity period, in days, of the token that the robot service issues to a web application after the user gives consent. Default value is 30 days.

    Beispiel:

    int TokenExpiryInDays = 30;
    

  • AllowUrlList (string) - Sets the web origins (the browser Origin header) whose RobotJS consent dialog the Robot accepts automatically. Separate entries with semicolons. The default list is https://cloud.uipath.com, https://staging.uipath.com, https://alpha.uipath.com, https://govcloud.uipath.us and https://alpha.gov.uipath-dev.com. Setting this key replaces the default list. To add origins without replacing it, use the UIPATH_ROBOTJS_ALLOWLIST system variable.

    Beispiel:

    string AllowUrlList = "https://cloud.uipath.com;https://mydomain.com";
    

Wichtig:

• Back up the original UiPath.config file before you change it, so you can restore the original settings.
• Um die an der UiPath.config-Datei vorgenommenen Aktualisierungen anzuwenden, starten Sie den UiPath-Dienst oder das System neu.
• Lokale Einstellungen in der Datei UiPath.config haben Vorrang vor den im Orchestrator konfigurierten Einstellungen.

You can encrypt sensitive data in the UiPath.config file for additional security.

UiPath Robot-Systemvariablen

Weiteres benutzerdefiniertes Verhalten kann über Systemumgebungsvariablen konfiguriert werden.

Wichtig:

Starten Sie den UiPath-Roboterdienst neu, nachdem Sie eine der Systemvariablen geändert haben.

Die folgende Liste fasst die häufigsten Anwendungsfälle zusammen:

• UIPATH_SESSION_TIMEOUT – Ändert die Standard-60-Sekunden-Timeout für das Erstellen einer interaktiven Sitzung.Passen Sie diesen Wert an, um das Verhalten des Roboters basierend auf der Leistung und den Ladezeiten des Systems, mit dem er interagiert, anzupassen.

  Beispiel:

  UIPATH_SESSION_TIMEOUT=75
  

• UIPATH_PIP_SESSION_TIMEOUT – Ändert die Standard-180-Sekunden-Timeout für das Starten eines Prozesses in einer Roboter-Sitzung.

  Beispiel:

  UIPATH_PIP_SESSION_TIMEOUT=60
  

• UIPATH_LANGUAGE - Sets the language the Robot operates in. The value is a culture code, not the language name. The supported codes are en, fr, de, es, es-MX, pt, pt-BR, ja, ko, ru, tr, ro, zh-CN and zh-TW. The Robot ignores an unsupported value, such as French, and falls back to the next source. The order of precedence is:

  1. UIPATH_LANGUAGE user environment variable
  2. UIPATH_LANGUAGE machine environment variable
  3. UIPATH_LANGUAGE process environment variable
  4. Current thread UI culture, if supported
  5. UiPath-Standardsprache (Englisch)

  Beispiel:

  UIPATH_LANGUAGE=fr
  

• UIPATH_HEADLESS_WITH_USER – Verwendet die Anmeldeinformationen eines bestimmten Benutzers, die zuvor im Orchestrator konfiguriert wurden.

  Beispiel:

  UIPATH_HEADLESS_WITH_USER=True
  

• UIPATH_PRE_LOADED_EXECUTOR – Standardmäßig wird ein vorgeladener Executor gestartet, wenn der Roboter gestartet wird. Um dieses Verhalten zu ändern und den vorgeladenen Executor nur zu starten, wenn der erste Prozess ausgeführt wird, legen Sie diese Variable auf None.

  Beispiel:

  UIPATH_PRE_LOADED_EXECUTOR=None
  

• UIPATH_DISABLE_PRE_LOADED_EXECUTOR – Deaktiviert die vorgeladene Executor-Funktion.

  Beispiel:

  UIPATH_DISABLE_PRE_LOADED_EXECUTOR=True
  

• UIPATH_ROBOTJS_ALLOWLIST – Akzeptiert automatisch das Dialogfeld für die Roboter-Zustimmung, wenn die Verbindung zwischen dem Robot JS SDK und dem Roboter-Executor hergestellt wird.

  The value is a list of origins separated by semicolons. Each origin includes the scheme, for example https://myapp.contoso.com. Add the port only if it is not the default (80 or 443). The Robot also accepts the origins in the AllowUrlList key of the robotJsSettings section of UiPath.config.

  Beispiel:

  UIPATH_ROBOTJS_ALLOWLIST=https://cloud.uipath.com;https://mydomain.com
  

• UIPATH_DNS_MACHINENAME – Ermöglicht die Verwendung des DNS-Hostnamens für Localhost beim Erstellen von RDP-Sitzungen. Um unbeaufsichtigte Aufträge in Umgebungen mit Kerberos-Authentifizierung für RDP auszuführen, legen Sie diesen Wert auf True fest.

  Beispiel:

  UIPATH_DNS_MACHINENAME=True
  

• NUGET_FALLBACK_PACKAGES – Konfiguriert die Pfade zu Fallback-Paketordnern. Verwenden Sie Semikolons, um mehrere Pfade zu trennen.

  Wenn diese Variable nicht vorhanden ist, sucht der Roboter nach Ausweichpaketordnern in der Datei Nuget.config.

• NUGET_SCRATCH – Ermöglicht es mehreren Robotern im Benutzermodus auf derselben Maschine, einen lokalen Pfad zum Speichern von Paketen zu teilen.

  Der Wert muss ein anderer Pfad als der Nuget-Installationsordner sein und fungiert als temporärer Ordner für NuGet.

  Hinweis:

  Nur die NUGET_SCRATCH Variable sollte den konfigurierten temporären Ordner verwenden.

  Beispiel:

  NUGET_SCRATCH=C:\NuGetTempFolder
  

• UIPATH_PRESERVE_CREDENTIALS_CASE – Behält die ursprüngliche Form der Protokollierungsanmeldeinformationen bei (Domäne\Benutzername).

  Beispiel:

  UIPATH_PRESERVE_CREDENTIALS_CASE = True
  

• UIPATH_SESSION_BEHAVIOR – Konfiguriert das Verhalten der Sitzungswiederherstellung nach Abschluss eines Auftrags. Die folgenden Optionen sind verfügbar:

  • TryReuseAndRestoreSession– Die Standardoption. Versucht, die Sitzung wiederzuverwenden und in den vorherigen Zustand zurückzuversetzen, nachdem ein Auftrag abgeschlossen wurde. Wenn es keine anfängliche Sitzung zur Wiederverwendung gibt, meldet es sich bei der Wiederherstellung ab.
  • ForceNew– Erstellt eine völlig neue Sitzung, unabhängig vom vorherigen Sitzungsstatus. Meldet sich bei der Wiederherstellung immer ab.
  • LeaveSessionActive– Verhindert die Wiederherstellung des ursprünglichen Sitzungsstatus.
  • LeaveSessionDisconnected– Trennt die Sitzung bei der Wiederherstellung immer.

  Beispiel:

  UIPATH_SESSION_BEHAVIOR = LeaveSessionDisconnected
  

• UIPATH_HTTP_CONNECTION_LIFETIME – Definiert, wie lange die Verbindung zum Orchestrator offen bleibt, bevor sie geschlossen und aktualisiert wird. Die Standarddauer beträgt 30 Minuten. Um diesen Wert anzupassen, geben Sie den Wert in Sekunden ein.

  Beispiel:

  // to set 10 minutes                          
  UIPATH_HTTP_CONNECTION_LIFETIME = 600
  

• UIPATH_FILE_LOG_LEVEL - Definiert die in der lokalen Datei verwendete Ausführungsprotokollebene.Dies unterscheidet sich von der für Orchestrator verwendeten Protokollebene. Die folgenden Optionen sind verfügbar:

  • Ausführlich
  • Ablaufverfolgung
  • Informationen
  • Warnung
  • Fehler (Error)
  • Kritisch
  • Aus

  Beispiel:

  // to set verbose level locally
  UIPATH_FILE_LOG_LEVEL = Verbose
  

• UIPATH_EXECUTOR_STARTUP_DELAY - Definiert die Wartezeit in Sekunden zwischen der Sitzungserstellung und dem Start des Executors.Dies wird verwendet, wenn Ihre Infrastruktur einige Dienste (VPN, Sicherheit) laden muss, bevor die Ausführung Ihrer Automatisierung beginnt.

  Beispiel:

  // to set the delay to 5 seconds
  UIPATH_EXECUTOR_STARTUP_DELAY = 5
  

• UIPATH_MEDIUMPLUS_EXECUTOR – Startet den Roboter-Executor auf der Integritätsebene von Medium+, sodass Automatisierungen mit Fenstern interagieren können, die höhere Berechtigungen erfordern, z. B. das Dialogfeld „Windows CredentialBroker“ während der Eingabe von RDP-Credentials. Legen Sie es auf 1 fest, um es zu aktivieren. Erfordert Windows mit aktivierter Benutzerkontensteuerung (UAC).Weitere Informationen finden Sie unter Integritätsstufen-Erhöhung (Medium+).

  Beispiel:

  UIPATH_MEDIUMPLUS_EXECUTOR=1
  

• UIPATH_MEDIUMPLUS_INVOKE – Ermöglicht die Ausführung der Aktivitäten Invoke Workflow File und Invoke Process auf der Integritätsebene Medium+ pro Aufruf. Beide Bedingungen sind erforderlich, um eine Erhöhung zu erreichen: Diese Variable muss aktiviert sein und die Aktivität muss eine Erhöhung anfordern (ihre Erhöhungsoption muss aktiviert sein) – die Variable allein hat keine Auswirkung. Legen Sie diese Maschinen (System)-Umgebungsvariable auf 1 fest, um sie zu aktivieren.Erfordert Windows mit aktivierter Benutzerkontensteuerung (UAC).Weitere Informationen finden Sie unter Integritätsstufen-Erhöhung (Medium+).

  Beispiel:

  UIPATH_MEDIUMPLUS_INVOKE=1
  

• UIPATH_APPLY_SERVICE_PROXY – bewirkt, dass Roboterprozesse ihren Proxy aus der proxy.json -Datei auf Maschinenebene anstelle der Proxykonfiguration des Kontos übernehmen, unter dem sie ausgeführt werden. Für Unattended-Roboter vorgesehen, deren Dienstkonto kein Benutzerprofil zum Halten einer Proxykonfiguration hat. Die Proxy-Anmeldeinformationen pro Benutzer werden nicht gelesen, daher muss proxy.json sie enthalten, wenn Ihr Proxy eine Basisauthentifizierung erfordert. Der UiPath-Roboterdienst ist nicht betroffen, da er immer proxy.json anwendet. Weitere Informationen finden Sie unter Verwenden des Proxys auf Maschinenebene für alle Roboterprozesse.

  Beispiel:

  UIPATH_APPLY_SERVICE_PROXY=True
  

• UIPATH_VERBOSE_LOG_LIMIT – Begrenzt die Anzahl der Verbose-Protokolle pro Executor-Prozess. Der Standardwert ist 10000. Sobald der Grenzwert erreicht ist, protokolliert der Roboter eine Warnung und verwirft zukünftige Verbose-Protokolle. Werte von 0 oder niedriger werden ignoriert und stattdessen wird der Standardwert verwendet.

  Nur die Protokolle, die der Roboter während der Ausführung von Aktivitäten erzeugt, werden auf das Limit angerechnet; meldet, dass die Automatisierungsprotokolle selbst nicht betroffen sind. Ein isoliert aufgerufener Workflow wird in einem eigenen Executor-Prozess ausgeführt, sodass er sein eigenes Limit hat.

  Beispiel:

  UIPATH_VERBOSE_LOG_LIMIT=5000
  

proxy.json

The proxy.json file stores proxy configuration for the Robot Service when running in service mode. Available starting with Robot 2025.10, it replaces proxy settings that were previously maintained in UiPath.config.

Wichtig:

Beginnt mit Roboter 2025.10, Proxyeinstellungen werden in proxy.json konfiguriert.

Zugreifen auf die Datei

Dateispeicherort: %ProgramData%\UiPath\Shared\proxy.json

Hinweis:

Wenn Sie von einer früheren Version aktualisieren und bereits Proxyeinstellungen konfiguriert haben, migriert das System Ihre vorhandenen Einstellungen automatisch nach proxy.json.

Starten Sie nach dem Bearbeiten von proxy.json den UiPath-Roboterdienst oder das Gerät neu, damit die Änderungen wirksam werden.

Hinweis:

The Robot ignores a proxy.json file that is not owned by the built-in Administrators group or the local system account. The Robot Service moves such a file aside as proxy.json.old.

Parameter

Wir unterstützen die folgenden Parameter.Wenn beide ScriptAddress und ProxyAddress in derselben Datei vorhanden sind, hat ScriptAddress Vorrang.

Parameter	Typ	Beschreibung
ScriptAddress	String	URL des Skripts für die automatische Proxy-Konfiguration (PAC).Wenn vorhanden, hat Vorrang vor ProxyAddress.Zum Beispiel: http://proxy.address/proxy.pac
ProxyAddress	String	Adresse und Port des Proxyservers.Beispiel: http://proxy.address:1234/
BypassLocalAddresses	Boolescher	Wenn true, umgehen lokale Adressen den Proxyserver.
BypassList	String	Semikolon-getrennte Liste mit regulären Ausdrücken für Hosts, die den Proxy umgehenVerwenden Sie \\, um spezielle Regex-Zeichen zu escapen.Zum Beispiel: server\\.domain\\.local$;192\\.168\\.\\d{1,3}\\.\\d{1,3}
UserName	String	Benutzername für die Basic Proxy-Authentifizierung.
Password	String	Kennwort für die Standardauthentifizierung des Proxys.
Domain	String	Domäne für die Proxy-Standardauthentifizierung.

Beispielkonfigurationen

Schritt-für-Schritt-Anweisungen zur Konfiguration finden Sie unter Umleiten von Robotern über einen Proxyserver.

PAC-Skript

{
  "ScriptAddress": "http://proxy.address/proxy.pac"
}

Proxy-Adresse mit Standardauthentifizierung

{
  "ProxyAddress": "http://proxy.address:1234/",
  "BypassLocalAddresses": true,
  "BypassList": "server\\.domain\\.local$;www.example.com;192\\.168\\.\\d{1,3}\\.\\d{1,3}",
  "UserName": "myUser",
  "Password": "<your-password>",
  "Domain": "myDomain"
}