---
title: "remote-devices"
slug: "cli-sc-remote-devices"
updated: 2025-12-09T19:53:43Z
published: 2025-12-09T19:53:43Z
canonical: "docs.crossworkassurance.cisco.com/cli-sc-remote-devices"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crossworkassurance.cisco.com/llms.txt
> Use this file to discover all available pages before exploring further.

# remote-devices

## remote-devices add

remote-devices add - Add a new remote device to the span of control of the Sensor Control. The remote units can then be discovered using the discovery related commands.

**Description:** Allows remote devices to be added to the span of control of the Sensor Control manually. Adding remote devices provides the Sensor Control with the information (e.g. MAC address/Security key association) required to establish a secured management session between the Sensor Control and the remote device. Once the remote device is added, the Sensor Control must be authorized to manage the device.

**Syntax:**

```
  remote-devices add device-name <name> {
    {device-mac-addr <mac-addr>} |
    {device-security-key <key>}  |
    {authorize <yes|no>} |
    {connect <yes|no>} |
    {extra-reconnection-delay <enable|disable>} |
    {type <string>} |
    {layer2-interface <if-name>} |
    {destination-ip <ip>} |
    {tun-tcp-port <1-65534> } |
    {tun-dscp <0-63> } |
    {flex-monitor <enable|disable>} |
    {override-config <yes>} |
    {tun-ip <ip>} }+

  <name>     = <string>
  <mac-addr> = <string in MAC address format (e.g. xx:xx:xx:xx:xx:xx)>
  <key>      = <string in security key format (e.g. xx:xx:...:xx:xx)>
  <if-name>  = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| device-name | The assigned remote device name. This becomes the device-name used in other commands. |
| filename | Unique filename containing the list of remote devices to add. |
| device-mac-addr | The MAC address tied to the single remote device to add. |
| device-security-key | The security key tied to the single remote device to add. |
| authorize | (DEPRECATED) Authorization for the VCX Controller to manage the remote device(s). |
| connect | Connection for the VCX Controller to manage the remote device(s). |
| extra-reconnection-delay | Enable or disable the increased reconnection delay with the remote device. |
| type | The type of the remote device. This is used to limit the device capabilities in pre-provisioning mode. |
| layer2-interface | The layer-2 interface used to reach the remote device. This mandatory parameter is ignored when IPAD or ACP Layer-2 network delivery mode is used. |
| destination-ip | The IPv4 address used to reach the remote device. This mandatory parameter is ignored when IPAD or ACP Layer-2 network delivery mode is used. |
| tun-tcp-port | TCP port to use for the tunnel with the remote device. |
| tun-dscp | DSCP value to use for the tunnel with the remote device. |
| flex-monitor | Enable or disable the FlexMonitor on the remote device(s). |
| override-config | Confirm to override remote-device persistent configuration. |
| tun-ip | The tunnel IP address used in NFV tunnel and flow broker to create TCP connection through a NAT. This IP address has precedence over any other configured IP addresses. |

## remote-devices add import

remote-devices add import- Import a list of remote devices to the span of control of the Sensor Control. The remote units can then be discovered using the discovery-related commands.

**Description:** Allows remote devices to be added to the span of control of the Sensor Control through a file containing a list of remote devices. Adding remote devices provides the Sensor Control with the information (e.g. MAC address/Security key association) required to establish a secured management session between the Sensor Control and the remote device. Once the remote devices are added, the Sensor Control must be authorized to manage the device.

**Syntax:**

```
  remote-devices add import
                 {http | tftp | ftp | sftp}://[<user-name>:<password>@]<url>
```

**Examples:**

```
  remote-devices add import http://mypc.com/remote_devices.csv
  remote-devices add import ftp://username:password@mypc.com/remote_devices.csv
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| <user-name> | <string> |
| <password> | <string> |
| <url> | <string> The URL host subcomponent consists of a name or an IP address. IPv4 addresses must be in dot-decimal notation, and IPv6 addresses must be enclosed in brackets ([]). |

## remote-devices authorize-all (DEPRECATED)

Deprecated Command

This command is deprecated. `authorize-all` is replaced by `connect-all`

remote-devices authorize-all - Authorize the management of all remote devices already added to the system by the Sensor Control.

**Description:** Authorize all previously added remote devices. The Sensor Control will be authorized to manage them.

**Syntax:**

