Skip to main content

sos device power-action

Perform power action on device

Description

Executes various power and control actions on remote signageOS devices, including applet reloads, display power management, system reboots, and applet state changes. This command provides remote device management capabilities for troubleshooting and maintenance operations.

Usage

sos device power-action <actionType> [options]

Options

OptionTypeDescriptionDefault
--no-default-organizationbooleanPrevent using the defaultOrganizationUid from ~/.sosrc
--organization-uidstringOrganization UID
--device-uidstringDevice UID
--typestringType of device power action

Examples

# Reload applet on device
sos device power-action reload --device-uid device123

# Turn display on
sos device power-action displayOn --device-uid device123

# Turn display off
sos device power-action displayOff --device-uid device123

# Restart application
sos device power-action restart --device-uid device123

# Disable applet
sos device power-action disable --device-uid device123

# Enable applet
sos device power-action enable --device-uid device123

# Reboot device
sos device power-action reboot --device-uid device123

# Refresh content
sos device power-action refresh --device-uid device123

Reboot system

sos device power-action reboot --device-uid device123

Refresh applet

sos device power-action refresh --device-uid device123

## Advanced Usage

### Power Action Types

| Action | Description |
|-------------|----------------------------|
| reload | Applet Reload |
| displayOn | Display power On |
| displayOff | Display power Off |
| restart | Application restart |
| disable | Applet disable |
| enable | Applet enable |
| reboot | System reboot |
| refresh | Applet Refresh |

### Usage Scenarios

```bash
# Reload applet content
sos device power-action --device-uid device123 --type reload

# Turn display off for maintenance
sos device power-action --device-uid device123 --type displayOff

# Restart the device application
sos device power-action --device-uid device123 --type restart

# Reboot the entire system
sos device power-action --device-uid device123 --type reboot

Since

0.9.0

Global Options

All commands support the following global options:

OptionAliasDescription
--help-hDisplay help information for any command
--version-vDisplay the installed version of the CLI
--api-url-uOverride the API URL for REST requests
--profileUse a specific profile from ~/.sosrc config

Examples

# Show version
sos --version

# Get help for any command
sos applet --help
sos applet upload --help

# Use custom API endpoint
sos --api-url https://api.example.com applet upload

# Use specific profile
sos --profile production organization list