Running commands

Quick Demo

See how to execute commands across devices and groups.

Inspect targets

# Device info
nw info device1
# Group info
nw info access_switches
# Sequence info
nw info health_check

Expected output (device):

Device: device1
Host: 192.0.2.10
Port: 22
Credentials: default or interactive
Groups: access_switches

Run commands

# Single command on a device
nw run device1 "/system/resource/print"

# Run on a group
nw run access_switches "show version"

# Multiple targets
nw run device1,access_switches "/system/identity/print"

Expected output (trimmed):

Executing on device1: /system/resource/print
uptime=...
free-memory=...
Command completed successfully

Run sequences

# Predefined sequence on a device
nw run device1 health_check

# On a group
nw run core_switches audit

Expected output (trimmed):

device1: step 1/3 ... ok
device1: step 2/3 ... ok
device1: step 3/3 ... ok
Sequence completed successfully

Upload and download

# Upload a file to a device
nw upload device1 firmware.npk

# Download a file from a device
nw download device1 config.backup

Results and formatting

# Save results for a single run
nw run device1 system_info --store-results

# Override the target directory for this run (format comes from config)
nw run device1 system_info --store-results --results-dir ./maintenance

# Adjust output styling for help/readability
nw info device1 --output-mode raw

Notes:

• The results directory defaults to the value in general.results_dir; override per run with --results-dir.
• Choose the serialization format via general.results_format in config.yml (txt/json/yaml).

Next steps

• See all flags and subcommands → CLI reference
• Store and inspect outputs → Results
• Customize CLI styling → Output modes
• Back up devices across vendors → Backups