To supply a configuration to a new switch before it joins the switch stack, use the switch provision command in global configuration mode on the active switch. To delete all configuration information that is associated with the removed switch (a stack member that has left the stack),
use the no form of this command.
switch stack-member-number provision type
no switch stack-member-number provision
Syntax Description
stack-member-number
|
Stack member number. The range is 1 to 8.
|
type
|
Switch type of the new switch before it joins the stack.
|
Command Default
The switch is not provisioned.
Command Modes
Global configuration
Command History
Release |
Modification |
Cisco IOS XE Fuji 16.9.2
|
This command was introduced.
|
Usage Guidelines
For type , enter the model number of a supported switch that is listed in the command-line help strings.
To avoid receiving an error message, you must remove the specified switch from the switch stack before using the no form of this command to delete a provisioned configuration.
To change the switch type, you must also remove the specified switch from the switch stack. You can change the stack member
number of a provisioned switch that is physically present in the switch stack if you do not also change the switch type.
If the switch type of the provisioned switch does not match the switch type in the provisioned configuration on the stack,
the switch stack applies the default configuration to the provisioned switch and adds it to the stack. The switch stack displays
a message when it applies the default configuration.
Provisioned information appears in the running configuration of the switch stack. When you enter the copy running-config startup-config privileged EXEC command, the provisioned configuration is saved in the startup configuration file of the switch stack.
![](https://www.cisco.com/content/dam/en/us/td/i/templates/caut.gif)
Caution
|
When you use the switch provision command, memory is allocated for the provisioned configuration. When a new switch type is configured, the previously allocated
memory is not fully released. Therefore, do not use this command more than approximately 200 times, or the switch will run
out of memory and unexpected behavior will result.
|
Examples
This example shows how to provision a switch with a stack member number of 2 for the switch stack. The show running-config command output shows the interfaces associated with the provisioned switch.
(config)# switch 2 provision WS-xxxx
(config)# end
# show running-config | include switch 2
!
interface GigabitEthernet2/0/1
!
interface GigabitEthernet2/0/2
!
interface GigabitEthernet2/0/3
<output truncated>
You also can enter the show switch user EXEC command to display the provisioning status of the switch stack.
This example shows how to delete all configuration information about stack member 5 when the switch is removed from the stack:
(config)# no switch 5 provision
You can verify that the provisioned switch is added to or removed from the running configuration by entering the show running-config privileged EXEC command.