log

log

Specifies a file where you want to log the outcome from the execution of the command, whether the command completes successfully or encounters errors. If you do not specify the {--log | -l} option, the command logs this error information to the console.

The logged results include:

Service output

Errors that occur while interpreting the command

Note: If the error occurs while the initializing the command, the error is written to the console rather than the file specified with the {--log | -l} option

Debug information if the {--debug | -d} option is specified on the command

Syntax

--log | -l file

Arguments

Argument	Description
file	Specifies the log file where you want the errors written. If the file you specify does not exist, the command creates it. You can specify: Absolute directory path and filename. Relative directory path and filename. The path is relative from where you initiated the command. Filename of a file in the same directory where you initiated the command.

Usage Notes

If you use the {--output | -o} option with the {--log | -l} option and the command completes successfully, the command writes the results to the output file and logs the outcome to the log file.

If you use the {--error | -r} option with the {--log | -l} option and the command encounters an error, the command writes the error results to the error file and logs the outcome to the log file.

If a command uses the {--debug | -d} command, the debug information is also written to the log file.

If the file you specify with the {--log | -l} option already exists, the command appends the new service results to the file.

The error information includes a timestamp. Using this option for commands generates a history of the command execution and actions.

Examples

To log information to a file named “logfile.xml” in the directory c:\outputs:

--log c:\outputs\logfile.xml

To log information to a file named “logfile.json” in the \outputs directory relative to where you initiate the command:

--log outputs\logfile.json

To log information to a file named “logfile” in the same directory from where you initiate the command:

--log logfile