How to Create a vSwitch with an Uplink Interface via CLI in Hyperion

Written By Christian Castagna (Administrator)

Updated at October 20th, 2025

→ Applies to: Hyperion 9.x and above

All commands in this article are intended to be executed via Hyperion CLI.

 

Step 1. Connect to Hyperion appliance via SSH as admin

ssh admin@<your_ip_address_or_hostname>

 

Step 2. Become Super User

sudo su

 

Step 3. Create a new vSwitch with a uplink interface (replace <vswitch_name> and <interface> with the correct information)

syneto-nmctl vswitch create --name <vswitch_name> --uplink <interface> 

EXAMPLE

syneto-nmctl vswitch create --name vswitch1 --uplink ens256

 

Step 4 (optional). Add an additional uplink to a vSwitch ("How to Add an Additional Uplink to a vSwitch via CLI in Hyperion")