Befehlszeilenoptionen

• Blue Prism als exklusiven Ressourcen-PC für Benutzer „admin“ ausführen:

  automate /resourcepc /user admin mypwd

  oder für einen Benutzer mit Single Sign-on:

  automate /resourcepc /sso

• Blue Prism als öffentlichen Ressourcen-PC ausführen:

  automate /resourcepc /public

• Einen Prozess auf dem lokalen PC ausführen:

  AutomateC /run "Mein geplanter Prozess" /user admin mypwd

  oder für einen Benutzer mit Single Sign-on:

  AutomateC /run "Mein geplanter Prozess" /sso

• Einen Prozess mit Startparametern auf einem Remote-PC ausführen:

  AutomateC /run "Excel Test" /resource YourPCHostName /user admin mypwd /startp "<inputs> <input name='Comment' type='text' value='Hello World' /></inputs>"

• Starten der Prozessalarmüberwachung im Hintergrund ohne Start der Blue Prism Hauptanwendung:

  automate /alerts /user admin mypwd

  oder für einen Benutzer mit Single Sign-on:

  automate /alerts /sso

Zum Ausdrucken einiger Kurztipps zum Standard-Output der Befehlszeile.

Startet Blue Prism im Ressourcen-PC-Modus. Der Schalter /public kann hinzugefügt werden, um den Ressourcen-PC allen Blue Prism Benutzern zugänglich zu machen. Andernfalls ist er nur dem Benutzer zugänglich, der mit der Option /user bzw. /sso angegeben wurde.

Diese Option ist nicht mit dem Schalter /resource zu verwechseln.

Bitte beachten Sie, dass das Starten und Ausführen einer Laufzeitressource mit erhöhten Berechtigungen die Interaktion mit der automatisierten Anwendung beeinflussen kann. Im Allgemeinen müssen die Berechtigungen der Laufzeitressource mit denen des Benutzerkontexts der Zielanwendung übereinstimmen.

Wird nur zusammen mit dem Schalter /resourcepc verwendet. Macht den Ressourcen-PC, wie unter Ausführungsmodi beschrieben, öffentlich verfügbar.

Wird nur zusammen mit dem Schalter /resourcepc verwendet und ermöglicht SSL/TLS-Verschlüsselung für die Datenübertragung an den Ressourcen-PC. Dazu wird das Zertifikat mit dem angegebenen Fingerabdruck verwendet, das im Zertifikatspeicher des Benutzers oder Computers installiert sein muss.

Die Verschlüsselung betrifft sowohl Verbindungen vom Control Room und Zeitplaner als auch verfügbar gemachte Webdienste mit einer Verbindung zur Ressource. Der CN des Zertifikats muss mit der Adresse für die Ressourcenverbindung übereinstimmen und der sich verbindende Client muss der CA vertrauen, die das Zertifikat ausstellt.

(Fortgeschritten) Wird nur zusammen mit dem Schalter /resourcepc verwendet und überschreibt den angezeigten adressierbaren Speicherort der veröffentlichten Webdienste sowie der zugehörigen Ressourcen, wie auf diesem Gerät gehostete WSDLs. Der angegebene Wert muss die Adresse mit dem vollständigen Pfad beinhalten, z. B.: "https://blueprismws.myorg.com:8181". Blue Prism hängt /ws/ sowie die zugehörigen Pfade automatisch an die lokal verfügbaren Ressourcen an.

Dabei ist manuelles Netzwerk-Routing erforderlich, um sicherzustellen, dass es sich bei dem angegebenen Präfix um eine gültige Adresse handelt, die auf dieses Gerät verweist.

(Fortgeschritten) Wird nur zusammen mit dem Schalter /resourcepc verwendet und weist die Laufzeitressource an, sämtliche HTTP-Kommunikation zu ignorieren, die auf ihrem Überwachungsport eingeht. Diese Option sollte nur verwendet werden, wenn die Ressource keine Webdienste verfügbar machen und nicht über die HTTP-Schnittstelle kontrolliert werden muss.

Beim Starten wird zunächst für die angegebene Dauer in Sekunden auf die Verfügbarkeit der Datenbank gewartet. Während dieses Zeitraums wird regelmäßig versucht, eine Verbindung herzustellen. Dies kann für kleinere Installationen nützlich sein, wenn auf einem Ressourcen-PC beim Start auch ein „Datenbankserver“ ausgeführt wird. In diesem Fall ist die Datenbank möglicherweise nicht sofort beim Start des Ressourcen-PC verbindungsbereit. Zum Beispiel werden bei /dbwait 120 2 Minuten lang Neuversuche unternommen, bevor der Prozess abgebrochen wird.

Mit dem Befehl „/dbwait“ kann eingestellt werden, wie lange der Blue Prism Login Agent Server-Dienst auf eine Verbindung wartet, bevor ein Timeout ausgelöst wird. Das ist nützlich für Situationen, in denen alle Ressourcen gleichzeitig neu gestartet werden. In solchen Fällen wird empfohlen, die Zeit für „/dbwait“ auf 300 (fünf Minuten) einzustellen.

Weitere Informationen finden Sie unter Login Agent Verbindungswiederholungszeit einstellen.

Wird nur zusammen mit dem Schalter /resourcepc verwendet. Das Fenster mit den Informationen zum Ressourcen-PC wird standardmäßig ausgeblendet. Es kann über das Kontextmenü im Benachrichtigungsbereich wieder eingeblendet werden (achten Sie auf folgendes Symbol: ).

Wird nur zusammen mit dem Schalter /resourcepc verwendet. Der Ressourcen-PC lässt sich nur über den lokalen Computer kontrollieren und ist für Remote-Ressourcen nicht verfügbar.

Wird nur zusammen mit dem Schalter /resourcepc verwendet. Gibt den Port an, über den sich Blue Prism als Ressourcen-PC verfügbar macht. Auf diese Weise können Sie mehrere Ressourcen-PCs auf einem einzigen Computer ausführen.