```
  remote-devices authorize-all
```

## remote-devices connect-all

remote-devices connect-all - Connect all remote devices that are currently present on the Sensor Control.

**Description:** Connect all remote devices that are currently present on the Sensor Control.

**Syntax:**

```
  remote-devices connect-all
```

## remote-devices delete

remote-devices delete - Delete a remote device or a list of remote devices from the span of control of the Sensor Control.

**Description:** Remote devices can be deleted from the span of control of the Sensor Control. The user can either specify one remote device or all of them so the user can modify the information related to each if ever needed.

**Syntax:**

```
  remote-devices delete {{device-name <name>} | all}

  <name> = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| device-name | Name of the remote device to be deleted from the span of control. |
| all | All remote devices already added to the system are to be deleted from the span of control of the Sensor Control. |

## remote-devices deny-all (DEPRECATED)

Deprecated Command

This command is deprecated. `deny-all` is replaced by `disconnect-all`.

remote-devices deny-all - Deny the management of all remote devices already added to the system by the Sensor Control.

**Description:** Deny all previously added remote devices. The Sensor Control will not be authorized to manage them.

**Syntax:**

```
  remote-devices deny-all
```

## remote-devices disconnect-all

remote-devices disconnect-all - Disconnect all remote devices that are currently present on the Sensor Control.

**Description:** Disconnect all remote devices that are currently present on the Sensor Control.

**Syntax:**

```
  remote-devices disconnect-all
```

## remote-devices edit

remote-devices edit context - Set context on a remote device.

**Description:** Set a remote device context. All CFM commands are contextual and will be applied to the selected remote device.

**Syntax:**

```
  remote-devices edit context <device-name>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| <device-name> | <string> |

**OR**

remote-devices edit - Edit the parameters needed to have a remote device within an Sensor Control's span of control.

**Description:** Some attributes tied to remote devices can be edited so the span of control of the Sensor Control can take into consideration those attributes. The attributes are information (e.g. MAC address/Security key association) required to establish a secured management session between the Sensor Control and the remote device.

**Syntax:**

```
  remote-devices edit <device-name <name>> {
    {name <dev-name>}    |
    {device-mac-addr <mac-addr>} |
    {device-security-key <key>}  |
    {authorize <yes|no>} |
    {connect <yes|no>} |
    {admin-state <in-service|out-of-service>} |
    {in-service-feature-set <pmon|tgen>} |
    {feature-suites <suite-name> [force]} |
    {extra-reconnection-delay <enable|disable>} |
    {switch-back-delay <seconds>} |
    {type <string>  |
    {layer2-interface <if-name>} |
    {destination-ip <ip>} |
    {tun-tcp-port <1-65534> } |
    {tun-dscp <0-63> }
    {flex-monitor <enable|disable>} |
    {override-config <yes>} |
    {default-traffic-fwd <permit|drop>} |
    {tun-ip <ip>} }+

  <name>       = <string>
  <dev-name>   = <string>
  <mac-addr>   = <string in MAC address format (e.g. xx:xx:xx:xx:xx:xx)>
  <key>        = <string in security key format (e.g. xx:xx:...:xx:xx)>
  <suite-name> = <string>
  <seconds>    = <decimal>
  <if-name>    = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| device-name | The remote device's name for which attributes must be edited. |
| name | New name to be assigned to the remote device (Max 25 characters). |
| device-mac-addr | The MAC address tied to the single remote device to add. |
| device-security-key | The security key tied to the single remote device to add. |
| authorize | (DEPRECATED) Authorization for the VCX Controller to manage the remote device. |
| connect | Connection for the VCX Controller to manage the remote device. |
| admin-state | Administrative state of the remote device. When in service, the remote device is locked to the in-service feature set. On out-of-service, a loss of traffic can occur. |
| in-service-feature-set | The feature set that will become active when the administrative state is in service. |
| feature-suites | The active feature suite on the device. |
| extra-reconnection-delay | Enable or disable the increased reconnection delay with the remote device. |
| switch-to-in-service-delay | The delay in seconds before switching to in-service admin-state. The timer starts once the SAT test has completed. When the delay elapses, the device will switch to the in-service admin state. A delay of 0 sec disables the switch. This feature is only available in out-of-service admin state. |
| type | The type of the remote device. This is used to limit the device capabilities in pre-provisioning mode. |
| layer2-interface | The layer-2 interface used to reach the remote device. This mandatory parameter is ignored when IPAD/ACP Layer-2 network delivery mode is used. |
| destination-ip | The IPv4 address used to reach the remote device. This mandatory parameter is ignored when IPAD or ACP Layer-2 network delivery mode is used. |
| tun-tcp-port | TCP port to use for the tunnel with the remote device. |
| tun-dscp | DSCP value to use for the tunnel with the remote device. |
| flex-monitor | Enable or disable the FlexMonitor on the remote device(s). |
| override-config | Confirm to override remote-device persistent configuration. |
| default-traffic-fwd | Select how incoming traffic will be processed at the device's power-on stage: either permit: forwarded to the other port, or drop: dropped traffic instead of forwarding. The default setting is `permit`. |
| tun-ip | The tunnel IP address used in NFV tunnel and flow broker to create a TCP connection through a NAT. This IP address has precedence over any other configured IP addresses. |
| force | Allow forcing the upgrade of a remote device, uniquely used for support purposes. |

**IMPORTANT:** dropping traffic at a remote device (instead of forwarding) will impact the interaction between the Sensor Control and all other remote devices downstream from this current device.

## remote-devices edit context

remote-devices edit context - Select a remote device context

**Description:** Set the current command context to the specified device. Subsequent commands will be performed only on the selected device instead of on all devices.

**Syntax:**

```
  remote-devices edit context [<dev-name> | None]

  <dev-name>   = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| dev-name | The name of the selected remote device. |
