execute switch-controller
switch-controller
This topic includes the following commands:
- execute switch-controller custom-command
- execute switch-controller diagnose-connection
- execute switch-controller diagnose-connection-v6
- execute switch-controller flapguard reset
- execute switch-controller get-conn-status
- execute switch-controller get-physical-conn dot
- execute switch-controller get-physical-conn standard
- execute switch-controller get-sync-status all
- execute switch-controller get-sync-status group
- execute switch-controller get-sync-status serial
- execute switch-controller get-sync-status switch-id
- execute switch-controller get-upgrade-status
- execute switch-controller ssh
- execute switch-controller switch-action 802-1X clear-auth-mac
- execute switch-controller switch-action 802-1X clear-auth-port
- execute switch-controller switch-action bpdu-guard reset
- execute switch-controller switch-action cable-diag
- execute switch-controller switch-action factory-reset
- execute switch-controller switch-action flow-tracking delete-flows-all
- execute switch-controller switch-action flow-tracking expire-flows-all
- execute switch-controller switch-action igmp-snoop clear-learned
- execute switch-controller switch-action loop-guard reset
- execute switch-controller switch-action mac-device-reset dynamic
- execute switch-controller switch-action mac-device-reset nac
- execute switch-controller switch-action mac-limit-violation reset all
- execute switch-controller switch-action mac-limit-violation reset interface
- execute switch-controller switch-action mac-limit-violation reset vlan
- execute switch-controller switch-action mclag stats clear icl
- execute switch-controller switch-action mclag stats clear mlag
- execute switch-controller switch-action physical-ports led-flash switch-group
- execute switch-controller switch-action physical-ports led-flash switch-id
- execute switch-controller switch-action physical-ports led-flash tier1
- execute switch-controller switch-action physical-ports led-flash tier2plus
- execute switch-controller switch-action poe reset
- execute switch-controller switch-action restart delay all
- execute switch-controller switch-action restart delay switch-group
- execute switch-controller switch-action restart delay switch-id
- execute switch-controller switch-action restart swtp all
- execute switch-controller switch-action restart swtp switch-group
- execute switch-controller switch-action restart swtp switch-id
- execute switch-controller switch-action set-standalone
- execute switch-controller switch-action sticky-mac delete-unsaved all
- execute switch-controller switch-action sticky-mac delete-unsaved interface
- execute switch-controller switch-action sticky-mac save all
- execute switch-controller switch-action sticky-mac save interface
- execute switch-controller switch-software cancel all
- execute switch-controller switch-software cancel switch-group
- execute switch-controller switch-software cancel switch-id
- execute switch-controller switch-software delete
- execute switch-controller switch-software list-available
- execute switch-controller switch-software stage all
- execute switch-controller switch-software stage switch-group
- execute switch-controller switch-software stage switch-id
- execute switch-controller switch-software upgrade
- execute switch-controller switch-software upload ftp
- execute switch-controller switch-software upload tftp
- execute switch-controller virtual-port-pool request
- execute switch-controller virtual-port-pool return
- execute switch-controller virtual-port-pool show
- execute switch-controller virtual-port-pool show-by-pool
- execute switch-controller virtual-port-pool show-by-property
- execute switch-controller virtual-port-pool show-by-tag
execute switch-controller custom-command
Push a FortiSwitch custom command to a FortiSwitch device.
execute switch-controller custom-command <cmd-name> <target-switch>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<cmd-name> |
Names of commands to be pushed to this FortiSwitch device, as configured under config switch-controller custom-command. |
string |
|
|
<target-switch> |
FortiSwitch device to push the custom command to. |
string |
|
execute switch-controller diagnose-connection
Get FortiSwitch connection diagnostics.
execute switch-controller diagnose-connection <switch>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
execute switch-controller diagnose-connection-v6
Get FortiSwitch IPv6 connection diagnostics.
execute switch-controller diagnose-connection-v6 <switch>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
execute switch-controller flapguard reset
Reset flapguard on port.
execute switch-controller flapguard reset <switch-name> <port>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch-name> |
Name. |
string |
|
|
<port> |
FortiSwitch port. |
string |
|
execute switch-controller get-conn-status
Get FortiSwitch connection status.
execute switch-controller get-conn-status <switch>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
execute switch-controller get-physical-conn dot
Get FortiLink connectivity graph in dot output format.
execute switch-controller get-physical-conn dot <fortilink-name>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<fortilink-name> |
FortiLink name. |
string |
|
execute switch-controller get-physical-conn standard
Get FortiLink connectivity graph in standard output format.
execute switch-controller get-physical-conn standard <fortilink-name>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<fortilink-name> |
FortiLink name. |
string |
|
execute switch-controller get-sync-status all
Get FortiSwitch sync status.
execute switch-controller get-sync-status all
execute switch-controller get-sync-status group
Get FortiSwitch sync status by group.
execute switch-controller get-sync-status group <group>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<group> |
Group Name. |
string |
|
execute switch-controller get-sync-status serial
Get FortiSwitch sync status by switch serial number.
execute switch-controller get-sync-status serial <switch-serial-number>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch-serial-number> |
Serial Number. |
string |
|
execute switch-controller get-sync-status switch-id
Get FortiSwitch sync status by switch.
execute switch-controller get-sync-status switch-id <switch>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
execute switch-controller get-upgrade-status
Get FortiSwitch upgrade status.
execute switch-controller get-upgrade-status
execute switch-controller ssh
SSH to FortiSwitch.
execute switch-controller ssh <user> <switch>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<user> |
user. |
string |
|
|
<switch> |
FortiSwitch device ID. |
string |
|
execute switch-controller switch-action 802-1X clear-auth-mac
Clear FortiSwitch MAC entry.
execute switch-controller switch-action 802-1X clear-auth-mac <switch> <mac>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
|
<mac> |
MAC address. |
string |
|
execute switch-controller switch-action 802-1X clear-auth-port
Clear FortiSwitch MAC entries on a single interface.
execute switch-controller switch-action 802-1X clear-auth-port <switch> <port>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
|
<port> |
FortiSwitch port. |
string |
|
execute switch-controller switch-action bpdu-guard reset
Reset BPDU guard on switch-interface.
execute switch-controller switch-action bpdu-guard reset <switch> <port>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
|
<port> |
FortiSwitch port. |
string |
|
execute switch-controller switch-action cable-diag
Run a TDR diagnostic test on the specified FortiSwitch port.
execute switch-controller switch-action cable-diag <switch> <port>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
|
<port> |
FortiSwitch port. |
string |
|
execute switch-controller switch-action factory-reset
Set FortiSwitch to factory default settings.
execute switch-controller switch-action factory-reset <switch>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
execute switch-controller switch-action flow-tracking delete-flows-all
Delete all flows in the FortiSwitch.
execute switch-controller switch-action flow-tracking delete-flows-all <switch>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
execute switch-controller switch-action flow-tracking expire-flows-all
Expire all flows in the FortiSwitch.
execute switch-controller switch-action flow-tracking expire-flows-all <switch>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
execute switch-controller switch-action igmp-snoop clear-learned
Clear FortiSwitch IGMP snooping multicast Groups and Queriers.
execute switch-controller switch-action igmp-snoop clear-learned <switch>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
execute switch-controller switch-action loop-guard reset
Reset loop-guard on switch-interface.
execute switch-controller switch-action loop-guard reset <switch> <port>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
|
<port> |
FortiSwitch port. |
string |
|
execute switch-controller switch-action mac-device-reset dynamic
Remove specific or all DPP devices.
execute switch-controller switch-action mac-device-reset dynamic <mac>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<mac> |
MAC address of the DPP device. |
string |
|
execute switch-controller switch-action mac-device-reset nac
Remove NAC devices and return MAC to onboarding VLAN.
execute switch-controller switch-action mac-device-reset nac <mac>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<mac> |
MAC address of the NAC device. |
string |
|
execute switch-controller switch-action mac-limit-violation reset all
Reset all MAC learning limit violations in FortiSwitch.
execute switch-controller switch-action mac-limit-violation reset all <switch>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
execute switch-controller switch-action mac-limit-violation reset interface
Reset MAC learning limit violations on a FortiSwitch interface.
execute switch-controller switch-action mac-limit-violation reset interface <switch> <port>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
|
<port> |
FortiSwitch ports. |
string |
|
execute switch-controller switch-action mac-limit-violation reset vlan
Reset MAC learning limit violations on a FortiSwitch VLAN.
execute switch-controller switch-action mac-limit-violation reset vlan <switch> <vlan-id>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
|
<vlan-id> |
FortiSwitch VLAN ID. |
string |
|
execute switch-controller switch-action mclag stats clear icl
Clears MCLAG inter-chassis-link statistics.
execute switch-controller switch-action mclag stats clear icl <switch>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
execute switch-controller switch-action mclag stats clear mlag
Clears MCLAGs statistics for MCLAG enabled trunk.
execute switch-controller switch-action mclag stats clear mlag <switch> <mclag-trunk-name>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
|
<mclag-trunk-name> |
MCLAG's trunk name. |
string |
|
execute switch-controller switch-action physical-ports led-flash switch-group
Enable LED flash mode on FortiSwitches in the switch-group.
execute switch-controller switch-action physical-ports led-flash switch-group <switch-group ID> <time>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch-group ID> |
FortiSwitch group ID. |
string |
|
|
<time> |
FortiSwitch LED flash mode in minutes < disable | 5 | 15 | 30 | 60 >. |
string |
|
execute switch-controller switch-action physical-ports led-flash switch-id
Enable FortiSwitch LED flash mode by switch name.
execute switch-controller switch-action physical-ports led-flash switch-id <switch> <time>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
|
<time> |
FortiSwitch LED flash mode in minutes < disable | 5 | 15 | 30 | 60 >. |
string |
|
execute switch-controller switch-action physical-ports led-flash tier1
Enable LED flash mode on all tier 1 FortiSwitch units.
execute switch-controller switch-action physical-ports led-flash tier1 <time>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<time> |
FortiSwitch LED flash mode in minutes < disable | 5 | 15 | 30 | 60 >. |
string |
|
execute switch-controller switch-action physical-ports led-flash tier2plus
Enable LED flash mode on all tier 2 and lower FortiSwitch units.
execute switch-controller switch-action physical-ports led-flash tier2plus <time>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<time> |
FortiSwitch LED flash mode in minutes < disable | 5 | 15 | 30 | 60 >. |
string |
|
execute switch-controller switch-action poe reset
Reset PoE port on FortiSwitch.
execute switch-controller switch-action poe reset <switch> <port>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
|
<port> |
FortiSwitch port. |
string |
|
execute switch-controller switch-action restart delay all
Restart delay all FortiSwitch devices.
execute switch-controller switch-action restart delay all
execute switch-controller switch-action restart delay switch-group
Restart delay FortiSwitch devices belonging to switch-group.
execute switch-controller switch-action restart delay switch-group <switch-group ID>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch-group ID> |
Switch group ID. |
string |
|
execute switch-controller switch-action restart delay switch-id
Restart delay FortiSwitch device identified by switch name.
execute switch-controller switch-action restart delay switch-id <switch>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
execute switch-controller switch-action restart swtp all
Restart all FortiSwitch devices.
execute switch-controller switch-action restart swtp all
execute switch-controller switch-action restart swtp switch-group
Restart FortiSwitch devices belonging to switch-group.
execute switch-controller switch-action restart swtp switch-group <switch-group ID>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch-group ID> |
Switch group ID. |
string |
|
execute switch-controller switch-action restart swtp switch-id
Restart FortiSwitch device identified by switch name.
execute switch-controller switch-action restart swtp switch-id <switch>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
execute switch-controller switch-action set-standalone
Set FortiSwitch to local/non-FortiLink mode.
execute switch-controller switch-action set-standalone <switch>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
execute switch-controller switch-action sticky-mac delete-unsaved all
Delete all unsync Sticky MAC entries on FSW.
execute switch-controller switch-action sticky-mac delete-unsaved all <switch>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
execute switch-controller switch-action sticky-mac delete-unsaved interface
Delete specific interface's unsync Sticky MAC entries on FSW.
execute switch-controller switch-action sticky-mac delete-unsaved interface <switch> <port>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
|
<port> |
Delete unsaved Sticky MAC entries for the specified interface. |
string |
|
execute switch-controller switch-action sticky-mac save all
Sync and save all Sticky MAC entries to config file (loads entries on boot).
execute switch-controller switch-action sticky-mac save all <switch>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
execute switch-controller switch-action sticky-mac save interface
Sync and save specific interface Sticky MAC entries to config file (loads entries on boot).
execute switch-controller switch-action sticky-mac save interface <switch> <port>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
|
<port> |
Save Sticky MAC entries for the specified interface. |
string |
|
execute switch-controller switch-software cancel all
Cancel staged image to all FortiSwitch devices.
execute switch-controller switch-software cancel all
execute switch-controller switch-software cancel switch-group
Cancel staged image to FortiSwitch devices belonging to switch-group.
execute switch-controller switch-software cancel switch-group <switch-group ID>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch-group ID> |
Switch group ID. |
string |
|
execute switch-controller switch-software cancel switch-id
Cancel staged image to FortiSwitch device identified by switch name.
execute switch-controller switch-software cancel switch-id <switch>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
execute switch-controller switch-software delete
Delete FortiSwitch image.
execute switch-controller switch-software delete <all>|<image-name>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<all>|<image-name> |
Delete all images or specific image. |
string |
|
execute switch-controller switch-software list-available
List FortiSwitch image(s) available on FortiGate.
execute switch-controller switch-software list-available
execute switch-controller switch-software stage all
Stage image to all FortiSwitch devices.
execute switch-controller switch-software stage all <filename>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<filename> |
FortiSwitch image filename. |
string |
|
execute switch-controller switch-software stage switch-group
Stage image to FortiSwitch devices belonging to switch-group.
execute switch-controller switch-software stage switch-group <switch-group ID> <filename>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch-group ID> |
Switch group ID. |
string |
|
|
<filename> |
FortiSwitch image filename. |
string |
|
execute switch-controller switch-software stage switch-id
Stage image to FortiSwitch device identified by switch name.
execute switch-controller switch-software stage switch-id <switch> <filename>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
|
<filename> |
FortiSwitch image filename. |
string |
|
execute switch-controller switch-software upgrade
Upgrade FortiSwitch image to a managed FortiSwitch device.
execute switch-controller switch-software upgrade <switch> <filename>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
|
<filename> |
FortiSwitch image filename. |
string |
|
execute switch-controller switch-software upload ftp
Upload a FortiSwitch image from FTP server.
execute switch-controller switch-software upload ftp <string> <ftp server>[:ftp port] <Enter>|<user> <passwd>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<string> |
FortiSwitch image name on the FTP server. |
string |
|
|
<ftp server>[:ftp port] |
FTP server IPv4, IPv6, or FQDN can be attached with port. |
string |
|
|
<Enter>|<user> |
FTP username may be needed. |
string |
|
|
<passwd> |
FTP password. |
string |
|
execute switch-controller switch-software upload tftp
Upload a FortiSwitch image from TFTP server.
execute switch-controller switch-software upload tftp <string> <tftp server>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<string> |
FortiSwitch image name on the TFTP server. |
string |
|
|
<tftp server> |
TFTP server IPv4, IPv6, or FQDN. |
string |
|
execute switch-controller virtual-port-pool request
Request virtual port from pool.
execute switch-controller virtual-port-pool request <switch> <port>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
|
<port> |
FortiSwitch port. |
string |
|
execute switch-controller virtual-port-pool return
Return virtual port to pool.
execute switch-controller virtual-port-pool return <switch> <port>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<switch> |
FortiSwitch device ID. |
string |
|
|
<port> |
FortiSwitch port. |
string |
|
execute switch-controller virtual-port-pool show
Show details of virtual ports in pool.
execute switch-controller virtual-port-pool show
execute switch-controller virtual-port-pool show-by-pool
Show details of virtual ports in pool by pool name.
execute switch-controller virtual-port-pool show-by-pool <pool>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<pool> |
Pool Name. |
string |
|
execute switch-controller virtual-port-pool show-by-property
Show details of virtual ports in pool by property name.
execute switch-controller virtual-port-pool show-by-property <property>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<property> |
Property Name. |
string |
|
execute switch-controller virtual-port-pool show-by-tag
Show details of virtual ports in pool by tag name.
execute switch-controller virtual-port-pool show-by-tag <tag>
|
Parameter |
Description |
Type |
Size |
|---|---|---|---|
|
<tag> |
Tag Name. |
string |
|