Diese Option kann unter bestimmten Umständen nützlich sein. z. B.:

• Überschreiben des Standard-Ports

  Wenn der Standard-Port 8181 bereits für einen anderen Dienst in Ihrem Netzwerk verwendet wird, können Sie einen anderen angeben. Achten Sie darauf, für alle Ressourcen-PCs in Ihrem Netzwerk denselben Port zu verwenden, außer ein bestimmter Grund spricht dagegen.

• Verwenden von Terminaldiensten

  Bei der Interaktion mit einem Host für Terminaldienste kann Blue Prism nur eine Sitzung pro Ressourcen-PC gleichzeitig ausführen. Dies liegt an einer technischen Einschränkung der Implementierung von Microsoft-Terminaldiensten. Auf einem einzelnen Computer können mehrere Sitzungen normal ausgeführt werden, wenn jeder Ressourcen-PC einen anderen Port verwendet.

Bestimmt den Ziel-Ressourcen-PC für Prozessalarme. Wird nichts anderes angegeben, wird der lokale PC verwendet.

Diese Option ist nicht mit dem Schalter /resourcepc zu verwechseln.

Zur Angabe von Blue Prism Anmeldedaten. Wenn Ihre Datenbank für Single Sign-on eingerichtet ist, sollten Sie stattdessen den Schalter /sso verwenden.

Weist Blue Prism an, den Befehl auf Basis der aktuellen Anmeldedaten eines Benutzers in einer Single Sign-on (SSO)-Konfiguration zu authentifizieren. Wenn Ihre Datenbank nicht für Single Sign-on eingerichtet ist, sollten Sie stattdessen den Schalter /user verwenden.

Übernimmt alle zutreffenden Konfigurationsoptionen von Blue Prism für den gegenwärtig angemeldeten Betriebssystembenutzer. Standardmäßig gilt die Konfiguration für alle Benutzer.

Verwenden Sie diese Parameter zusammen, um eine neue Datenbankverbindung mit demselben Namen wie der angegebene Datenbankname zu erstellen (siehe auch /dbconname), oder um eine ggf. existierende Verbindung zu aktualisieren. Für die empfohlene SQL Server-Authentifizierung müssen alle vier Parameter angegeben werden. Für die Windows Authentifizierung sollten Benutzername und Passwort ausgelassen werden. Diese Verbindung wird auch als aktuelle Verbindung festgelegt. Danach wird Blue Prism beendet.

Verwenden Sie /setdbserver, um die Verbindung einer Verfügbarkeitsgruppe anstatt einer direkten Datenbankverbindung anzugeben. In diesem Fall ist „databaseservername“ der Name des Listeners der Verfügbarkeitsgruppe.

Mit /ag den Port für den Listener der Verfügbarkeitsgruppe angeben. Bei keiner Angabe wird der Standard-Port 1433 verwendet.

Mit /ag verwenden, um anzugeben, dass Multisubnet-Failover aktiviert werden soll.

Erstellt eine neue Blue Prism Serververbindung mit demselben Namen wie der angegebene Host. (Siehe auch /dbconname, /connectionmode and /bpserversecure) Die Verbindung wird zudem als die aktuelle Verbindung festgelegt. Danach wird Blue Prism beendet.

Wird mit den Optionen /setdbserver oder /setbpserver verwendet, um einen anderen Verbindungsnamen als den standardmäßigen anzugeben. Wird keiner dieser Parameter verwendet, gibt die Option den Namen der zu verwendenden Datenbankverbindung an.

Wird mit der Option /setbpserver verwendet, um den Modus für die Verbindung zwischen Client und Blue Prism Server einzustellen. Beachten Sie, dass diese Option mit dem entsprechenden Wert in der Blue Prism Serverkonfiguration übereinstimmen muss.

Der Standardwert ist 0. Verfügbare Verbindungsmodi:

• 0 – WCF: SOAP mit Nachrichtenverschlüsselung und Windows-Authentifizierung
• 1 – WCF: SOAP mit Transportverschlüsselung und Windows-Authentifizierung
• 2 – WCF: SOAP mit Transportverschlüsselung
• 3 – .NET Remoting: Sicher
• 4 – .NET Remoting: Unsicher
• 5 – WCF Unsicher

Wird mit der Option /setbpserver verwendet, um die Sicherheit einer Blue Prism Serververbindung zu deaktivieren. Dies sollte niemals geschehen, außer es wurden alternative Vorkehrungen zur Absicherung der Verbindung getroffen.

Die Option /bpserversecure ist mittlerweile veraltet. Verwenden Sie stattdessen /connectionmode.

Startet die Prozessalarmüberwachung im Hintergrund. Muss zusammen mit dem Schalter /User oder /sso verwendet werden, damit die richtige Prozessalarmkonfiguration eines Benutzers verwendet wird.

Stellt die Priorität der Blue Prism Anwendung auf den angegebenen Modus ein. Wird normal dazu verwendet, die Priorität des Windows-Prozesses von Blue Prism zu kontrollieren, wenn Blue Prism als Ressourcen-PC fungiert. Dies kann nützlich sein, wenn Blue Prism eine höhere Priorität als andere Prozesse auf dem PC erfordert, die andernfalls zu viele CPU-Ressourcen beanspruchen und die Funktion von Blue Prism beeinträchtigen könnten. Gültige Modi:

• below – geringere Priorität als normal
• above – höhere Priorität als normal
• high – hohe Priorität
• realtime – höchstmögliche Priorität

Wird zusammen mit dem Parameter /run verwendet, um Startparameter für eine Sitzung anzugeben.

Der Parameter „Parameter-XML“ sollte gültige Blue Prism XML-Parameter enthalten, umschlossen von Anführungszeichen (""). Da Anführungszeichen beim Standard-Input zum Trennen von Beginn/Ende der XML-Zeichenfolgen von Parametern verwendet werden, empfiehlt Blue Prism das Trennen der XML-Attribute durch einzelne Anführungszeichen (''). Beispiel:

