TP-Link T1700G-28TQ CLI Reference Guide
CLI Reference Guide
T1700G-28TQ
1910012757 REV3.1.0
March 2020
COPYRIGHT & TRADEMARKS
Specifications are subject to change without notice. is a registered trademark of
TP-Link Corporation Limited. Other brands and product names are trademarks or registered
trademarks of their respective holders.
No part of the specifications may be reproduced in any form or by any means or used to make
any derivative such as translation, transformation, or adaptation without permission from
TP-Link Corporation Limited. Copyright © 2020 TP-Link Corporation Limited. All rights
reserved.
https://www.tp-link.com
I
CONTENTS
Preface ............................................................................................................................ 1
Chapter 1 Using the CLI ................................................................................................... 5
1.1 Accessing the CLI ..................................................................................................................................... 5
1.1.1 Logon by Telnet ...................................................................................................................... 5
1.1.2 Logon by SSH .......................................................................................................................... 6
1.2 CLI Command Modes ............................................................................................................................ 11
1.3 Privilege Restrictions ............................................................................................................................. 14
1.4 Conventions .............................................................................................................................................. 15
1.4.1 Format Conventions ........................................................................................................... 15
1.4.2 Special Characters .............................................................................................................. 15
1.4.3 Parameter Format ................................................................................................................ 15
Chapter 2 User Interface .............................................................................................. 16
2.1 enable ............................................................................................................................................... 16
2.2 service password-encryption .................................................................................................. 16
2.3 enable password ........................................................................................................................... 17
2.4 enable secret ................................................................................................................................. 18
2.5 configure .......................................................................................................................................... 19
2.6 exit...................................................................................................................................................... 19
2.7 end ..................................................................................................................................................... 20
2.8 clipaging ........................................................................................................................................... 20
2.9 history ............................................................................................................................................... 21
2.10 history clear .................................................................................................................................... 22
Chapter 3 Stack .............................................................................................................. 23
3.1 switch priority ................................................................................................................................. 23
3.2 switch renumber ........................................................................................................................... 24
3.3 switch stack-port .......................................................................................................................... 24
3.4 switch provision ............................................................................................................................ 25
3.5 show switch .................................................................................................................................... 26
Chapter 4 User Management Commands ................................................................ 28
4.1 user name (password) ................................................................................................................. 28
4.2 user name (secret) ........................................................................................................................ 29
4.3 show user account-list................................................................................................................ 30
4.4 show user configuration ............................................................................................................. 31
II
Chapter 5 System Configuration Commands ......................................................... 32
5.1 system-time manual .................................................................................................................... 32
5.2 system-time ntp ............................................................................................................................ 32
5.3 system-time dst predefined ..................................................................................................... 34
5.4 system-time dst date .................................................................................................................. 35
5.5 system-time dst recurring ......................................................................................................... 36
5.6 hostname ......................................................................................................................................... 37
5.7 location ............................................................................................................................................. 38
5.8 contact-info .................................................................................................................................... 38
5.9 ip address ........................................................................................................................................ 39
5.10 ip address-alloc ............................................................................................................................. 40
5.11 reset .................................................................................................................................................. 41
5.12 reboot ............................................................................................................................................... 41
5.13 reboot-schedule ........................................................................................................................... 42
5.14 copy running-config startup-config ....................................................................................... 43
5.15 copy startup-config tftp ............................................................................................................. 43
5.16 copy tftp startup-config ............................................................................................................. 44
5.17 copy backup-config tftp ............................................................................................................. 45
5.18 copy backup-config startup-config ....................................................................................... 45
5.19 copy running-config backup-config ...................................................................................... 46
5.20 copy tftp backup-config ............................................................................................................. 46
5.21 boot application ............................................................................................................................ 47
5.22 boot config ...................................................................................................................................... 48
5.23 remove backup-image ................................................................................................................ 48
5.24 firmware upgrade .......................................................................................................................... 49
5.25 ping .................................................................................................................................................... 50
5.26 tracert ............................................................................................................................................... 51
5.27 show system-info ......................................................................................................................... 52
5.28 show image-info ............................................................................................................................ 52
5.29 show boot ........................................................................................................................................ 53
5.30 show running-config .................................................................................................................... 53
5.31 show startup-config .................................................................................................................... 54
5.32 show system-time ........................................................................................................................ 54
5.33 show system-time dst ................................................................................................................. 55
5.34 show system-time ntp ................................................................................................................ 55
5.35 show cable-diagnostics interface........................................................................................... 56
5.36 show cpu-utilization ..................................................................................................................... 56
III
5.37 show memory-utilization ............................................................................................................ 57
Chapter 6 EEE Configuration Commands ................................................................ 58
6.1 eee ..................................................................................................................................................... 58
6.2 show interface eee ....................................................................................................................... 58
Chapter 7 SDM Template Commands ....................................................................... 60
7.1 sdm prefer ....................................................................................................................................... 60
7.2 show sdm prefer ........................................................................................................................... 61
Chapter 8 Time Range Commands ............................................................................ 62
8.1 time-range ....................................................................................................................................... 62
8.2 absolute ........................................................................................................................................... 62
8.3 periodic ............................................................................................................................................ 63
8.4 holiday (time-range mode) ......................................................................................................... 64
8.5 holiday .............................................................................................................................................. 65
8.6 show holiday ................................................................................................................................... 65
8.7 show time-range ........................................................................................................................... 66
Chapter 9 Port Configuration Commands ............................................................... 67
9.1 interface gigabitEthernet ........................................................................................................... 67
9.2 interface range gigabitEthernet............................................................................................... 67
9.3 description ...................................................................................................................................... 68
9.4 shutdown ......................................................................................................................................... 69
9.5 flow-control .................................................................................................................................... 70
9.6 duplex ............................................................................................................................................... 70
9.7 jumbo-size ....................................................................................................................................... 71
9.8 speed ................................................................................................................................................ 71
9.9 clear counters ................................................................................................................................ 72
9.10 show interface status .................................................................................................................. 73
9.11 show interface counters ............................................................................................................ 73
9.12 show interface configuration .................................................................................................... 74
9.13 show fiber-ports ............................................................................................................................ 75
Chapter 10 Port Isolation Commands ......................................................................... 76
10.1 port isolation................................................................................................................................... 76
10.2 show port isolation interface .................................................................................................... 77
Chapter 11 Loopback Detection Commands ............................................................ 78
11.1 loopback-detection (global) ...................................................................................................... 78
IV
11.2 loopback-detection interval ...................................................................................................... 78
11.3 loopback-detection recovery-time ........................................................................................ 79
11.4 loopback-detection (interface) ................................................................................................ 80
11.5 loopback-detection config process-mode ......................................................................... 80
11.6 loopback-detection recover ..................................................................................................... 81
11.7 show loopback-detection global............................................................................................. 82
11.8 show loopback-detection interface ....................................................................................... 82
Chapter 12 Etherchannel Commands ......................................................................... 84
12.1 channel-group ............................................................................................................................... 84
12.2 port-channel load-balance ........................................................................................................ 85
12.3 lacp system-priority ..................................................................................................................... 86
12.4 lacp port-priority ........................................................................................................................... 87
12.5 show etherchannel ....................................................................................................................... 87
12.6 show etherchannel load-balance ............................................................................................ 88
12.7 show lacp ......................................................................................................................................... 89
12.8 show lacp sys-id ............................................................................................................................ 89
Chapter 13 MAC Address Commands ......................................................................... 91
13.1 mac address-table static ........................................................................................................... 91
13.2 mac address-table aging-time ................................................................................................. 92
13.3 mac address-table filtering ....................................................................................................... 92
13.4 mac address-table max-mac-count ...................................................................................... 93
13.5 show mac address-table ............................................................................................................ 95
13.6 clear mac address-table ............................................................................................................ 95
13.7 show mac address-table aging-time ..................................................................................... 96
13.8 show mac address-table max-mac-count ........................................................................... 96
13.9 show mac address-table interface ......................................................................................... 97
13.10 show mac address-table count ............................................................................................... 97
13.11 show mac address-table address .......................................................................................... 98
13.12 show mac address-table vlan ................................................................................................... 99
Chapter 14 IEEE 802.1Q VLAN Commands .............................................................. 100
14.1 vlan .................................................................................................................................................. 100
14.2 name ............................................................................................................................................... 101
14.3 switchport general allowed vlan ........................................................................................... 101
14.4 switchport pvid ........................................................................................................................... 102
14.5 switchport check ingress ........................................................................................................ 103
14.6 switchport acceptable frame ................................................................................................ 103
V
14.7 show vlan summary................................................................................................................... 104
14.8 show vlan brief ............................................................................................................................ 105
14.9 show vlan ...................................................................................................................................... 105
14.10 show interface switchport ...................................................................................................... 106
Chapter 15 MAC-based VLAN Commands ............................................................... 107
15.1 mac-vlan mac-address ............................................................................................................ 107
15.2 mac-vlan ....................................................................................................................................... 108
15.3 show mac-vlan ............................................................................................................................ 108
15.4 show mac-vlan interface ......................................................................................................... 109
Chapter 16 Protocol-based VLAN Commands ....................................................... 110
16.1 protocol-vlan template ............................................................................................................ 110
16.2 protocol-vlan vlan ...................................................................................................................... 111
16.3 protocol-vlan group .................................................................................................................. 112
16.4 show protocol-vlan template ................................................................................................. 112
16.5 show protocol-vlan vlan .......................................................................................................... 113
Chapter 17 IGMP Snooping Commands.................................................................... 114
17.1 ip igmp snooping (global) ........................................................................................................ 114
17.2 ip igmp snooping version ........................................................................................................ 114
17.3 ip igmp snooping drop-unknown ......................................................................................... 115
17.4 ip igmp snooping header-validation .................................................................................... 116
17.5 ip igmp snooping vlan-config ................................................................................................ 116
17.6 ip igmp snooping vlan-config (immediate-leave)............................................................ 118
17.7 ip igmp snooping vlan-config (report-suppression) ...................................................... 118
17.8 ip igmp snooping vlan-config (router-ports-forbidden) ............................................... 119
17.9 ip igmp snooping vlan-config (rport interface) ................................................................ 120
17.10 ip igmp snooping vlan-config (static) .................................................................................. 121
17.11 ip igmp snooping vlan-config (querier) ............................................................................... 122
17.12 ip igmp snooping (interface) .................................................................................................. 123
17.13 ip igmp snooping max-groups .............................................................................................. 124
17.14 ip igmp snooping immediate-leave ..................................................................................... 125
17.15 ip igmp profile ............................................................................................................................. 125
17.16 deny ................................................................................................................................................ 126
17.17 permit ............................................................................................................................................. 126
17.18 range .............................................................................................................................................. 127
17.19 ip igmp filter ................................................................................................................................. 128
17.20 clear ip igmp snooping statistics ......................................................................................... 128
VI
17.21 show ip igmp snooping ............................................................................................................ 129
17.22 show ip igmp snooping interface ......................................................................................... 129
17.23 show ip igmp snooping vlan ................................................................................................... 130
17.24 show ip igmp snooping groups ............................................................................................. 131
17.25 show ip igmp profile .................................................................................................................. 132
Chapter 18 MLD Snooping Commands ..................................................................... 133
18.1 ipv6 mld snooping (global) ...................................................................................................... 133
18.2 ipv6 mld snooping drop-unknown ....................................................................................... 133
18.3 ipv6 mld snooping vlan-config .............................................................................................. 134
18.4 ipv6 mld snooping vlan-config (immediate-leave) ......................................................... 135
18.5 ipv6 mld snooping vlan-config (report-suppression) .................................................... 136
18.6 ipv6 mld snooping vlan-config (router-ports-forbidden) ............................................. 137
18.7 ipv6 mld snooping vlan-config (rport interface) .............................................................. 138
18.8 ipv6 mld snooping vlan-config (static) ............................................................................... 138
18.9 ipv6 mld snooping vlan-config (querier) ............................................................................ 139
18.10 ipv6 mld snooping (interface) ................................................................................................ 141
18.11 ipv6 mld snooping max-groups ............................................................................................ 141
18.12 ipv6 mld snooping immediate-leave ................................................................................... 142
18.13 ipv6 mld profile ........................................................................................................................... 143
18.14 deny ................................................................................................................................................ 144
18.15 permit ............................................................................................................................................. 144
18.16 range .............................................................................................................................................. 145
18.17 ipv6 mld filter ............................................................................................................................... 145
18.18 clear ipv6 mld snooping statistics ....................................................................................... 146
18.19 show ipv6 mld snooping .......................................................................................................... 146
18.20 show ipv6 mld snooping interface ....................................................................................... 147
18.21 show ipv6 mld snooping vlan ................................................................................................. 148
18.22 show ipv6 mld snooping groups .......................................................................................... 148
18.23 show ipv6 mld profile ................................................................................................................ 149
Chapter 19 MVR Commands ........................................................................................ 150
19.1 mvr (global) ................................................................................................................................... 150
19.2 mvr group ..................................................................................................................................... 150
19.3 mvr mode ...................................................................................................................................... 151
19.4 mvr querytime ............................................................................................................................. 152
19.5 mvr vlan ......................................................................................................................................... 153
19.6 mvr (interface) ............................................................................................................................. 153
VII
19.7 mvr type ........................................................................................................................................ 154
19.8 mvr immediate ............................................................................................................................ 155
19.9 mvr vlan (group) .......................................................................................................................... 155
19.10 show mvr ...................................................................................................................................... 156
19.11 show mvr interface .................................................................................................................... 157
19.12 show mvr members .................................................................................................................. 157
19.13 show mvr traffic .......................................................................................................................... 158
Chapter 20 MSTP Commands ...................................................................................... 159
20.1 debug spanning-tree ................................................................................................................ 159
20.2 spanning-tree (global) .............................................................................................................. 160
20.3 spanning-tree (interface) ........................................................................................................ 160
20.4 spanning-tree common-config ............................................................................................. 161
20.5 spanning-tree mode ................................................................................................................. 162
20.6 spanning-tree mst configuration ......................................................................................... 163
20.7 instance ......................................................................................................................................... 163
20.8 name ............................................................................................................................................... 164
20.9 revision .......................................................................................................................................... 165
20.10 spanning-tree mst instance ................................................................................................... 166
20.11 spanning-tree mst ..................................................................................................................... 166
20.12 spanning-tree priority .............................................................................................................. 167
20.13 spanning-tree timer .................................................................................................................. 168
20.14 spanning-tree hold-count ....................................................................................................... 169
20.15 spanning-tree max-hops ......................................................................................................... 169
20.16 spanning-tree bpdufilter ......................................................................................................... 170
20.17 spanning-tree bpduflood ........................................................................................................ 171
20.18 spanning-tree bpduguard ....................................................................................................... 171
20.19 spanning-tree guard loop ....................................................................................................... 172
20.20 spanning-tree guard root ........................................................................................................ 173
20.21 spanning-tree guard tc ............................................................................................................ 173
20.22 spanning-tree mcheck ............................................................................................................. 174
20.23 show spanning-tree active ..................................................................................................... 174
20.24 show spanning-tree bridge .................................................................................................... 175
20.25 show spanning-tree interface ............................................................................................... 175
20.26 show spanning-tree interface-security ............................................................................. 176
20.27 show spanning-tree mst ......................................................................................................... 177
VIII
Chapter 21 LLDP Commands ....................................................................................... 179
21.1 lldp................................................................................................................................................... 179
21.2 lldp forward_message .............................................................................................................. 179
21.3 lldp hold-multiplier ..................................................................................................................... 180
21.4 lldp timer ....................................................................................................................................... 181
21.5 lldp receive ................................................................................................................................... 182
21.6 lldp transmit ................................................................................................................................. 182
21.7 lldp snmp-trap ............................................................................................................................. 183
21.8 lldp tlv-select ............................................................................................................................... 184
21.9 lldp management-address ..................................................................................................... 184
21.10 lldp med-fast-count .................................................................................................................. 185
21.11 lldp med-status ........................................................................................................................... 186
21.12 lldp med-tlv-select .................................................................................................................... 186
21.13 lldp med-location ....................................................................................................................... 187
21.14 show lldp ....................................................................................................................................... 188
21.15 show lldp interface .................................................................................................................... 188
21.16 show lldp local-information interface ................................................................................. 189
21.17 show lldp neighbor-information interface ......................................................................... 190
21.18 show lldp traffic interface ....................................................................................................... 190
Chapter 22 Static Routes Commands ....................................................................... 192
22.1 ip routing ....................................................................................................................................... 192
22.2 interface vlan ............................................................................................................................... 192
22.3 interface loopback .................................................................................................................... 193
22.4 switchport .................................................................................................................................... 193
22.5 interface range port-channel ................................................................................................. 194
22.6 description ................................................................................................................................... 195
22.7 shutdown ...................................................................................................................................... 195
22.8 interface port-channel ............................................................................................................. 196
22.9 ip route .......................................................................................................................................... 197
22.10 ipv6 routing .................................................................................................................................. 197
22.11 ipv6 route ...................................................................................................................................... 198
22.12 show interface vlan ................................................................................................................... 199
22.13 show ip interface ........................................................................................................................ 199
22.14 show ip interface brief .............................................................................................................. 200
22.15 show ip route ............................................................................................................................... 200
22.16 show ip route specify ............................................................................................................... 201
22.17 show ip route summary ........................................................................................................... 202
IX
22.18 show ipv6 interface ................................................................................................................... 202
22.19 show ipv6 route .......................................................................................................................... 203
22.20 show ipv6 route summary ...................................................................................................... 203
Chapter 23 IPv6 Address Configuration Commands ............................................ 205
23.1 ipv6 enable ................................................................................................................................... 205
23.2 ipv6 address autoconfig.......................................................................................................... 205
23.3 ipv6 address link-local ............................................................................................................. 206
23.4 ipv6 address dhcp ..................................................................................................................... 207
23.5 ipv6 address ra ........................................................................................................................... 207
23.6 ipv6 address eui-64 .................................................................................................................. 208
23.7 ipv6 address ................................................................................................................................ 209
23.8 show ipv6 interface ................................................................................................................... 210
Chapter 24 ARP Commands ......................................................................................... 211
24.1 arp ................................................................................................................................................... 211
24.2 clear arp-cache .......................................................................................................................... 212
24.3 arp dynamicrenew ..................................................................................................................... 212
24.4 arp timeout ................................................................................................................................... 213
24.5 gratuitous-arp intf-status-up enable .................................................................................. 213
24.6 gratuitous-arp dup-ip-detected enable ............................................................................. 214
24.7 gratuitous-arp learning enable .............................................................................................. 214
24.8 gratuitous-arp send-interval .................................................................................................. 215
24.9 ip proxy-arp.................................................................................................................................. 216
24.10 ip local-proxy-arp ...................................................................................................................... 216
24.11 show arp ........................................................................................................................................ 217
24.12 show ip arp (interface) .............................................................................................................. 218
24.13 show ip arp summary................................................................................................................ 218
24.14 show gratuitous-arp ................................................................................................................. 219
24.15 show ip proxy-arp ...................................................................................................................... 219
Chapter 25 DHCP Server Commands ........................................................................ 221
25.1 service dhcp server .................................................................................................................. 221
25.2 ip dhcp server extend-option capwap-ac-ip.................................................................... 221
25.3 ip dhcp server extend-option vendor-class-id ............................................................... 222
25.4 ip dhcp server exclude-address ........................................................................................... 223
25.5 ip dhcp server pool ................................................................................................................... 224
25.6 ip dhcp server ping timeout ................................................................................................... 224
25.7 ip dhcp server ping packets ................................................................................................... 225
X
25.8 network ......................................................................................................................................... 226
25.9 lease ............................................................................................................................................... 226
25.10 address hardware-address .................................................................................................... 227
25.11 address client-identifier .......................................................................................................... 228
25.12 default-gateway ......................................................................................................................... 228
25.13 dns-server .................................................................................................................................... 229
25.14 netbios-name-server ............................................................................................................... 230
25.15 netbios-node-type .................................................................................................................... 231
25.16 next-server ................................................................................................................................... 231
25.17 domain-name .............................................................................................................................. 232
25.18 bootfile .......................................................................................................................................... 233
25.19 show ip dhcp server status .................................................................................................... 233
25.20 show ip dhcp server statistics............................................................................................... 234
25.21 show ip dhcp server extend-option .................................................................................... 234
25.22 show ip dhcp server pool ........................................................................................................ 235
25.23 show ip dhcp server excluded-address ............................................................................ 235
25.24 show ip dhcp server manual-binding .................................................................................. 236
25.25 show ip dhcp server binding .................................................................................................. 236
25.26 clear ip dhcp server statistics ............................................................................................... 237
25.27 clear ip dhcp server binding ................................................................................................... 237
Chapter 26 DHCP Relay Commands .......................................................................... 239
26.1 service dhcp relay ..................................................................................................................... 239
26.2 ip dhcp relay hops ..................................................................................................................... 239
26.3 ip dhcp relay time ....................................................................................................................... 240
26.4 ip helper-address....................................................................................................................... 241
26.5 ip dhcp relay information ........................................................................................................ 241
26.6 ip dhcp relay information strategy ....................................................................................... 242
26.7 ip dhcp relay information format .......................................................................................... 243
26.8 ip dhcp relay information circuit-id ...................................................................................... 244
26.9 ip dhcp relay information remote-id .................................................................................... 244
26.10 ip dhcp relay default-interface .............................................................................................. 245
26.11 ip dhcp relay vlan ....................................................................................................................... 246
26.12 show ip dhcp relay ..................................................................................................................... 246
Chapter 27 DHCP L2 Relay Commands .................................................................... 248
27.1 ip dhcp l2relay ............................................................................................................................. 248
27.2 ip dhcp l2relay vlan .................................................................................................................... 248
XI
27.3 ip dhcp l2relay information ..................................................................................................... 249
27.4 ip dhcp l2relay information strategy ................................................................................... 249
27.5 ip dhcp l2relay information format....................................................................................... 250
27.6 ip dhcp l2relay information circuit-id .................................................................................. 251
27.7 ip dhcp l2relay information remote-id ................................................................................ 252
27.8 show ip dhcp l2relay ................................................................................................................. 252
27.9 show ip dhcp l2relay interface .............................................................................................. 253
Chapter 28 QoS Commands ......................................................................................... 254
28.1 qos trust mode ........................................................................................................................... 254
28.2 qos port-priority ......................................................................................................................... 255
28.3 qos cos-map ............................................................................................................................... 255
28.4 qos dot1p-remap ....................................................................................................................... 256
28.5 qos dscp-map ............................................................................................................................. 257
28.6 qos dscp-remap ......................................................................................................................... 258
28.7 qos queue bandwidth ............................................................................................................... 258
28.8 qos queue mode ........................................................................................................................ 259
28.9 show qos cos-map .................................................................................................................... 260
28.10 show qos dot1p-remap ........................................................................................................... 261
28.11 show qos dscp-map ................................................................................................................. 261
28.12 show qos dscp-remap ............................................................................................................. 262
28.13 show qos port-priority interface........................................................................................... 262
28.14 show qos trust interface ......................................................................................................... 263
28.15 show qos queue interface ...................................................................................................... 263
Chapter 29 Bandwidth Control Commands ............................................................. 265
29.1 storm-control rate-mode ........................................................................................................ 265
29.2 storm-control .............................................................................................................................. 266
29.3 storm-control exceed .............................................................................................................. 267
29.4 storm-control recover ............................................................................................................. 268
29.5 bandwidth ..................................................................................................................................... 268
29.6 show storm-control .................................................................................................................. 269
29.7 show bandwidth ......................................................................................................................... 270
Chapter 30 Voice VLAN Commands .......................................................................... 271
30.1 voice vlan ...................................................................................................................................... 271
30.2 voice vlan (interface) ................................................................................................................. 271
30.3 voice vlan priority ....................................................................................................................... 272
30.4 voice vlan oui ............................................................................................................................... 273
XII
30.5 show voice vlan .......................................................................................................................... 273
30.6 show voice vlan oui-table........................................................................................................ 274
30.7 show voice vlan interface ....................................................................................................... 274
Chapter 31 Auto VoIP Commands .............................................................................. 276
31.1 auto-voip ....................................................................................................................................... 276
31.2 auto-voip (interface) ................................................................................................................. 276
31.3 auto-voip dot1p .......................................................................................................................... 277
31.4 auto-voip untagged .................................................................................................................. 278
31.5 auto-voip none ........................................................................................................................... 278
31.6 no auto-voip (interface) ........................................................................................................... 279
31.7 auto-voip dscp ............................................................................................................................ 279
31.8 auto-voip data priority .............................................................................................................. 280
31.9 show auto-voip ........................................................................................................................... 280
Chapter 32 Access Control Commands ................................................................... 282
32.1 user access-control ip-based enable ................................................................................. 282
32.2 user access-control ip-based ............................................................................................... 282
32.3 user access-control mac-based enable ............................................................................ 283
32.4 user access-control mac-based .......................................................................................... 284
32.5 user access-control port-based enable ............................................................................ 285
32.6 user access-control port-based .......................................................................................... 285
Chapter 33 HTTP and HTTPS Commands ................................................................ 287
33.1 ip http server ............................................................................................................................... 287
33.2 ip http port .................................................................................................................................... 288
33.3 ip http max-users ....................................................................................................................... 288
33.4 ip http session timeout ............................................................................................................ 289
33.5 ip http secure-server ................................................................................................................ 290
33.6 ip http secure-port .................................................................................................................... 290
33.7 ip http secure-protocol............................................................................................................ 291
33.8 ip http secure-ciphersuite ...................................................................................................... 292
33.9 ip http secure-max-users ....................................................................................................... 293
33.10 ip http secure-session timeout ............................................................................................. 294
33.11 ip http secure-server download certificate ...................................................................... 294
33.12 ip http secure-server download key ................................................................................... 295
33.13 show ip http configuration ...................................................................................................... 296
33.14 show ip http secure-server .................................................................................................... 296
XIII
Chapter 34 SSH Commands ......................................................................................... 298
34.1 ip ssh server ................................................................................................................................ 298
34.2 ip ssh port ..................................................................................................................................... 298
34.3 ip ssh version .............................................................................................................................. 299
34.4 ip ssh algorithm .......................................................................................................................... 300
34.5 ip ssh timeout .............................................................................................................................. 300
34.6 ip ssh max-client ........................................................................................................................ 301
34.7 ip ssh download .......................................................................................................................... 302
34.8 remove public-key ..................................................................................................................... 302
34.9 show ip ssh................................................................................................................................... 303
Chapter 35 Telnet Commands ..................................................................................... 304
35.1 telnet enable ................................................................................................................................ 304
35.2 telnet port ..................................................................................................................................... 304
35.3 show telnet-status..................................................................................................................... 305
Chapter 36 AAA Commands ........................................................................................ 306
36.1 tacacas-server host .................................................................................................................. 306
36.2 show tacacs-server .................................................................................................................. 307
36.3 radius-server host ..................................................................................................................... 308
36.4 show radius-server ................................................................................................................... 309
36.5 aaa group ...................................................................................................................................... 310
36.6 server ............................................................................................................................................. 311
36.7 show aaa group .......................................................................................................................... 311
36.8 aaa authentication login .......................................................................................................... 312
36.9 aaa authentication enable....................................................................................................... 313
36.10 aaa authentication dot1x default .......................................................................................... 314
36.11 aaa accounting dot1x default ................................................................................................ 315
36.12 show aaa authentication ......................................................................................................... 315
36.13 show aaa accounting ................................................................................................................ 316
36.14 line telnet ...................................................................................................................................... 316
36.15 login authentication (telnet) .................................................................................................... 317
36.16 line ssh ........................................................................................................................................... 318
36.17 login authentication (ssh) ........................................................................................................ 318
36.18 enable authentication (telnet) ................................................................................................ 319
36.19 enable authentication (ssh) .................................................................................................... 320
36.20 ip http login authentication ..................................................................................................... 320
36.21 ip http enable authentication ................................................................................................. 321
XIV
36.22 show aaa global .......................................................................................................................... 322
36.23 enable admin password ........................................................................................................... 322
36.24 enable admin secret ................................................................................................................. 323
36.25 enable-admin .............................................................................................................................. 324
Chapter 37 IEEE 802.1x Commands ........................................................................... 326
37.1 dot1x system-auth-control .................................................................................................... 326
37.2 dot1x handshake ....................................................................................................................... 327
37.3 dot1x auth-protocol .................................................................................................................. 327
37.4 dot1x vlan-assignment ............................................................................................................ 328
37.5 dot1x accounting ....................................................................................................................... 329
37.6 dot1x mab .................................................................................................................................... 330
37.7 dot1x guest-vlan ........................................................................................................................ 330
37.8 dot1x timeout quiet-period .................................................................................................... 331
37.9 dot1x timeout supp-timeout .................................................................................................. 332
37.10 dot1x max- req ........................................................................................................................... 333
37.11 dot1x .............................................................................................................................................. 333
37.12 dot1x port-control ..................................................................................................................... 334
37.13 dot1x port-method .................................................................................................................... 335
37.14 dot1x auth-init ............................................................................................................................. 336
37.15 dot1x auth-reauth ...................................................................................................................... 336
37.16 show dot1x global ..................................................................................................................... 337
37.17 show dot1x interface ................................................................................................................ 338
37.18 show dot1x auth-state ............................................................................................................. 338
Chapter 38 Port Security Commands ........................................................................ 340
38.1 mac address-table max-mac count .................................................................................... 340
38.2 show mac address-table max-mac-count ........................................................................ 340
Chapter 39 Port Mirroring Commands ...................................................................... 342
39.1 monitor session destination interface................................................................................ 342
39.2 monitor session source ........................................................................................................... 343
39.3 show monitor session .............................................................................................................. 344
Chapter 40 ACL Commands ......................................................................................... 345
40.1 access-list create ...................................................................................................................... 345
40.2 access-list resequence ........................................................................................................... 345
40.3 access-list mac .......................................................................................................................... 346
40.4 access-list ip ............................................................................................................................... 348
XV
40.5 access-list combined ............................................................................................................... 349
40.6 access-list ipv6 .......................................................................................................................... 351
40.7 access-list action....................................................................................................................... 353
40.8 redirect .......................................................................................................................................... 354
40.9 s-condition ................................................................................................................................... 355
40.10 s-mirror.......................................................................................................................................... 355
40.11 qos-remark .................................................................................................................................. 356
40.12 access bind .................................................................................................................................. 357
40.13 show access-list ........................................................................................................................ 358
40.14 show access-list bind ............................................................................................................... 358
40.15 show access-list status ........................................................................................................... 359
40.16 show access-list counter ........................................................................................................ 359
40.17 clear access-list ......................................................................................................................... 360
Chapter 41 IPv4 IMPB Commands .............................................................................. 361
41.1 ip source binding ....................................................................................................................... 361
41.2 ip dhcp snooping ....................................................................................................................... 362
41.3 ip dhcp snooping vlan .............................................................................................................. 363
41.4 ip dhcp snooping max-entries .............................................................................................. 363
41.5 show ip source binding ............................................................................................................ 364
41.6 show ip dhcp snooping ............................................................................................................ 365
41.7 show ip dhcp snooping interface ......................................................................................... 365
Chapter 42 IPv6 IMPB Commands .............................................................................. 367
42.1 Ipv6 source binding................................................................................................................... 367
42.2 ipv6 dhcp snooping .................................................................................................................. 368
42.3 ipv6 dhcp snooping vlan ......................................................................................................... 369
42.4 ipv6 dhcp snooping max-entries .......................................................................................... 369
42.5 ipv6 nd snooping ....................................................................................................................... 370
42.6 ipv6 nd snooping vlan .............................................................................................................. 371
42.7 ipv6 nd snooping max-entries ............................................................................................... 371
42.8 show ipv6 source binding ....................................................................................................... 372
42.9 show ipv6 dhcp snooping ....................................................................................................... 373
42.10 show ipv6 dhcp snooping interface .................................................................................... 373
42.11 show ipv6 nd snooping ............................................................................................................ 374
Chapter 43 IP Verify Source Commands .................................................................. 375
43.1 ip verify source ........................................................................................................................... 375
43.2 ip verify source logging ........................................................................................................... 376
XVI
43.3 show ip verify source ................................................................................................................ 376
43.4 show ip verify source interface ............................................................................................. 377
Chapter 44 IPv6 Verify Source Commands ............................................................. 378
44.1 ipv6 verify source ...................................................................................................................... 378
44.2 show ipv6 verify source ........................................................................................................... 379
44.3 show ipv6 verify source interface ........................................................................................ 379
Chapter 45 DHCPv4 Filter Commands ...................................................................... 381
45.1 ip dhcp filter ................................................................................................................................. 381
45.2 ip dhcp filter (interface) ............................................................................................................ 381
45.3 ip dhcp filter mac-verify ........................................................................................................... 382
45.4 ip dhcp filter limit rate ............................................................................................................... 383
45.5 ip dhcp filter decline rate ......................................................................................................... 384
45.6 ip dhcp filter server permit-entry ......................................................................................... 384
45.7 show ip dhcp filter ..................................................................................................................... 385
45.8 show ip dhcp filter interface ................................................................................................... 386
45.9 show ip dhcp filter server permit-entry .............................................................................. 386
Chapter 46 DHCPv6 Filter Commands ...................................................................... 388
46.1 ipv6 dhcp filter ............................................................................................................................ 388
46.2 ipv6 dhcp filter (interface) ....................................................................................................... 388
46.3 ipv6 dhcp filter limit rate .......................................................................................................... 389
46.4 ipv6 dhcp filter decline rate .................................................................................................... 390
46.5 ipv6 dhcp filter server permit-entry .................................................................................... 391
46.6 show ipv6 dhcp filter................................................................................................................. 392
46.7 show ipv6 dhcp filter interface .............................................................................................. 392
46.8 show ip dhcp filter server permit-entry .............................................................................. 393
Chapter 47 DoS Defend Commands .......................................................................... 394
47.1 ip dos-prevent ............................................................................................................................ 394
47.2 ip dos-prevent type................................................................................................................... 394
47.3 show ip dos-prevent ................................................................................................................. 396
Chapter 48 DLDP Commands ...................................................................................... 397
48.1 dldp (global) ................................................................................................................................. 397
48.2 dldp interval ................................................................................................................................. 397
48.3 dldp shut-mode .......................................................................................................................... 398
48.4 dldp(interface) ............................................................................................................................. 399
XVII
48.5 show dldp ..................................................................................................................................... 399
48.6 show dldp interface................................................................................................................... 400
Chapter 49 SNMP Commands ..................................................................................... 401
49.1 snmp-server ................................................................................................................................ 401
49.2 snmp-server view ...................................................................................................................... 401
49.3 snmp-server group ................................................................................................................... 402
49.4 snmp-server user ...................................................................................................................... 404
49.5 snmp-server community ......................................................................................................... 405
49.6 snmp-server host ...................................................................................................................... 406
49.7 snmp-server engineID ............................................................................................................. 408
49.8 snmp-server traps snmp ......................................................................................................... 409
49.9 snmp-server traps ..................................................................................................................... 410
49.10 snmp-server traps vlan ............................................................................................................ 411
49.11 snmp-server traps security .................................................................................................... 412
49.12 snmp-server traps acl .............................................................................................................. 413
49.13 snmp-server traps ip ................................................................................................................ 413
49.14 snmp-server traps link-status ............................................................................................... 414
49.15 rmon history ................................................................................................................................ 414
49.16 rmon event ................................................................................................................................... 415
49.17 rmon alarm ................................................................................................................................... 416
49.18 rmon statistics ............................................................................................................................ 418
49.19 show snmp-server..................................................................................................................... 419
49.20 show snmp-server view ........................................................................................................... 419
49.21 show snmp-server group ........................................................................................................ 420
49.22 show snmp-server user ........................................................................................................... 420
49.23 show snmp-server community ............................................................................................. 421
49.24 show snmp-server host ........................................................................................................... 421
49.25 show snmp-server engineID .................................................................................................. 421
49.26 show rmon history ..................................................................................................................... 422
49.27 show rmon event ....................................................................................................................... 422
49.28 show rmon alarm ........................................................................................................................ 423
49.29 show rmon statistics ................................................................................................................ 424
Chapter 50 ARP Inspection Commands .................................................................... 425
50.1 ip arp inspection ......................................................................................................................... 425
50.2 ip arp inspection validate ........................................................................................................ 425
50.3 ip arp inspection vlan ................................................................................................................ 426
XVIII
50.4 ip arp inspection vlan logging ................................................................................................ 427
50.5 ip arp inspection trust .............................................................................................................. 428
50.6 ip arp inspection limit-rate ...................................................................................................... 428
50.7 ip arp inspection burst-interval ............................................................................................. 429
50.8 ip arp inspection recover ........................................................................................................ 430
50.9 show ip arp inspection ............................................................................................................. 430
50.10 show ip arp inspection interface .......................................................................................... 431
50.11 show ip arp inspection vlan .................................................................................................... 432
50.12 show ip arp inspection statistics .......................................................................................... 432
50.13 clear ip arp inspection statistics ........................................................................................... 433
Chapter 51 ND Detection Commands ....................................................................... 434
51.1 ipv6 nd detection ....................................................................................................................... 434
51.2 ipv6 nd detection vlan .............................................................................................................. 434
51.3 ipv6 nd detection vlan logging .............................................................................................. 435
51.4 ipv6 nd detection trust ............................................................................................................. 435
51.5 show ipv6 nd detection ........................................................................................................... 436
51.6 show ipv6 nd detection interface ......................................................................................... 436
51.7 show ipv6 nd detection vlan .................................................................................................. 437
Chapter 52 System Log Commands .......................................................................... 438
52.1 logging buffer .............................................................................................................................. 438
52.2 logging buffer level .................................................................................................................... 438
52.3 logging file flash ......................................................................................................................... 439
52.4 logging file flash frequency .................................................................................................... 440
52.5 logging file flash level ............................................................................................................... 441
52.6 logging host index ..................................................................................................................... 441
52.7 logging console .......................................................................................................................... 442
52.8 logging console level ................................................................................................................ 443
52.9 logging monitor .......................................................................................................................... 444
52.10 logging monitor level ................................................................................................................ 444
52.11 clear logging ................................................................................................................................ 445
52.12 show logging local-config....................................................................................................... 446
52.13 show logging loghost ............................................................................................................... 446
52.14 show logging buffer .................................................................................................................. 447
52.15 show logging flash ..................................................................................................................... 447
XIX
Preface
This Guide is intended for network administrator to provide referenced information about CLI
(Command Line Interface). The device mentioned in this Guide stands for T1700G-28TQ
without any explanation.
Some models featured in this guide may be unavailable in your country or region. For local
sales information, visit https://www.tp-link.com.
Overview of this Guide
Chapter 1: Using the CLI
Provide information about how to use the CLI, CLI Command Modes, Security Levels and some
Conventions.
Chapter 2: User Interface
Provide information about the commands used to switch between five CLI Command Modes.
Chapter 3: Stack
Provide information about the commands used for configuring stack.
Chapter 4: User Management Commands
Provide information about the commands used for user management.
Chapter 5: System Configuration Commands
Provide information about the commands used for configuring the System information and
System IP, reboot and reset the switch, upgrade the switch system and commands used for
cable test.
Chapter 6: EEE Configuration Commands
Provide information about the commands used for configuring EEE.
Chapter 7: SDM Template Commands
Provide information about the commands used for configuring the SDM templates.
Chapter 8: Time Range Commands
Provide information about the commands used for configuring the time range.
Chapter 9: Port Configuration Commands
Provide information about the commands used for configuring the Speed, Negotiation Mode,
and Flow Control for Ethernet ports.
Chapter 10: Port Isolation Commands
Provide information about the commands used for configuring Port Isolation function.
1
Chapter 11: Loopback Detection Commands
Provide information about the commands used for configuring the Loopback Detection
function.
Chapter 12: Etherchannel Commands
Provide information about the commands used for configuring LAG (Link Aggregation Group)
and LACP (Link Aggregation Control Protocol).
Chapter 13: MAC Address Commands
Provide information about the commands used for Address configuration.
Chapter 14: IEEE 802.1Q VLAN Commands
Provide information about the commands used for configuring IEEE 802.1Q VLAN.
Chapter 15: MAC-based VLAN Commands
Provide information about the commands used for configuring MAC-based VLAN.
Chapter 16: Protocol-based VLAN Commands
Provide information about the commands used for configuring Protocol VLAN.
Chapter 17: IGMP Snooping Commands
Provide information about the commands used for configuring the IGMP Snooping (Internet
Group Management Protocol Snooping).
Chapter 18: MLD Snooping Commands
Provide information about the commands used for configuring the MLD Snooping (Multicast
Listener Discovery Snooping).
Chapter 19: MVR Commands
Provide information about the commands used for configuring the MVR.
Chapter 20: MSTP Commands
Provide information about the commands used for configuring the MSTP (Multiple Spanning
Tree Protocol).
Chapter 21: LLDP Commands
Provide information about the commands used for configuring LLDP function.
Chapter 21: Static Routes Commands
Provide information about the commands used for configuring the Static Route function.
Chapter 23: IPv6 Address Configuration Commands
Provide information about the commands used for configuring the System IPv6 addresses.
Chapter 24: ARP Commands
Provide information about the commands used for configuring the ARP (Address Resolution
Protocol) functions.
2
Chapter 25: DHCP Server Commands
Provide information about the commands used for configuring the DHCP Server function.
Chapter 26: DHCP Relay Commands
Provide information about the commands used for configuring the DHCP Relay function.
Chapter 27: DHCP L2 Relay Commands
Provide information about the commands used for configuring the DHCP L2 Relay function.
Chapter 28: QoS Commands
Provide information about the commands used for configuring the QoS function.
Chapter 29: Bandwidth Commands
Provide information about the commands used for configuring the Bandwidth Control.
Chapter 30: Voice VLAN Commands
Provide information about the commands used for configuring Voice VLAN.
Chapter 31 Auto VoIP Commands
Provide information about the commands used for configuring Auto VoIP.
Chapter 32 Access Control Commands
Provide information about the commands used for configuring Access Control.
Chapter 33: HTTP and HTTPS Commands
Provide information about the commands used for configuring the HTTP and HTTPS logon.
Chapter 34: SSH Commands
Provide information about the commands used for configuring and managing SSH (Security
Shell).
Chapter 35: Telnet Commands
Provide information about the commands used for configuring and managing SSH (Security
Shell).
Chapter 36: AAA Commands
Provide information about the commands used for configuring AAA (authentication,
authorization and accounting).
Chapter 37: IEEE 802.1X Commands
Provide information about the commands used for configuring IEEE 802.1X function.
Chapter 38 Port Security Commands
Provide information about the commands used for configuring Port Security.
Chapter 39: Port Mirroring Commands
Provide information about the commands used for configuring the Port Mirror function.
3
Chapter 40: ACL Commands
Provide information about the commands used for configuring the ACL (Access Control List).
Chapter 41: IPv4 IMPB Commands
Provide information about the commands used for binding the IP address, MAC address, VLAN
and the connected Port number of the Host together.
Chapter 42: IPv6 IMPB Commands
Provide information about the commands used for binding the IPv6 address, MAC address,
VLAN and the connected Port number of the Host together.
Chapter 43: IP Verify Source Commands
Provide information about the commands used for guarding the IP Source by filtering the IP
packets based on the IP-MAC Binding entries.
Chapter 44: IPv6 Verify Source Commands
Provide information about the commands used for guarding the IPv6 Source by filtering the IP
packets based on the IP-MAC Binding entries.
Chapter 45: DHCPv4 Filter Commands
Provide information about the commands used for configuring the DHCPv4 Filter.
Chapter 46: DHCPv6 Filter Commands
Provide information about the commands used for configuring the DHCPv6 Filter.
Chapter 47: DoS Defend Command
Provide information about the commands used for DoS defend and detecting the DoS attack.
Chapter 48: DLDP Commands
Provide information about the commands used for configuring the DLDP (Device Link
Detection Protocol).
Chapter 49: SNMP Commands
Provide information about the commands used for configuring the SNMP (Simple Network
Management Protocol) functions.
Chapter 50: ARP Inspection Commands
Provide information about the commands used for protecting the switch from the ARP
cheating or ARP Attack.
Chapter 51: ND Detection Commands
Provide information about the commands used for configuring ND detection.
Chapter 52: System Log Commands
Provide information about the commands used for configuring system log.
4
Chapter 1 Using the CLI
1.1 Accessing the CLI
You can log on to the switch and access the CLI by logging on to the switch remotely by a
Telnet or SSH connection through an Ethernet port.
1.1.1 Logon by Telnet
To log on to the switch by a Telnet connection, please take the following steps:
1. Click Start and type in cmd in the Search programs and files window and press the Enter
button.
Figure 1-1 Run Window
2. Type in telnet 192.168.0.1 in the cmd window and press Enter.
Figure 1-2 Type in the telnet command
5
3. Type in the login username and password (both admin by default). Press Enter and you will
enter User EXEC Mode.
Figure 1 3 Log in the Switch
Note: The first time you log in, change the password to better protect your network and
devices.
4. Type in enable command and you will enter Privileged EXEC Mode. By default no password
is needed. Later you can set a password for users who want to access the Privileged EXEC
Mode.
Figure 1-4 Enter into Priviledged EXEC Mode
1.1.2 Logon by SSH
To log on by SSH, a Putty client software is recommended. There are two authentication modes
to set up an SSH connection:
Password Authentication Mode: It requires username and password, which are both admin by
default.
Key Authentication Mode: It requires a public key for the switch and a private key for the SSH
client software. You can generate the public key and the private key through Putty Key
Generator.
Note:
1. Before SSH login, please follow the steps shown in Figure 1-5 to enable the SSH function
through Telnet connection.
2. The first time you log in, change the password to better protect your network and devices.
6
Figure 1-5 Enable SSH function
• Password Authentication Mode
1. Open the software to log on to the interface of PuTTY. Enter the IP address of the switch
into Host Name field; keep the default value 22 in the Port field; select SSH as the
Connection type.
Figure 1-6 SSH Connection Config
2. Click the Open button in the above figure to log on to the switch. Enter the login user name
and password to log on the switch, and then enter enable to enter Privileged EXEC Mode,
so you can continue to configure the switch.
7
Figure 1-7 Log on the Switch
• Key Authentication Mode
1. Select the key type and key length, and generate SSH key.
Figure 1-8 Generate SSH Key
Note:
1. The key length is in the range of 512 to 3072 bits.
2. During the key generation, randomly moving the mouse quickly can accelerate the key
generation.
8
2. After the key is successfully generated, please save the public key and private key to a
TFTP server.
Figure 1-9 Save the Generated Key
3. Log on to the switch by Telnet and download the public key file from the TFTP server to the
switch, as the following figure shows:
Figure 1-10 Download the Public Key
9
Note:
1. The key type should accord with the type of the key file.
2. The SSH key downloading can not be interrupted.
4. After the public key is downloaded, please log on to the interface of PuTTY and enter the IP
address for login.
Figure 1-11 SSH Connection Config
10
Loading...