| None | Remove the current device context. |

## remote-devices factory-reset

factory-reset - factory reset the remote device

**Description:** The factory-reset command allows you to factory reset the remote device, and a confirmation message will be shown (except in cases where users add the force option).

**Syntax:**

```
  remote-devices factory-reset <device-name>
```

## remote-devices firmware

remote-devices firmware - Manage a remote device's firmware.

**Description:** Use this command to manage the firmware load present on a remote device.

**Syntax:**

```
  remote-devices firmware {cancel <device-name>}

  <device-name> = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| cancel | Aborts the current update operation; the active feature suite is unchanged. Cancelling a feature update is not traffic affecting. |

## remote-devices override-config-all

remote-devices override-config-all - Confirm the override of all remote devices already added to the system by the Sensor Control.

**Description:** Confirm all previously added remote devices. The Sensor Control will be allowed to override remote-device persistent configuration.

**Syntax:**

```
  remote-devices override-config-all
```

## remote-devices reboot

remote-devices reboot - Reboot a remote device

**Description:** Reboots the remote device within the span of control of the Sensor Control, removes the non-persistent configuration from the module and restarts the remote device. All non-persistent configurations are discarded by the module. However, after the reboot, the Sensor Control reapplies many non-persistent configurations back to the device. Persistent configurations (such as interface, policies and TWAMP stateful) are maintained.

**Note:** The device "Linked" state must be "Yes".

**Syntax:**

```
  remote-devices reboot <device-name>

  <device-name> = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| device-name | Name of the remote device to be rebooted. |

## remote-devices reboot-delete

remote-devices reboot-delete - Reboot a remote device and then delete it

**Description:** Deletes and reboots the device within the span of control of the Sensor Control. All non-persistent configurations are discarded. Persistent configurations (such as interface, policies and TWAMP stateful) are maintained. After the reboot, the device is removed from the span of control of the Sensor Control.

**Syntax:**

```
  remote-devices reboot-delete <device-name>

  <device-name> = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| device-name | Name of the remote device to be rebooted. |

## remote-devices show

remote-devices show [[-d] | [<device-name>] [-d]] remote-devices show context remote-devices show feature-set remote-devices show feature-suites remote-devices show chassis remote-devices show logs

**Description:** Without an argument or a sub-command, displays the list of all associated remote devices in a table format. When a device name is specified, displays the detailed configuration and status of that device.

With a sub-command, shows a related group of configuration and status information for remote-devices:

- remote-devices show context		- Show the currently selected remote device
- remote-devices show feature-set	- Show the current feature-sets
- remote-devices show feature-suites	- Show the available feature-suites
- remote-devices show chassis		- Show the current chassis information
- remote-devices show logs		- Show field support logs

See the help texts for the associated sub-commands for more details.

**Syntax:**

```
  remote-devices show [[-d] | [<device-name>] [-d]]

  <device-name> = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| device-name | Name of the remote device for which configuration details are to be shown. |