AutomateC /run "Excel Test" /resource YourPCHostName /user admin mypwd /startp "<inputs> <input name='Comment' type='text' value='Hello World' /></inputs>"

Alternativ können Sie zwei Anführungszeichen pro Anführungszeichen in einer Parameter-XML-Zeichenfolge als Escapezeichen verwenden. Zum Beispiel:

AutomateC /run "Excel Test" /resource YourPCHostName /user admin mypwd /startp "<inputs> <input name=""Comment"" type=""text"" value=""Hello World"" /></inputs>"

Benutzer mit Single Sign-on sollten in den obigen Beispielen den Schalter /sso anstelle des Schalters /user verwenden. Zum Beispiel:

AutomateC /run "Excel Test" /resource YourPCHostName /sso /startp "<inputs> <input name=""Comment"" type=""text"" value=""Hello World"" /></inputs>"

Zeigt das Datenbank-Konfigurationsfenster an. Wenn der Benutzer dieses Fenster schließt (über die Schaltfläche „OK“ oder „Abbrechen“), wird die Anwendung beendet.

Zum Ausdrucken einiger Kurztipps zum Standard-Output der Befehlszeile.

Erstellt mit der bereits konfigurierten Datenbankverbindung eine Datenbank (siehe Automate.exe /setdbserver). Das erforderliche Passwort wird als Teil der konfigurierten Datenbankverbindung bereitgestellt.

Der Unterschied zum Schalter /replacedb besteht darin, dass sämtliche bestehenden Datenbanken mit demselben Namen verworfen werden, wohingegen /replacedb die Tabellen in der Datenbank verwirft, die Datenbank selbst bleibt jedoch bestehen.

Erstellt mit der bereits konfigurierten Datenbankverbindung eine Datenbank (siehe Automate.exe /setdbserver). Das erforderliche Passwort wird als Teil der konfigurierten Datenbankverbindung bereitgestellt.

Der Unterschied zum Schalter /createdb besteht darin, dass bei einer bereits vorhandenen gleichnamigen Datenbank lediglich die enthaltenen Tabellen verworfen werden, wohingegen /createdb die gesamte Datenbank verwirft und neu erstellt.

Führt ggf. ein Upgrade einer bestehenden Datenbank durch. Das erforderliche Passwort wird als Teil der konfigurierten Datenbankverbindung bereitgestellt.

Diese Befehle werden unter AutomateC.exe genauso verwendet wie unter Automate.exe. Details zu den einzelnen Befehlen finden Sie weiter oben (/dbconname, /user, /sso, /resource, /port, /startp).

Fügt den Lizenzschlüssel in der angegebenen Datei zur Blue Prism Datenbank hinzu. Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso.

Lizenzen lassen sich auch über den System-Manager in der Client-Anwendung verwalten.

Entfernt den Lizenzschlüssel in der angegebenen Datei aus der Blue Prism Datenbank. Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso.

Lizenzen lassen sich auch über den System-Manager in der Client-Anwendung verwalten.

Registriert ein COM-Geschäftsobjekt zur Verwendung auf dem lokalen Computer. Dies entspricht dem Aufrufen des Bereichs „Externe Geschäftsobjekte“ im System-Manager.

Der Parameter „clsid“ bezieht sich auf die ID der COM-Klasse.

Registriert einen Webdienst zur Nutzung in Blue Prism Prozessen. Dies entspricht dem Registrieren eines Webdiensts über den Assistenten im Bereich „Webdienste“ im System-Manager.

• Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso.
• Kann optional zusammen mit dem Schalter /objectname verwendet werden.
• Optional kann der Schalter /timeout angegeben werden.
• Wenn Anmeldedaten zum Abrufen des WSDL-Dokuments erforderlich sind, kann der Schalter /wsauth verwendet werden.

Die Kennzeichnung <servicename> muss mit dem Namen des Dienstes übereinstimmen, der im WSDL-Dokument des Webdienstes aufgeführt wird (siehe das Glossar zu Webdiensten für weitere Informationen über WSDL-Dokumente). Das ist nötig, weil ein WSDL-Dokument mehrere verschiedene Webdienste beschreiben kann. Der angegebene Name unterscheidet sich von dem, der mit dem Schalter /objectname vergeben wird. Dieser spezifiziert die interne Bezeichnung des Webdiensts in Ihren Blue Prism Prozessen.

Der Parameter <WSDLURL> muss die Adresse (URL) eines WSDL-Dokuments für den betreffenden Webdienst angeben. Dieses wird je nach Fall über http oder https abgerufen.

/unregwebservice <servicename>

Hebt die Registrierung eines Webdienstes auf. Dies entspricht dem Löschen eines Webdienstes über den Assistenten im Bereich „Webdienste“ im System-Manager.

• Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso.

Die Kennzeichnung <servicename> muss mit dem internen Namen des Webdiensts in Ihren Blue Prism Prozessen übereinstimmen.

Wird zusammen mit dem Schalter /regwebservice verwendet, um den Geschäftsobjektnamen anzugeben, den der Webdienst nach der Registrierung erhält.

Wird zusammen mit dem Schalter /regwebservice verwendet, um die Benutzer-Anmeldedaten für die HTTP-Anfrage beim Download des WSDL-Dokuments anzugeben. Dieser Schalter ist nur erforderlich, wenn das WSDL-Dokument vom Hostserver passwortgeschützt ist.

Wird zusammen mit dem Schalter /regwebservice verwendet, um den Timeout-Wert für den Webdienst anzugeben (in Millisekunden). Dabei handelt es sich um den Timeout für das Warten auf eine Antwort vom Webdienst zur Laufzeit. Der Timeout kann später durch Bearbeiten des Webdiensts im System-Manager abgeändert werden.

Optional kann dieser Schalter zusammen mit dem Befehl /regwebservice verwendet werden. Wird er nicht verwendet, gilt der Standardwert von 10.000 Millisekunden.

