Set-VDSwitch
Syntax
[-ContactDetails <String>]
[-ContactName <String>]
[-LinkDiscoveryProtocol <LinkDiscoveryProtocol>]
[-LinkDiscoveryProtocolOperation <LinkDiscoveryOperation>]
[-MaxPorts <Int32>]
[-Mtu <Int32>]
[-Name <String>]
[-Notes <String>]
[-NumUplinkPorts <Int32>]
[-RunAsync]
[-Server <VIServer[]>]
[-Version <String>]
[CommonParameters]
Parameters
Required | Parameter Name | Type | Position | Features | Description |
---|---|---|---|---|---|
required |
|
VDSwitch[] | 1 |
|
Specifies the vSphere distributed switch that you want to configure. | optional |
|
String | named |
|
Specifies new contact details of the vSphere distributed switch administrator. | optional |
|
String | named |
|
Specifies a new name for the vSphere distributed switch administrator. | optional |
|
LinkDiscoveryProtocol | named |
|
Specifies the link discovery protocol for the vSphere distributed switch that you want to configure. This parameter accepts CDP and LLDP values. | optional |
|
LinkDiscoveryOperation | named |
|
Specifies the link discovery protocol operation for the vSphere distributed switch that you want to configure. This parameter accepts Advertise, Listen, Both, and Disabled values. | optional |
|
Int32 | named |
|
Specifies the maximum number of ports allowed on the vSphere distributed switch that you want to configure. | optional |
|
Int32 | named |
|
Specifies the maximum MTU size for the vSphere distributed switch that you want to configure. Valid values are positive integers only. | optional |
|
String | named |
|
Specifies a new name for the vSphere distributed switch that you want to configure. | optional |
|
String | named |
|
Specifies a new description for the vSphere distributed switch that you want to configure. | optional |
|
Int32 | named |
|
Specifies the number of uplink ports on the vSphere distributed switch that you want to configure. | optional |
|
SwitchParameter | named |
|
Indicates that the command returns immediately without waiting for the task to complete. In this mode, the output of the cmdlet is a Task object. For more information about the RunAsync parameter run "help About_RunAsync" in the VMware PowerCLI console. | optional |
|
VIServer[] | named |
|
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer. | optional |
|
String | named |
|
Specifies a new version for the vSphere distributed switch that you want to configure. This parameter accepts 4.0, 4.1.0, 5.0.0, 5.1.0, 5.5.0, and 6.0.0 values. You cannot specify a version that is incompatible with the version of the vCenter Server system you are connected to. |
-BackupPath <String>
[-RunAsync]
[-Server <VIServer[]>]
[-WithoutPortGroups]
[CommonParameters]
Parameters
Required | Parameter Name | Type | Position | Features | Description |
---|---|---|---|---|---|
required |
|
VDSwitch[] | 1 |
|
Specifies the vSphere distributed switch that you want to configure. | required |
|
String | named |
|
Specifies the full file path to the .zip file containing the backup configuration that you want to import. You can import only .zip files created with the Export-VDSwitch cmdlet. | optional |
|
SwitchParameter | named |
|
Indicates that the command returns immediately without waiting for the task to complete. In this mode, the output of the cmdlet is a Task object. For more information about the RunAsync parameter run "help About_RunAsync" in the VMware PowerCLI console. | optional |
|
VIServer[] | named |
|
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer. | optional |
|
SwitchParameter | named |
|
Indicates that the specified backup configuration is imported without its port groups. |
-RollBackConfiguration
[-RunAsync]
[-Server <VIServer[]>]
[CommonParameters]
Parameters
Required | Parameter Name | Type | Position | Features | Description |
---|---|---|---|---|---|
required |
|
VDSwitch[] | 1 |
|
Specifies the vSphere distributed switch that you want to configure. | required |
|
SwitchParameter | named |
|
Indicates that you want to rollback the configuration of the vSphere distributed switch to an earlier state. | optional |
|
SwitchParameter | named |
|
Indicates that the command returns immediately without waiting for the task to complete. In this mode, the output of the cmdlet is a Task object. For more information about the RunAsync parameter run "help About_RunAsync" in the VMware PowerCLI console. | optional |
|
VIServer[] | named |
|
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer. |
Output
VMware.VimAutomation.Vds.Types.V1.VDSwitch
Examples
Example 1
Modifies the maximum number of ports, the number of uplink ports, and the maximum MTU size of the specified vSphere distributed switch.
Example 2
Changes the version of all vSphere distributed switches whose names start with "MyVDSwitch".
Example 3
Enables link discovery protocol on the specified vSphere distributed switch, sets it to LLDP and changes the link discovery protocol operation to listen.
Example 4
Reconfigures the specified vSphere distributed switch by importing the specified backup profile. The original port groups are not recreated.
Example 5
Rollbacks the configuration of the specified vSphere distributed switch to its previous state.
Related Commands
VDSwitch
VDSwitchPhysicalNetworkAdapter
VDSwitchPrivateVlan