New Switch
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 |