Erzeugt einen Bericht zu allen Rollen und zugehörigen Berechtigungen für jeden Benutzer im System.

/elementusage <filespec>

Schreibt einen Elementnutzungsbericht in die angegebene CSV-Datei. Mit der Option /process können Sie angeben, zu welchem Geschäftsobjekt ein Bericht erstellt werden soll. Der Bericht enthält Informationen zu der Seite und Phase, in denen die Elemente des Anwendungsmodells genutzt werden.

Importiert einen Blue Prism Prozess (oder ein visuelles Geschäftsobjekt) in die Datenbank. Standardmäßig wird die ID in der Datei verwendet (falls vorhanden, sonst wird einen neue ID erzeugt). Mit /forceid kann dieses Verhalten überschrieben werden.
Der Parameter „Spezifizierte Datei“ bezieht sich auf den Speicherort der zu importierenden Datei.

Standardmäßig schlägt dieser Vorgang fehl, wenn der/das importierte Prozess/Objekt bereits in der ausgewählten Umgebung vorhanden ist. Mit /overwrite lässt sich dies vermeiden.

Importiert eine Blue Prism Releasedatei (.bprelease) oder Blue Prism Fertigkeitsdatei (.bpskill) in die Datenbank. Diese Aktion gleicht dem interaktiven Import über den Blue Prism Client (siehe Release-Registerkarte), außer, dass sie nicht interaktiv ist und Konflikte nach Möglichkeit automatisch gelöst werden. Im Allgemeinen ist die Standardaktion beim Importieren das Überschreiben eines bereits in der Datenbank vorhandenen Elements. Allerdings können Konflikte den nicht interaktiven Import eines Release verhindern. Folgende Tabelle enthält eine Zusammenfassung der Handhabung von Konflikten:

Beim interaktiven Importieren von neuen Anmeldedaten wird der Benutzer zur Eingabe von Benutzername und Passwort aufgefordert (da diese Informationen nicht in die Exportdatei geschrieben werden). Beim nicht interaktiven Importieren werden Benutzername/Passwort nicht angegeben und sie müssen manuell im Blue Prism Client aktualisiert werden.

Der Parameter „Spezifizierte Datei“ bezieht sich auf den Speicherort der zu importierenden .bprelease-Datei.

Exportiert einen Blue Prism Prozess (oder ein visuelles Geschäftsobjekt) aus der Datenbank in das lokale Dateisystem.

Exportiert die aktuelle Version des angegebenen Blue Prism Pakets von der Datenbank in das lokale Dateisystem. Um einen früheren Release eines Pakets zu exportieren, verwenden Sie den optionalen Parameter [/release <releasename>].

Wird mit /import verwendet, um die Verwendung der angegebenen ID für den Prozess zu erzwingen, anstatt die ID aus der importierten Datei zu verwenden.

Durch „new“ wird eine neue ID für das importierte Objekt erzeugt, andernfalls sollte eine gültige GUID angegeben werden.

Standardmäßig schlägt /import fehl, wenn der/das importierte Prozess/Objekt bereits Teil der Datenbank ist.
Durch die Option /overwrite wird eine neue Version des Prozesses/Objekts importiert, die die derzeit bestehende überschreibt.

Wenn bereits ein Prozess/Objekt mit dem Namen des importierten Prozesses/Objekts, aber mit einer anderen ID vorhanden ist, schlägt der Import fehl – /overwrite funktioniert nur, wenn ein Prozess/Objekt mit der gleichen ID gefunden wird. In diesem Fall kann der Importassistent innerhalb des Produkts verwendet werden.

Veröffentlicht den genannten Blue Prism Prozess. Wenn der Name des Prozesses Leerstellen enthält, muss er in Anführungszeichen stehen.

Hebt die Veröffentlichung des genannten Blue Prism Prozesses auf. Wenn der Name des Prozesses Leerstellen enthält, muss er in Anführungszeichen stehen.

Macht das genannte Blue Prism Objekt/den genannten Prozess als Webdienst zur Nutzung durch externe Anwendungen verfügbar. Wenn der Name des Objekts oder Prozesses Leerstellen enthält, muss er in Anführungszeichen stehen.

Wenn der optionale Parameter /forcedoclitencoding verwendet wird, gibt der Webdienst SOAP-Nachrichten zu Zwecken der WS-I Compliance immer in Form eines Dokuments oder Literals wieder.

Ist der Parameter /forcedoclitencoding nicht vorhanden, können Sie die Verwendung eines globalen Namespace erzwingen.

Verbirgt Blue Prism Objekte oder Prozesse, die bisher als Webdienst verfügbar waren. Wenn der Name des Objekts oder Prozesses Leerstellen enthält, muss er in Anführungszeichen stehen.

Stellt das Verschlüsselungsschema ein, das von der angegebenen Warteschlange verwendet wird. Das angegebene Schema muss in dieser Umgebung konfiguriert werden, um erfolgreich verwendet werden zu können. Der standardmäßige Schemaname, der bei der Konfiguration vom Blue Prism Server angegeben wird, wird als Standard-Verschlüsselungsschema bezeichnet.

Um den Verschlüsselungsschlüssel einer Warteschlange zu deaktivieren, verwenden Sie den Schalter /resetencrypt.

Muss in Kombination mit /queuename verwendet werden. Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso.

Setzt das Verschlüsselungsschema der spezifizierten Warteschlange zurück, sodass diese nicht mehr verschlüsselt wird.

Muss in Kombination mit /queuename verwendet werden. Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso.

Diese Option bewirkt eine Neuverschlüsselung aller Anmeldedaten, Bildschirmaufnahmen von Ressourcen oder Warteschlangenelementdaten, die nicht nach dem aktuell ausgewählten Schema verschlüsselt sind. Sie wird häufig verwendet, wenn Sie einen alten Schlüssel rückgängig machen, bevor Sie ein Verschlüsselungsschema löschen. Der Parameter /batchsize kontrolliert, wie oft aktualisierte Datensätze in die Datenbank geschrieben werden (Standardwert ist 1000), und /maxbatches bestimmt, wie viele Batches verarbeitet werden (Standardwert ist 1).

