Command Line Reference
Device Management
POE Configuration
28 min
show interface poe show interface poe \[command] show interface poe \[purpose] display interface poe information \[view] system view \[use cases] sonic# show interface poe show interface poe diagnose show interface poe diagnose \[command] show interface poe diagnose \[purpose] display interface poe initialization information \[view] system view \[usage scenario] this command displays information including poe hardware version, poe status, current poe temperature, alarm temperature, and the number of internal poe resets \[notes] if the command results in a "device busy" message, it is normal this indicates that the system is currently retrieving poe power information simply reissue the command to get the results \[use cases] sonic# show interface poe diagnose pse device information field value \ version 0x4a02 status ok expected poe device found (zone1) event temperature 48 c temperature alarm 110 c reset count 0 initialized true pse wrong port map interface current id expect id \ show interface poe pd alive check status show interface poe pd alive check status \[command] show interface poe pd alive check status \[purpose] display the poe pd alive check configuration and status information for the interface \[view] system view \[usage scenario] this command can display the configuration information for poe pd alive check and its real time status monitoring results \[notes] when the interface's poe feature is disabled, both the last ping time and alive status will display as n/a \[use cases] sonic# show interface poe pd alive check status \ config for delay/interval/err threshold/action/reboot interval + + + + + + + + \| interface | mode | config | pd ip | last ping time | alive | err count | +=============+========+==================+=============+=====================+=========+===========+ \| ethernet2 | enable | 60/15/3/alarm/30 | 192 168 0 1 | 2025 09 13 16 22 16 | true | 2 | + + + + + + + + poe enable poe enable \[command] poe enable no poe enable \[purpose] enable poe power supply function of the interface \[view] interface view \[use cases] sonic(config)# interface ethernet 1 sonic(config if 1)# poe enable poe delay poe delay \[command] poe delay time no poe delay \[purpose] configure the delayed start time of the interface poe function \[parameter] parameter description time range of values 0 3600 \[view] interface view \[usage scenario] this command is used to delay the activation of power over ethernet (poe) power supply on an interface based on actual usage requirements when the uplink link state stabilizes, and the protocols are running correctly, poe power is supplied to the connected poe devices this delay mechanism is useful for ensuring that poe devices receive power only when the network is stable and ready to support them \[use cases] sonic(config)# interface ethernet 1 sonic(config if 1)# poe delay 300 poe max power poe max power \[command] poe max power power no poe max power \[purpose] configure the maximum output power of the device \[parameter] parameter description power 60w/30w/15w/30w at the unit is w \[view] system configuration view \[notes] by default, the maximum output power of a device is the power actually provided by the device therefore, the configured maximum output power must be lower than or equal to the total power of poe power modules \[use cases] sonic(config)# poe max power 60w poe priority {low|high|critical} poe priority {low|high|critical} \[command] poe priority {low|high|critical} \[purpose] configure the power priority of a poe interface \[parameter] parameter description critical indicates the highest priority high indicates the second highest priority low indicates the lowest priority \[view] system configuration view \[notes] when the output power of a device is insufficient, the device in automatic power management mode provides power for the interfaces of the higher power supply priorities first and cuts off power of the interfaces of the lower power supply priorities poe switches provide power to pds connected to the interfaces in the sequence in which pds are connected to them by default, the power supply priority of an interface is low \[use cases] sonic(config)# interface ethernet 4 sonic(config if 4)# poe priority high time range time time range time \[command] time range name from date stop to date start no time range \[purpose] configure poe power off time range \[parameter] parameter description name specifies the name of a time range date stop specify the stop time of a time range, the format is hh\ mm yy mm dd date start specify the start time of a time range, the format is hh\ mm yy mm dd \[view] system configuration view \[use cases] sonic(config)# time range test from 12 00 2022 01 01 to 16 00 2023 01 01 time range date time range date \[command] time range name time stop to time start no time range \[purpose] configure poe power off date range \[parameter] parameter description name specifies the name of a time range time stop specify the stop time of a time range, the format is hh\ mm time start specify the start time of a time range, the format is hh\ mm \[view] system configuration view \[use cases] sonic(config)# time range test 00 00 to 23 59 off day poe power off time range poe power off time range \[command] poe power off time range name no poe power off time range \[purpose] configure poe power off time range effective on an interface \[view] interface view \[use cases] sonic(config)# interface ethernet 48 sonic(config if 48)# poe power off time range test warning this operation may power off some pd continue? \\\[y/n] y poe legacy detect enable poe legacy detect enable \[command] poe legacy detect enable poe legacy detect disable \[purpose] enable device power supply compatibility detection for pd devices \[view] interface view \[usage scenario] enable compatibility detection for pd devices, allowing the device to detect pd devices that do not comply with the 802 3af or 802 3at standards and supply power to these pd devices if the compatibility check for pd devices is not enabled, the device will not recognize non standard pd devices and will be unable to supply power to them \[use cases] sonic(config)# interface ethernet 1 sonic(config if 1)# poe legacy detect disable poe reinitialize poe reinitialize \[command] poe reinitialize \[purpose] initialize poe feature \[view] system configuration view \[usage scenario] if the device has not been initialized for poe at the factory, this command can be used for manual initialization after executing this command, a device reboot is not required, but all poe functionalities will be automatically disabled once initialization is complete, poe will be enabled again \[use cases] sonic(config)# poe reinitialize poe pd alive check enable poe pd alive check enable \[command] poe pd alive check enable no poe pd alive check enable \[purpose] enable the poe pd alive check detection function on the interface \[view] interface view \[usage scenario] it detects the status of the peer device by pinging the configured ip address if the number of consecutive failed detection attempts exceeds the set threshold, it will generate a warning alarm in the logs and execute the configured action \[use cases] sonic(config)# interface ethernet 1 sonic(config if 1)# poe pd alive check enable poe pd alive check ip poe pd alive check ip \[command] poe pd alive check ip ip address no poe pd alive check ip \[purpose] configure the ip address for poe pd alive check detection \[view] interface view \[parameter] parameter description ip address support ipv4 address and ipv6 address \[use cases] sonic(config)# interface ethernet 1 sonic(config if 1)# poe pd alive check ip 192 168 0 1 poe pd alive check delay poe pd alive check delay \[command] poe pd alive check delay time no poe pd alive check delay \[purpose] configure the delay time for poe state restart after a poe detection abnormality \[view] interface view \[parameter] parameter description time the detection delay after a poe restart;unit seconds;range 5 600 \[use cases] sonic(config)# interface ethernet 1 sonic(config if 1)# poe pd alive check delay 60 poe pd alive check interval poe pd alive check interval \[command] poe pd alive check interval time no poe pd alive check interval \[purpose] configure the detection interval for poe pd alive check \[view] interface view \[parameter] parameter description time the detection interval for poe pd alive check,;unit seconds; range 10 300 \[use cases] sonic(config)# interface ethernet 1 sonic(config if 1)# poe pd alive check interval 30 poe pd alive check err threshold poe pd alive check err threshold \[command] poe pd alive check err threshold number no poe pd alive check err threshold \[purpose] configure the threshold for the number of poe pd alive check detection errors \[view] interface view \[parameter] parameter description number the threshold for the number of poe pd alive check detection errors; unit seconds; range 1 10 \[usage scenario] when the number of times the device detects that the ip is unreachable is greater than or equal to the configured error count threshold, the configured action will be triggered and a warning alarm log will be generated \[use cases] sonic(config)# interface ethernet 1 sonic(config if 1)# poe pd alive check err threshold 10 poe pd alive check action {reboot|alarm} poe pd alive check action {reboot|alarm} \[command] poe pd alive check action {reboot|alarm} no poe pd alive check action \[purpose] configure the action to be taken after a poe pd alive check detection abnormality \[view] interface view \[parameter] parameter description reboot when an anomaly is triggered, only a warning alarm log is generated alarm when an anomaly is triggered, both a warning alarm log is generated and the interface's poe function is restarted this action is default \[use cases] sonic(config)# interface ethernet 1 sonic(config if 1)# poe pd alive check action reboot poe pd alive check reboot interval poe pd alive check reboot interval \[command] poe pd alive check reboot interval time no poe pd alive check reboot interval \[purpose] configure the interval between the poe shutdown and the subsequent poe restart on the interface after a poe pd alive check anomaly is triggered \[view] interface view \[parameter] parameter description time the interval between the poe shutdown and restart on the interface after a poe pd alive check anomaly is triggered; unit seconds; range 1 180 \[use cases] sonic(config)# interface ethernet 1 sonic(config if 1)# poe pd alive check reboot interval 100
