To start Diagnostics, you can enter various call parameters and call parameter switches using the command line.
The following table provides an overview of the individual call parameters and call parameter switches:
|
Call Parameter |
Description |
|
|---|---|---|
|
[-username <UserName>] [-password <Password>] [-renewalpassword <RenewalPassword>] -connect ip <IP-/EPATH-Address> |
Starts the program and immediately collects the data of the controller selected under <IP-/EPATH-Address>. Equivalent to collecting data via Ethernet in the window Connect to controller via.... o-username: User name to connect to. o-password: Password belonging to the username. o-renewalpassword: Password that is required on a first connection with active device user rights management on the controller. In this case the default username / password combination Administrator / Administrator must be set. NOTE: If you start the Diagnostics with the GUI (Graphical User Interface), you can also set the three arguments - username, -password, and -renewalpassword. In this case, you are not prompted to enter credentials. The credentials are retrieved from the values of the arguments. |
|
|
-connect com <ComPort> |
Starts the program and immediately collects the data of a controller connected to a COM port. The port is selected using <ComPort>. Equivalent to collecting data via Com (RS 232) in the window Connect to controller via.... |
|
|
-connect modem |
Starts the program and immediately collects the data of a controller connected via modem. Equivalent to collecting data via Modem in the window Connect to controller via.... NOTE: The dial-up connection must already be established. |
|
|
-open <file name> |
Starts Diagnostics and immediately opens the data collection from the file entered under <file name>. Equivalent to Open... command on the Home window. |
|
|
-nosplash |
Suppresses the Home window that is normally shown upon startup. |
|
|
-language <language abbreviation> |
Starts the program in the language entered under <language abbreviation>. Possible language abbreviations are: ode: German oen: English ofr: French oit: Italian oes: Spanish opt: Portuguese otr: Turkish och: Chinese oja: Japanese |
|
|
-userconfigfile <file name> |
V1.6 and later. Loads the configuration file specified under <filename> with user-specific settings (for example, automatic name generation when saving the data collection). |
|
|
-help |
V2.0 and later. Prints all possible call parameters and examples to the console. Example: Diagnostics -help |
|
|
[-username <UserName>] [-password <Password>] [-renewalpassword <RenewalPassword>] -save ip <IP-/EPATH-Address> file <file name> |
V2.0 and later. Collects the data from the controller and saves it directly under the file name. The call-up is effected via the command line, that is, without a graphical user interface. o-username: User name to connect to. o-password: Password belonging to the username. o-renewalpassword: Password that is required on a first connection with active device user rights management on the controller. In this case the default username / password combination Administrator / Administrator must be set. NOTE: You need write access rights to the given file destination. If you do not have write access rights, you can try to start Diagnostics with administrative privileges. |
|
|
|
-save modem file <file name> |
|
|
-save com <ComPort> file <file name> |
||
|
-untrustedServerCertificateValidationMode <promptuser|donottrust|trustonce|trustalways> |
If a connection to a controller is established and the certificate of the controller is not yet available, this optional call parameter switch allows you to decide how to proceed: opromptuser (default setting): A user prompt is displayed allowing you to decide how to proceed with the detected certificate. odonottrust: The certificate is declared as untrusted and the connection is unsuccessful if requested. otrustonce: The certificate is declared as trusted for this communication attempt but not saved on this PC to the folder Controllers of the Windows User certificates. otrustalways: The certificate is declared as trusted and saved on this PC to the folder Controllers of the Windows User certificates. NOTE: If you start the Diagnostics with the GUI (Graphical User Interface), you can also set the three arguments - username, -password, and -renewalpassword. In this case, you are not prompted to enter credentials. The credentials are retrieved from the values of the arguments. |
|
|
-encryptedcommunication <no|tls|auto> |
This optional call parameter switch can be used to set the encryption mode while connecting to a controller: ono: No encryption is used. otls: TLS encryption is used. oauto (default setting): The most secured mode supported by the controller is used. |
|
You can enter the call parameters in different orders. In some cases, you can combine them (not –connect). This is case-sensitive. If you enter invalid parameters, the program will not start. When this happens, no diagnostic message is displayed.
oDiagnostics.exe -connect ip 10.205.0.50
oDiagnostics.exe -connect ip epath3://9078.0AE8@10.128.224.120:1217
oDiagnostics.exe –connect ip etcp2://192.168.2.50
oDiagnostics.exe –connect ip enodename3://LMC_PacDrive (192.168.2.50)
oDiagnostics.exe –connect ip enodename3://173.20.5.36:1105,LMC_PacDrive (192.168.2.50)
oDiagnostics.exe –connect ip enodename3://[10.128.154.12:1217],LMC_PacDrive (192.168.2.50)
oDiagnostics.exe –connect ip enodename3://[10.128.154.12:1217],LMC_PacDrive (192.168.2.50)
oDiagnostics.exe –connect ip etcp3://192.168.2.50
oDiagnostics.exe –connect ip etcp3://173.20.5.36:1105,192.168.2.50
oDiagnostics.exe –connect ip etcp3://[10.128.154.12:1217],192.168.2.50
oDiagnostics.exe –connect ip etcp4://192.168.2.50:11740
oDiagnostics.exe -connect com 1
(PacDrive M only)
oDiagnostics.exe -connect modem
(PacDrive M only)
oDiagnostics.exe -open "c:\Documents and Settings\C200.pdi"
oDiagnostics.exe –nosplash
oDiagnostics.exe -userconfigfile "c:\Documents and Settings\MyConfiguration.xml"
oDiagnostics.exe -save ip 10.205.0.50 file „c:\Users\MyUser\Documents\Machinexyz.pdi"
oDiagnostics.exe -save com 1 file „c:\Users\MyUser\Documents\Machinexyz.pdi"
(PacDrive M only)
oDiagnostics.exe -save ip etcp2://10.205.0.50 file "c:\Users\MyUser\Documents\Machinexyz.pdi"
(PacDrive M only)
oDiagnostics.exe -save ip etcp3://10.205.0.50 file "c:\Users\MyUser\Documents\Machinexyz.pdi"
(PacDrive 3 only)
oDiagnostics.exe -connect ip 10.205.0.50 –nosplash
oDiagnostics.exe -connect ip epath3://9078.0AE8@10.128.224.120:1217 –nosplash–language de
oDiagnostics.exe –language de -open "c:\Documents and Settings\C200.pdi"
oDiagnostics.exe -userconfigfile "c:\Documents and Settings\MyConfiguration.xml" -nosplash
oDiagnostics.exe -username Administrator -password Administrator -renewalpassword MyNewPassword –connect ip etcp4://192.168.2.50:11740
oDiagnostics.exe -username Administrator -password MyPassword –connect ip etcp3://192.168.2.50
oDiagnostics.exe -username Administrator -password MyPassword –save ip enodename3://TM262@MyMacAddress file "c:\Temp\MyMachine.pdi"
oDiagnostics.exe -encryptedcommunication auto -untrustedServerCertificateValidationMode trustonce -username MyUser -password MyPassword –save ip etcp4://192.168.2.50 "c:\Users\MyUser\Documents\Machinexyz.pdi"