Wenn der Befehl ausgeführt wird:

• Alle Anmeldeinformationen oder Ausnahme-Bildschirmaufnahmen, die derzeit mit einem anderen Schema als dem Standard-Verschlüsselungsschema konfiguriert sind, werden entschlüsselt und dann mit dem Standard-Verschlüsselungsschema erneut verschlüsselt.
• Alle verschlüsselten Arbeitswarteschlangenelemente, die derzeit unter Verwendung eines anderen Schemas als demjenigen verschlüsselt sind, das in der Arbeitswarteschlange konfiguriert ist, werden entschlüsselt und dann mit dem Verschlüsselungsschema, das der Arbeitswarteschlange zugeordnet ist, erneut verschlüsselt.

Basierend auf dem konfigurierten Parameter /batchsize wiederholt sich die Verarbeitung, bis der konfigurierte Wert /maxbatches erreicht ist.

Dies erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso sowie Zugriff auf die Berechtigung Sicherheit – Verschlüsselungsschemata verwalten.

Wendet die gewünschte Verschlüsselungsmethode auf die Blue Prism Serverkonfiguration an. Sie können die standardmäßige Blue Prism Verschlüsselung verwenden oder ein angegebenes Zertifikat installieren. Optionen für diesen Befehl:

• /configencrypt – Zeigt die aktuelle in der Serverkonfiguration verwendete Verschlüsselungsmethode an.
• /configencrypt default – Wendet die standardmäßige Blue Prism Verschlüsselung an. Erfordert die Angabe des Blue Prism Systemadministratorpassworts.
• /configencrypt thumbprint – Ändert die configencrypt-Methode zu eigenem Zertifikat mit spezifiziertem Fingerabdruck. Erfordert die Angabe des Blue Prism Systemadministratorpassworts.
• /configencrypt thumbprint /forceconfigencrypt – Erzwingt die Außerkraftsetzung eines Fehlers. Dadurch könnte eine Warnmeldung angezeigt werden. Erfordert die Angabe des Blue Prism Systemadministratorpassworts.

Zum Beispiel:

Aktuelle Verschlüsselungsmethode anzeigen:

AutomateC /configencrypt /user admin password

Standardmäßige Verschlüsselungsmethode aktivieren:

AutomateC /configencrypt default /user admin password

Verwendung des spezifizierten Zertifikatfingerabdrucks aktivieren:

AutomateC /configencrypt bc6269e89048cbf5553601cc0314b291609d9f3 /user admin password

Erstellt eine Arbeitswarteschlange mit den Werten Schlüsselfeld, Ausführen und Max. Versuche, wie es beim manuellen Erstellen einer Warteschlange im System-Manager erforderlich wäre.

Muss in Kombination mit /queuename verwendet werden. Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso.

Exportiert Daten aus einer Arbeitswarteschlange und speichert sie im von <filespec> angegebenen Ordner. Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso. Muss in Kombination mit /queuename verwendet werden. Kann zusammen mit /queuefilter und /clearexported verwendet werden.
Beachten Sie, dass /exportqueue die Angabe von Benutzer-Anmeldedaten über den Schalter /user oder /sso und den Zugriff auf eine der folgenden Berechtigungen erfordert: Vollständiger Zugriff auf Warteschlangenmanagement, Lesezugriff auf Warteschlangenmanagement

Löscht bearbeitete Fälle (d. h. als abgeschlossen oder Ausnahme markierte Fälle) aus einer Arbeitswarteschlange. Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso. Muss in Kombination mit /queuename verwendet werden.
Bei Verwendung des Schalters /age werden nur bearbeitete Elemente aus der Warteschlange gelöscht, die das angegebene Alter überschritten haben. Andernfalls werden alle verarbeiteten Elemente aus der genannten Warteschlange gelöscht.

Stattdessen können Sie die Befehle /exportqueue und /clearexported zusammen verwenden, um einen Datensatz der im Prozess gelöschten Elemente zu erzeugen – dieser Befehl erstellt keinen derartigen Datensatz.

Wird zusammen mit /queueclearworked verwendet und löscht alle bearbeiteten Elemente, die das angegebene Alter überschreiten (einschließlich Elemente, die vor dieser Zeit als Ausnahme markiert wurden).
Wird zusammen mit /archive und /restorearchive verwendet, umgeht die Datumsbereich-basierte Auswahl und wählt Sitzungen aus, die ein bestimmtes Alter überschreiten. Der Wert ist eine Zahl gefolgt von „y“ (Jahre), „m“ (Monate), „w“ (Wochen) oder „d“ (Tage). Zum Beispiel legt „6m“ fest, dass Logs archiviert werden, die älter als 6 Monate sind.

Gibt bei Verwendung zusammen mit einem auf Warteschlangen bezogenen Befehl wie /exportqueue oder /createqueue den Namen der Warteschlange an.

Gibt beim Export einer Warteschlange mit /exportqueue den Namen eines Filters an. Das ist der Name eines Filters, der im Bereich „Warteschlangenmanagement“ des Control Room erstellt wurde.

Zusammen mit /exportqueue löscht dieser Befehl die bearbeiteten und zugeteilten exportierten Elemente.
Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso sowie Zugriff auf die Berechtigung Vollständiger Zugriff auf Warteschlangenmanagement.

Erstellt einen Ressourcenpool mit dem angegebenen Namen.

Löscht den angegebenen Ressourcenpool.

Fügt eine Ressource zum angegebenen Pool hinzu.
Wenn kein Ressourcenname angegeben wird, wird die lokale Ressource zum Pool hinzugefügt.

Entfernt eine Ressource aus ihrem Pool.
Wenn kein Ressourcenname angegeben wird, wird die lokale Ressource aus ihrem Pool entfernt.