| -d | Used to enable an alternate display. |

**Output:**

```
remote-devices show

Instance Remote Device Name             MAC address       Linked       Auth Admin State State
-------- ------------------------------ ----------------- ------------ ---- ----------- ------------
       1 P130-0016                      00:15:AD:44:60:0A Yes          Yes  OOS         Managed
       2 P130-0021                      00:15:AD:44:60:18 Yes          Yes  OOS         Managed

remote-devices show P130-0016

Remote Device Name              : P130-0016
Serial Number                   : P130-0016
MAC address                     : 00:15:AD:44:60:0A
Security Key                    :
Linked                          : Yes
Type                            : Nano 2 Optical
Authorized                      : Yes
Admin State                     : Out-of-service
Extra reconnection delay        : Enabled
Switch to in-service delay      : 0
Tunnel TCP port                 : 44240
Tunnel DSCP                     : 0
FlexMonitor                     : Disabled
Override-config                 : Yes
Default traffic forwarding      : Permit

Static Entry                    : Disabled
    Layer-2 Interface           : None
    Destination IP              : 0.0.0.0

Discovery VLAN                  : C-VLAN:471
Discovery VCX MAC               : 52:54:00:72:1A:5E
Discovery VCX IP                : ---
Discovery Destination MAC       : 00:15:AD:44:60:0A
Discovery Destination IP        : ---
Instance                        : 1
Connect                         : Yes
State                           : Managed
State Description               :
Management IP address           : ---
Tunnel IP address               : 172.1.0.1
Vendor                          : Accedian
CLEI code                       : SUIVAHDMAA
UDI                             : ---
```

## remote-devices show chassis

remote-devices show chassis [<device-name>] - Show information on power supplies, temperature sensors and fan speed of remote devices

**Description:** Without an argument, displays a summary in table format of current status of DC power supplies, temperature sensors and fan speeds of all associated GEN2 remote-devices. When a device name is specified, displays the current reading from that device of power supplies, temperature sensors and fan speeds, along with the status of environmental alarms associated with these sensors (when the sensors are available on the device).

**Syntax:**

```
  remote-devices show chassis [<device-name>]

  <device-name> = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| device-name | Name of the remote device for which chassis sensor details are to be shown. |

## remote-devices show context

remote-devices show context - Show the remote device context

**Description:** Show the currently selected device context

**Syntax:**

```
  remote-devices show context
```

**Output:**

```
Selected context : A800-0123
or
Selected context : None
```

## remote-devices show feature-set

remote-devices show feature-set [[-d] | [<device-name>] [-d]] - Show the current feature-set of the remote-devices

**Description:** Without an argument, displays a summary in table format of the current administrative state and the active feature-set of all associated remote devices. When a device name is specified, displays the current administrative state and the active feature-set of that device.

**Syntax:**

```
  remote-devices show feature-set [[-d] | [<device-name>] [-d]]

  <device-name> = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| device-name | Name of the remote device for which feature-set details are to be shown. |
| -d | Used to enable an alternate display. |

## remote-devices show feature-suites

remote-devices show feature-suites [<device-name>] - Show information of feature-suites associated with remote-devices

**Description:** Without an argument, displays a summary in table format of the feature-suites currently selected on associated remote-devices. When a device name is specified, displays the current feature-suite selected for that remote device along with the update status of the selected feature-suite.

**Syntax:**

```
  remote-devices show feature-suite [<device-name>]

  <device-name> = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| device-name | Name of the remote device for which feature-suite details are to be shown. |

## remote-devices show logs

remote-devices show logs [<device-name>] - Print field support logs

**Description:** Display a listing of field support logs associated with the remote device that has been collected up to now.

**Syntax:**

```
  remote-devices show logs [<device-name>]

  <device-name> = <string>
```

**Parameters:**

| Parameter | Description |
| --- | --- |
| device-name | Name of the remote device for which field support logs are to be displayed. |

**© 2026 Cisco and/or its affiliates. All rights reserved.** For more information about trademarks, please visit: [Cisco trademarks](https://www.cisco.com/c/en/us/about/legal/trademarks.html)[](https://www.cisco.com/c/en/us/about/legal/trademarks.html) For more information about legal terms, please visit: [Cisco legal terms](https://www.cisco.com/c/en/us/about/legal/terms-conditions.html)