Vordefinierte Kommandozeilenoperationen
- Aktualisiert2026-06-12
- 8 Minute(n) Lesezeit
LabVIEW verfügt über vordefinierte Kommandozeilenoperationen, um Tasks wie das Kompilieren von Dateien, das Erstellen von Anwendungen und das Ausführen von VIs zu automatisieren.
| Befehl | Beschreibung |
|---|---|
| MassCompile | Führt eine Massenkompilierung der Dateien im angegebenen Verzeichnis aus. |
| ExecuteBuildSpec | Erstellt mit Hilfe der Einstellungen in den angegebenen Build-Spezifikationen eine Anwendung oder eine Bibliothek und gibt den Pfad der Ausgabedateien aus. |
| RunVI | Führt ein VI mit der vordefinierten Anschlussfeld-Schnittstelle aus und gibt die Ausgabewerte des VIs oder (im Fehlerfall) Angaben zu Fehlern aus. |
| CloseLabVIEW | Schließt LabVIEW ohne Eingabeaufforderungen. |
| CreateComparisonReport | Erzeugt ein VI-Vergleichsprotokoll für zwei angegebene VIs. |
| RunVIAnalyzer | Für das VI Analyzer Toolkit. Führt die angegebene VI-Analyse-Aufgabe im LabVIEW VI Analyzer Toolkit aus und speichert das Testprotokoll am angegebenen Speicherort. |
| RunUnitTests | Für Unit Test Framework Toolkit. Führt Tests für die angegebenen Dateien im Unit Test Framework Toolkit durch und speichert die JUnit-Datei am angegebenen Speicherort. |
Außerdem können Sie für die Ausführung in LabVIEW benutzerdefinierte Kommandozeilenoperationen erstellen.
MassCompile
Führt eine Massenkompilierung der Dateien im angegebenen Verzeichnis aus.
In Tabelle 25. Massenkompilierungsargumente werden die verfügbaren Argumente für diese Operation aufgelistet.
| Argument | Erforderlich oder optional | Beschreibung | Standard |
|---|---|---|---|
| -DirectoryToCompile | Erforderlich | Speicherort der zu kompilierenden VIs. | — |
| -Massenkompilierungsprotokolldatei | Optional | Dateipfad zu den Protokollierungsergebnissen. | Pfad zum temporären Speicherort. |
| -AppendToMassCompileLog | Optional | Ein boolescher Wert, mit dem festgelegt wird, ob die Ergebnisse zur Protokolldatei hinzugefügt werden sollen. | false: Wenn die Protokolldatei bereits vorhanden ist, überschreibt LabVIEW die Originaldatei. |
| -NumOfVIsToCache | Optional | Anzahl der VIs, die sich während der Massenkompilierung im Speicher befinden dürfen. Hinweis Das Zwischenspeichern von VIs kann die Ausführungsdauer einer Massenkompilierung signifikant verringern, da LabVIEW zwischengespeicherte VIs bei der Kompilierung eines Haupt-VIs nicht laden muss. Für das Zwischenspeichern von VIs wird allerdings auch mehr Speicherplatz benötigt. Wenn Sie eine Massenkompilierung an einem Ordner durchführen, der VIs mit dem gleichen Namen in verschiedenen Unterordnern enthält und die VIs nicht zu einer Bibliotheken gehören, kann das Speichern des VIs im Cache zu Cross-Linking führen. |
0 |
| -ReloadLVSBs | Optional | Ein boolescher Wert, mit dem festgelegt wird, ob CINs (Code-Interface-Knoten) in VIs ignoriert werden und ob die Anwendung nach diesen suchen kann. Dieses Argument ist nützlich, wenn eine große Anzahl von CINs erneut kompiliert wurde und erneut geladen werden muss. |
false |
Zum Aufrufen von MassCompile in der LabVIEW-CLI geben Sie einen Befehl mit Hilfe der folgenden Syntax ein:
LabVIEWCLI -OperationName MassCompile -DirectoryToCompile <directory of file(s)> -MassCompileLogFile <path to log file> -AppendToMassCompileLog <true or false> -NumOfVIsToCache <number of VIs to cache> -ReloadLVSBs <true or false>
Beispiel:
LabVIEWCLI -OperationName MassCompile -DirectoryToCompile "C:\temp" -MassCompileLogFile "C:\temp\log.txt" -AppendToMassCompileLog true -NumOfVIsToCache 0 -ReloadLVSBs false
ExecuteBuildSpec
Erstellt mit Hilfe der Einstellungen in den angegebenen Build-Spezifikationen eine Anwendung oder eine Bibliothek und gibt den Pfad der Ausgabedateien aus.
In Tabelle 26. Argumente ExecuteBuildSpec werden die verfügbaren Argumente für diese Operation aufgelistet.
| Argument | Erforderlich oder optional | Beschreibung | Standard |
|---|---|---|---|
| -Projektpfad | Erforderlich | Pfad zur LabVIEW-Projektdatei (*.lvproj), in der sich die Build-Spezifikation befindet. | — |
| -Zielname | Optional | Zielsystem, auf dem sich die Build-Spezifikation befindet. | Mein Computer |
| -BuildSpecName | Optional | Name der Build-Spezifikation, die unter Build-Spezifikationen im Projekt-Explorer angezeigt wird. | Leerer String: Die LabVIEW-CLI erstellt alle Build-Spezifikationen unter dem angegebenen Zielsystem. |
| -BuildVerzeichnis | Optional | Pfad zum Verzeichnis, in dem sich die Build-Ausgabedateien befinden. Wenn angegeben, wird die Build-Ausgabe an diesen Speicherort und nicht an das in der Build-Spezifikation definierte Ziel geleitet. Es müssen sowohl -TargetName als auch -BuildSpecName angegeben werden. | Der in der Build-Spezifikation definierte Zielpfad. |
Zum Aufrufen dieser Operation mit Hilfe der LabVIEW-CLI geben Sie einen Befehl mit Hilfe der folgenden Syntax ein:
LabVIEWCLI -OperationName ExecuteBuildSpec -ProjectPath <path to project> -TargetName <name of target> -BuildSpecName <name of build specification> -BuildDirectory <path to output directory>
Beispiel:
LabVIEWCLI -OperationName ExecuteBuildSpec -ProjectPath "C:\temp\test.lvproj" -TargetName "My Computer" -BuildSpecName "My DLL" -BuildDirectory "C:\builds\output"
- Das Argument -BuildDirectory ändert Ihre Build-Spezifikation nicht dauerhaft, wenn Sie das Build-Ziel für Ihre Anwendung oder Bibliothek ändern.
- Zur Verwendung von -BuildDirectory müssen Sie sowohl -TargetName als auch -BuildSpecName angeben. Wenn eines der Argumente fehlt, gibt die LabVIEWCLI einen Fehler aus.
- Das Argument -BuildDirectory überschreibt nur die Pfade Zielverzeichnis und Unterstützungsverzeichnis. Die Verwendung von -BuildDirectory hat keinen Einfluss auf benutzerdefinierte Verzeichnisse, die in der Build-Spezifikation definiert sind.
- Das Argument -BuildDirectory gilt für Build-Spezifikationen für Anwendungen (EXE), DLLs, Quellcodepakete, .NET-Interop-Assemblys, komprimierte Projektbibliothek, ZIP, Installationsprogramme und Pakete (NIPKG/IPK).
- Das Argument -BuildDirectory unterstützt keine FPGA-Build-Spezifikationen.
RunVI
Führt ein VI mit der vordefinierten Anschlussfeldschnittstelle aus und gibt Ausgabewerte oder Fehlerinformationen aus.
| Anschluss | Datentyp | Beschreibung |
|---|---|---|
|
|
String-Bedienelement
|
Kommandozeilenargumente für das VI. |
|
|
Vorzeichenbehaftetes 32-Bit-Anzeigeelement
|
Exit-Code der LabVIEW-CLI, den das VI ausgibt. |
|
|
String-Anzeigeelement
|
Ausgaben oder Fehlerinformationen, die in der LabVIEW CLI-Konsole oder der Protokolldatei enthalten sein sollen. |
In Tabelle 27. RunVI-Argumente werden die verfügbaren Argumente für diese Operation aufgelistet.
| Argument | Erforderlich oder optional | Beschreibung | Standard |
|---|---|---|---|
| -VIPfad | Erforderlich | Pfad zum VI, das in LabVIEW ausgeführt werden soll. Wenn das Anschlussfenster des VIs nicht mit der vordefinierten Schnittstelle übereinstimmt, gibt die LabVIEW-CLI einen Fehler aus. | — |
| <Kommandozeilenargumente für das VI> | Optional | Elemente des Eingangs-Arrays des VIs. Verwenden Sie Leerzeichen, um Elemente zu trennen. | — |
Zum Aufrufen dieser Operation mit Hilfe der LabVIEW-CLI geben Sie einen Befehl mit Hilfe der folgenden Syntax ein:
LabVIEWCLI -OperationName RunVI -VIPath <VI path> <first element of array> <second element of array>...
Beispiel:
LabVIEWCLI -OperationName RunVI -VIPath "C:\Users\inlabview.APAC\Documents\DemoProject\RunVI.vi" 101 202
CloseLabVIEW
Schließt LabVIEW ohne Eingabeaufforderungen.
Diese Operation hat keine Argumente.
Zum Aufrufen dieser Operationen in der LabVIEW-CLI geben Sie den folgenden Befehl ein:
LabVIEWCLI -OperationName CloseLabVIEW
CreateComparisonReport
Vergleicht zwei angegebene VIs und gibt ein HTML-, XML-, Word- oder Textprotokoll mit den Ergebnissen des Vergleichsvorgangs aus.
| Argument | Erforderlich oder optional | Beschreibung | Standard |
|---|---|---|---|
| -vi1 | Erforderlich | Name oder Pfad des ersten VI, das verglichen werden soll. | — |
| -vi2 | Erforderlich | Name oder Pfad des zweiten VI, das verglichen werden soll. | — |
| -reportTyp | Optional | Gewünschter Dateityp des Ausgabeprotokolls. Dieses Argument unterstützt die folgenden Werte:
Wenn dieses Argument nicht angegeben ist, wird es aus dem für -reportPath angegebenen Wert abgeleitet. |
HTMLSingleFile |
| -reportPfad | Erforderlich | Name oder Pfad des Ausgabeprotokolls. | — |
| -o | Optional | Überschreibt vorhandene Protokolle und Hilfsdateien im angegebenen Protokollverzeichnis, sofern vorhanden. | — |
| -c | Optional | Erstellt ein neues Verzeichnis für den angegebenen Protokollpfad, wenn dieser nicht vorhanden ist. | — |
| -nofp | Optional | Schließt Unterschiede auf dem Frontpanel vom Vergleichsprotokoll aus. | — |
| -nofppos | Optional | Schließt Positionsunterschiede auf dem Frontpanel vom Vergleichsprotokoll aus. | — |
| -nobd | Optional | Schließt Unterschiede im Blockdiagramm vom Vergleichsprotokoll aus. | — |
| -nobdcosm | Optional | Schließt Unterschiede im Blockdiagrammdesign aus dem Vergleichsprotokoll aus. | — |
| -noattr | Optional | Schließt Unterschiede in VI-Attributen vom Vergleichsprotokoll aus. | — |
| -d | Optional | Vergleicht die angegebenen VIs ohne Einbeziehung von Abhängigkeiten. | — |
Sie können beliebige VIs für vi1 und vi2 auswählen. vi1 ist nicht zwingend die Basisdatei und vi2 ist nicht zwingend eine Modifikation der Basisdatei. Im Rahmen des Vergleichsberichts:
- vi1 ist das VI, das Sie für den Anfangszustand (aus dem Zustand in vi1) zuweisen
- vi2 ist das VI, das Sie für den Endzustand (zum Zustand in vi2) zuweisen
Zum Aufrufen dieser Operation mit Hilfe der LabVIEW-CLI geben Sie einen Befehl mit Hilfe der folgenden Syntax ein:
LabVIEWCLI -OperationName CreateComparisonReport -vi1 <name or path of first VI> -vi2 <name or path of second VI> -reportType <file type of report> -reportPath <name or path of output report>
Beispiel:
LabVIEWCLI -OperationName CreateComparisonReport -vi1 "firstVI.vi" -vi2 "secondVI.vi" -reportType "HTMLSingleFile" -reportPath "report.html"
RunVIAnalyzer
Führt die angegebene VI-Analyse-Aufgabe im LabVIEW VI Analyzer Toolkit aus und speichert das Testprotokoll am angegebenen Speicherort.
In Tabelle 29. Argumente für RunVIAnalyzer werden die verfügbaren Argumente für diese Operation aufgelistet.
| Argument | Erforderlich oder optional | Beschreibung | Standard |
|---|---|---|---|
| -KonfigPfad | Erforderlich | Pfad zur Konfigurationsdatei, die Einstellungen für die VI-Analyse-Aufgabe enthält. Sie können eine Konfigurationsdatei verwenden, die Sie über das VI-Analyseprogramm oder die VI-Analyse-VIs gespeichert haben. Alternativ können Sie ein VI, einen Ordner oder eine LLB zum Analysieren angeben. Wenn Sie ein anderes Element als eine Konfigurationsdatei angeben, führt das VI alle Tests des VI-Analyseprogramms für das angegebene Element aus. | — |
| -Protokollpfad | Erforderlich | Pfad zur Datei mit den Ergebnissen. | — |
| -ConfigPassword | Optional | Passwort der Konfigurationsdatei, falls vorhanden. | Leerer String |
| -ReportSaveType | Optional | Format der Protokoll- oder Ergebnis-Datei. Der Wert für dieses Argument muss einer der folgenden Werte sein:
|
ASCII |
| -ResultsPath | Erforderlich | Pfad zur Datei mit den Ergebnissen. Wenn der Pfad ein leerer String ist, ignoriert LabVIEW dieses Argument. Hinweis Bei diesem Argument sind Groß- und Kleinschreibung zu beachten.
|
— |
Zum Aufrufen dieser Operation mit Hilfe der LabVIEW-CLI geben Sie einen Befehl mit Hilfe der folgenden Syntax ein:
LabVIEWCLI -OperationName RunVIAnalyzer -ConfigPath <path to configuration file> -ReportPath <path to report> -ReportSaveType <file type of report> -ConfigPassword <password of configuration file>
Beispiel:
LabVIEWCLI -OperationName RunVIAnalyzer -ConfigPath "C:\temp\test.viancfg" -ReportPath "C:\temp\output.html" -ReportSaveType "HTML" -ConfigPassword "abc"
RunUnitTests
Führt Tests für die angegebenen Dateien im Unit Test Framework Toolkit durch und speichert die JUnit-Datei am angegebenen Speicherort.
In Tabelle 30. Argumente für RunUnitTests werden die verfügbaren Argumente für diese Operation aufgelistet.
| Argument | Erforderlich oder optional | Beschreibung | Standard |
|---|---|---|---|
| -Projektpfad | Erforderlich | Pfad zu der Projektdatei. | — |
| -JUnitReportPath | Erforderlich | Pfad zur ausgegebenen JUnit-Datei. | — |
Zum Aufrufen dieser Operation mit Hilfe der LabVIEW-CLI geben Sie einen Befehl mit Hilfe der folgenden Syntax ein:
LabVIEWCLI -OperationName RunUnitTests -ProjectPath <path to project file> -JUnitReportPath <path to output JUnit file>
LabVIEWCLI -OperationName RunUnitTests -ProjectPath "C:\temp\test.lvproj" -JUnitReportPath "C:\temp\test.xml"
Verwandte Inhalte
- Vergleichen von VIs mit Hilfe der LabVIEW-Kommandozeilenschnittstelle
Mit Hilfe der LabVIEW-Kommandozeilenschnittstelle (CLI) können Sie zwei VIs programmatisch vergleichen und ein Vergleichsprotokoll mit den Unterschieden zwischen den Dateien erstellen.