Gibt den oder die Namen von Zeitplänen für die Verwendung mit den Aktionen /startschedule, /deleteschedule, /viewschedtimetable und /viewschedreport an.

Parameter nach dem Schalter /schedule werden als Zeitplannamen behandelt, bis ein anderer Schalter beginnt (d. h. ein Parameter, der mit einem „/“ beginnt) oder das Ende des Befehls erreicht wird.
Wenn keine Zeitpläne angegeben werden, werden die Befehle allgemein als für alle Zeitpläne gültig betrachtet.

Startet den angegebenen Zeitplan zur gegenwärtigen Zeit. Wenn der Zeitplaner ausgeführt wird, sollte er den Zeitplan innerhalb von 30 Sekunden ausführen.

Wenn der angegebene Zeitplan noch nie ausgeführt wurde, werden der Zeitplan und alle zugehörigen Logs gelöscht. Wenn der angegebene Zeitplan schon einmal ausgeführt wurde, wird der Zeitplan als gelöscht markiert, aber alle vorhandenen Logs werden beibehalten.

Gibt das Output-Format des Zeitplanberichts oder der Zeittabelle an, entweder „txt“ (visuell lesbar) oder „csv“ (durch Kommas getrennte Variablen). Die Standardeinstellung ist „txt“, wenn kein Format angegeben wird.

Gibt die angegebene Zeittabelle aus.
Sie können eine benannte Zeittabelle angeben, die im Blue Prism Client erstellt und konfiguriert wurde.
Alternativ können Sie eine Ad-hoc-Zeittabelle spezifizieren, indem Sie angeben, ab welchem Datum sie ausgeführt werden soll, wie viele Tage anzuzeigen sind und in welchem Format sie heruntergeladen werden soll.

Gibt den spezifizierten Bericht aus.
Sie können einen benannten Bericht angeben, der im Blue Prism Client erstellt und konfiguriert wurde.
Alternativ können Sie einen Ad-hoc-Bericht spezifizieren, indem Sie angeben, bis zu welchem Datum der Bericht ausgeführt werden soll, wie viele Tage in der Vergangenheit anzuzeigen sind und in welchem Format er heruntergeladen werden soll.

Archiviert Sitzungslogs in Dateien. Siehe Archivieren für weitere Informationen. Ohne Einstellungen werden alle Sitzungslogs archiviert. Um nur bestimmte Logs zu archivieren, verwenden Sie die Option /age oder eine Kombination aus /from und /to. Mit /process können Sie die Archivierung in Logs für einen bestimmten Prozess einschränken.

Um Sitzungslogs zu löschen, ohne sie zu exportieren, verwenden Sie die Option /delete.

Zum Wiederherstellen von Sitzungslogs aus Dateien in die Datenbank. Siehe Archivieren für weitere Informationen. Ohne Einstellungen werden alle Sitzungslogs wiederhergestellt. Um nur bestimmte Logs zu archivieren, verwenden Sie die Option /age oder eine Kombination aus /from und /to.

Zum Einstellen des Archivierungspfads. Dieser Pfad wird von den Befehlen /archive und /restorearchive sowie im System-Manager verwendet.

Wird zusammen mit /archive und /restorearchive verwendet, um den inklusiven Beginn eines Datumsbereichs anzugeben.

Wird zusammen mit /archive und /restorearchive verwendet, um das nicht inklusive Ende eines Datumsbereichs anzugeben.

Wird zusammen mit /queueclearworked verwendet und löscht alle bearbeiteten Elemente, die das angegebene Alter überschreiten (einschließlich Elemente, die vor dieser Zeit als Ausnahme markiert wurden).
Wird zusammen mit /archive und /restorearchive verwendet, umgeht die Datumsbereich-basierte Auswahl und wählt Sitzungen aus, die ein bestimmtes Alter überschreiten. Der Wert ist eine Zahl gefolgt von „y“ (Jahre), „m“ (Monate), „w“ (Wochen) oder „d“ (Tage). Zum Beispiel legt „6m“ fest, dass Logs archiviert werden, die älter als 6 Monate sind.

Wird zusammen mit /archive verwendet und beschränkt die Archivierung auf Sitzungen, in denen der genannte Prozess ausgeführt wurde. Bei der Verwendung mit /elementusage wird ein Prozess zur Berichterstellung ausgewählt.

Wird zusammen mit /archive verwendet, um die Logs zu löschen, ohne sie vorher zu exportieren.

Ordnet Benutzern zwischen Blue Prism und Authentication Server zu. Die Berechtigung Authentication Server – Benutzer zuordnen ist erforderlich.

Input-CSV-Pfad – Der Pfad zu einer CSV-Datei, die Details der Benutzer enthält, die zugeordnet werden sollen. Lesezugriff durch AutomateC erforderlich.

Output-CSV-Pfad – Der Pfad zu einer CSV-Datei, in die Benutzer geschrieben werden, die nicht zugeordnet werden konnten. Lese- und Schreibzugriff durch AutomateC erforderlich.

Erstellt eine CSV-Datei, die eine Liste aller Authentication Server Benutzer enthält, die Blue Prism Benutzern zugeordnet werden können.

Erstellt eine CSV-Datei, die eine Liste aller nativen Blue Prism Benutzer in der Datenbank enthält, die Authentication Server Benutzern zugeordnet werden können.

Ruft den Status einer laufenden Sitzung ab. Die Sitzungs-ID ist eine eindeutige Kennzeichnung im Format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso.

Meldet Sitzungen für einen angegebenen Ressourcennamen. Die Ergebnisse lassen sich zeitlich einschränken. Um alle Ressourcen aufzulisten, geben Sie als Ressourcennamen [Alle] an.

Sie können auch einen Wert und einen Typ für das Limit angeben (m = Minuten, h = Stunden, d = Tage, mm = Monate), um die gelieferten Ergebnisse einzuschränken. Zum Beispiel liefert /resourcestatus ABC:8181 1 d alle Sitzungen für die genannte Ressource, die am vergangenen Tag gestartet wurden.

Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user.

