New Switch

This Automation Manager object creates a new virtual switch on one or more virtual machine hosts.

Input Parameters

Name	Type	Required	Description
Name	String	Yes	Switch to be created.
Net Adapter Name	String	No	Network adapter to be bound to the switch to be created. You can use the Get-NetAdapter cmdlet to get the interface description of a network adapter.
Allow Management OS	Boolean	No	Specifies if the parent partition has access to the physical NIC bound to the virtual switch.
Minimum Bandwidth Mode	Selector	No	Minimum bandwidth is to be configured on the virtual switch. Allowed values are Absolute, Default, None, or Weight. If Absolute is specified, minimum bandwidth is bits per second. If Weight is specified, minimum bandwidth is a value ranging from 1 to 100. If None is specified, minimum bandwidth is disabled on the switch – that is, users cannot configure it on any network adapter connected to the switch. If Default is specified, the system will set the mode to Weight, if the switch is not IOV-enabled, or None if the switch is IOV-enabled.

Output Parameters

Name	Type	Description
Result	Number	Returns a success value of zero or any value other than zero to indicate failure.

Example Input Parameters

Name	Type	Required	Example
Name	String	Yes	Switch1
Net Adapter Name	String	Yes	Wired Internet Connection 3
Allow Management OS	Boolean	No	True
Min Bandwidth Mode	Selector	Yes	Absolute