Erstellt oder aktualisiert die BP-Serverkonfiguration mit dem angegebenen Namen. Dabei werden Name und Überwachungsport der Datenbankverbindung anhand der angegebenen Werte eingestellt.

Mit dem optionalen Schalter /connectionmode kann der Verbindungsmodus eingestellt werden.

Wenn keine Verschlüsselungsschemata für die BP-Serverkonfiguration festgelegt wurden, wird ein neuer Datensatz für das Verschlüsselungsschema erstellt. Standardmäßig wird das Schema Standard-Verschlüsselungsschema genannt und für die Verschlüsselung mit AES 256 (AESCryptoService) und einem zufällig erzeugten Schlüssel konfiguriert. Alternativ können Sie die zu verwendeten Einstellungen mit dem Schalter /encryptionscheme definieren.

Dieser optionale Schalter wird zusammen mit /serverconfig verwendet, um die bei der Erstellung eines Verschlüsselungsschemas zu verwendenden Einstellungen zu definieren.

<name> definiert den Namen des Verschlüsselungsschemas.

<encryptionmethod> (optional) definiert den zu verwendenden Verschlüsselungsalgorithmus.

• 1 = Triple DES (192 Bit)
• 2 = AES-256 RijndaelManaged (256 Bit)
• 3 = AES-256 AesCryptoService (256 Bit) – Standard

Triple DES (192 Bit) wird zur Abwärtskompatibilität bereitgestellt. Es wird dringend davon abgeraten, neue Verschlüsselungsschemata mit dieser Methode zu konfigurieren.

Dieser optionale Schalter wird in Verbindung mit dem Schalter /serverconfig verwendet und ermöglicht es Benutzern, die Client-ID und den geheimen Schlüssel für das Dienstkonto anzugeben, mit dem Blue Prism mit Authentication Server kommunizieren kann. Dies kann als Teil einer skriptbasierten Installation und Konfiguration von Blue Prism zur Integration mit Authentication Server verwendet werden. Wenn diese Parameter mit einer vorhandenen Serverkonfiguration verwendet werden, werden alle vorhandenen Anmeldedaten durch die neu eingegebenen Werte überschrieben.

Dies ist nur ab Blue Prism Version 7.1.2 verfügbar.

Konfiguriert die ASCR-Einstellungen (Application Server Controlled Resources) mit den folgenden Befehlen:

AutomateC/ascrconfig <servername> <conntype> [1 – grpc | 2 – wcf] <hostname> <port> <outbound port (wcf only)> <connectionmode> [1 – Zertifikat | 2 – Windows (nur wcf) | 3 – unsicher] <certificatename> <clientcertificatename> <ascrservercertstore> <ascrclientcertstore> [/loadbalancername <string>]

<conntype> akzeptiert die folgenden Werte:

• 1 – grpc
• 2 – wcf

<port> <outbound port (wcf only)>Akzeptiert den Wert des ausgehenden Ports nur bei Verwendung von WCF. Der Standardwert ist 80.

<connectionmode> akzeptiert die folgenden Werte:

• 1 – Zertifikat
• 2 – Windows
• 3 – unsicher

Die Zertifikatoptionen sind nur erforderlich, wenn <connectionmode> Zertifikate angibt.

/loadbalancername <string> Dieser Befehl ist optional. Wenn ein Load Balancer verwendet wird, sollte der Name in <string> eingegeben werden.

Weitere Informationen finden Sie unter ASCR-Konfiguration.

Erstellt neue Anmeldedaten mit dem angegebenen Namen, Passwort und Benutzernamen.
Sind Benutzername und Passwort nicht erforderlich, können sie durch "" repräsentiert werden.
Wird nichts angegeben, werden Anmeldedaten vom Typ „Allgemein“ erstellt.
Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso sowie Zugriff auf die Berechtigung „Sicherheit – Anmeldedaten verwalten“.
Die erstellten Anmeldedaten sind standardmäßig universell für alle Benutzerrollen, Ressourcen und Prozesse verfügbar.

Aktualisiert bestehende Anmeldedaten, die anhand des angegebenen Namens gefunden werden.
Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso sowie Zugriff auf die Berechtigung „Sicherheit – Anmeldedaten verwalten“.

Wird mit /updatecredential zum Aktualisieren des Passworts der Anmeldedaten verwendet.

Wird mit /updatecredential zum Aktualisieren des Benutzernamens der Anmeldedaten verwendet.

Wird mit /updatecredential oder /createcredential zum Festlegen der Textbeschreibung der Anmeldedaten verwendet.

Wird zusammen mit /updatecredential oder /createcredential verwendet, um das Ablaufdatum für die Anmeldedaten festzulegen. Das Datumsformat muss JJJJMMTT sein.

Wird mit /updatecredential oder /createcredential verwendet, um zu spezifizieren, ob Anmeldedaten als ungültig markiert werden.

Wird mit /updatecredential oder /createcredential verwendet, um den Typ der Anmeldedaten zu spezifizieren. Muss ein unterstützter Wert sein.

Erstellt eine neue Anmeldedateneigenschaft oder aktualisiert diese, wenn sie bereits existiert.

Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso sowie Zugriff auf die Berechtigung „Sicherheit – Anmeldedaten verwalten“.

Zwingt das Microsoft Negotiate Security Package dazu, bei der Authentifizierung der Blue Prism Serververbindung „New Technology LAN Manager (NTLM)“ als Security Support Provider (SSP) für die zuletzt verwendete oder angegebene Verbindung (mit dem Switch /dbconname) auszuwählen. Diese Option wird bereitgestellt, damit NTLM verwendet werden kann, wenn Kerberos nicht verfügbar oder nicht konfiguriert ist (siehe SPN-Konfiguration). Beispiel: /forcentlm true

Muss für jede Blue Prism Serververbindung im interaktiven Client konfiguriert werden, bei der sich der Kerberos-Bereich des Benutzers von dem des Kontos unterscheidet, das für die Ausführung vom Blue Prism Server konfiguriert ist. Zum Beispiel /setkerberosrealm meinunternehmen.de

Der Kerberos-Bereich ist in der Regel derselbe wie der Domain-Name. Bitte erkundigen Sie sich jedoch bei Ihrem IT-Team nach dem richtigen Wert. Dabei sollte es sich um den Bereich des Dienstkontos handeln, dass den Blue Prism Server Dienst ausführt. In einigen Umgebungen kann es erforderlich sein, dieselbe Konfiguration anzuwenden, in der das Dienstkonto in einer anderen Domain innerhalb derselben Gesamtstruktur vorhanden ist.

Diese Standardfunktion für SQL Abfragen, die vom Produkt ausgeführt werden, legt ein Zeitlimit für die Ausführung eines Befehls und die Rückgabe von Ergebnissen fest, bevor ein Timeout ausgelöst wird; standardmäßig auf 60 Sekunden festgelegt.

Legt ein Zeitlimit für die Ausführung eines Befehls und die Rückgabe von Ergebnissen fest, bevor ein Timeout ausgelöst wird. Betrifft SQL Abfragen, bei denen die Rückgabe von Ergebnissen typischerweise am längsten dauert, z. B. Abfragen, die mit Arbeitswarteschlangen interagieren; standardmäßig auf 600 Sekunden festgelegt.

Legt ein Zeitlimit für die Ausführung eines Befehls und die Rückgabe von Ergebnissen fest, bevor ein Timeout ausgelöst wird. Betrifft Logs, die typischerweise mehr Zeit benötigen; standardmäßig auf 0 (unendlich) festgelegt.

Diese Befehle bewirken eine systemweite Änderung, die nicht rückgängig gemacht werden kann, und sollten nur auf Empfehlung des Blue Prism Supportteams verwendet werden.

Löst eine Aktualisierung der im Active Directory-Cache gespeicherten Daten aus, der ausgefüllt wurde, wenn:

• Eine direkte Verbindung zur Datenbank hergestellt wurde.
• Ein Blue Prism Anwendungsserver gestartet wurde.

• Active Directory-Authentifizierung unter „System“ > „Sicherheit – Anmeldungseinstellungen“ aktiviert wurde.

Dies ist nur ab Blue Prism Version 7.1.2 verfügbar.

Setzt das Standardkennwort für den Administratorbenutzer zurück.

Der Befehl kann nur angewendet werden, wenn die Standardanmeldedaten für Administratorbenutzer konfiguriert wurden und das Passwort abgelaufen ist.

Aktiviert/deaktiviert die Active Directory-Authentifizierung. Geben Sie true" zum Aktivieren ein, oder false zum Deaktivieren.

Dem Administratorbenutzer muss die Rolle System-Manager und die zugehörige Berechtigung Sicherheit – Anmeldungseinstellungen zugewiesen werden.

Der Computer des Benutzers muss Mitglied einer Active Directory-Domäne sein. Active Directory-Authentifizierung kann nicht deaktiviert werden, wenn sich Active Directory-Benutzer im System befinden.

Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso.

Aktiviert und deaktiviert die Möglichkeit, die Rollenmitgliedschaft in Active Directory zu verwalten, wenn Blue Prism Rollen Active Directory-Sicherheitsgruppen zugewiesen sind.Geben Sie true zum Aktivieren ein, oder false zum Deaktivieren.

Dem Administratorbenutzer muss die Rolle System-Manager und die zugehörige BerechtigungSicherheit – Anmeldungseinstellungen zugewiesen werden.

Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso.

Zum Ausführen eines Prozesses über die Befehlszeile. Der Prozessname-Parameter muss in Anführungszeichen stehen, wenn er ein Leerzeichen enthält. Der genannte Prozess muss veröffentlicht sein, um ausgeführt werden zu können (siehe /publish). Eingabeparameter können mit dem Parameter /startp angegeben werden.

Zum Ausführen eines Prozesses sind Benutzeranmeldedaten erforderlich – siehe /user und /sso, zum Beispiel:

AutomateC.exe /run Process1 /user admin pwd

oder

AutomateC.exe /run Process1 /sso

Sendet eine „Stoppanfrage“ an die genannte Sitzung und setzt eine Flag, die der laufende Prozess mit der Funktion IsStopRequested() in der Entscheidungsphase überprüfen kann.

Entweder die Sitzungs-ID (eine GUID) oder die Sitzungsnummer (eine Zahl) muss angegeben werden, um die Sitzung zu kennzeichnen, die eine Flag für die Stoppanfrage erhalten soll.

Beachten Sie, dass diese Aktion nur von einem authentifizierten Benutzer (bereitgestellt über die Schalter /user oder /sso) mit der Berechtigung Vollständiger Zugriff auf das Sitzungsmanagement ausgeführt werden kann.

Erzwingt die Berechtigungen des kontrollierenden Benutzers für die Erstellung, den Start und die Löschung von Sitzungen.

Fordert eine Aktualisierung des Repository der Objekt-/Prozessabhängigkeiten an, wenn es von einem Blue Prism Upgrade als veraltet markiert wurde. Wird dabei „force“ angegeben, wird das Repository ungeachtet seines gegenwärtigen Status aktualisiert.

Ruft das Log der angegebenen Sitzung ab. Die Sitzungs-ID ist eine eindeutige Kennzeichnung im Format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Erfordert die Bereitstellung von Benutzer-Anmeldedaten über den Schalter /user oder /sso.

Das Log wird Zeile für Zeile in den Standard-Output geschrieben. Es können maximal 2³² -1 Zeilen geschrieben werden. In der Praxis ist dieses Limit jedoch nicht von Belang, da es Hunderten Gigabyte an Daten entspricht.

Gibt eine Liste von Prozessen und Geschäftsobjekten aus.