VMNetwork
Applies To: System Center 2016 - Service Provider Foundation, System Center Technical Preview
VMNetwork
Manages virtual networks for Virtual Machine Manager (VMM).
HTTP Verbs
GET | POST | PUT | DELETE |
---|---|---|---|
Yes | Yes | Yes | Yes |
GET
Gets the specified virtual network objects.
If you supply the ID
property, the virtual network with that identifier is returned.
If you supply the Name
property, the virtual network with that name is returned.
If you supply the LogicalNetworkName
property, the virtual networks that are assigned to the specified logical network with this name are returned.
Entity Properties
Name | Type | Mandatory | Description |
---|---|---|---|
StampId | Edm.Guid | No | The identifier of the stamp that restricts the query. |
Name | Edm.String | No | The name of the virtual network. |
LogicalNetworkName | Edm.String | No | The name of the logical network that a virtual network is using. |
IsAssigned | Edm.Boolean | No | When this value is true , returns networks that are available to be used. When this value is false , returns networks that are unavailable to be used—networks that are not available in the console but are available from Windows PowerShell. |
ID | Edm.Guid | No | The identifier of the virtual network to retrieve. |
POST
Creates a new logical network.
Entity Properties
Name | Type | Mandatory | Description |
---|---|---|---|
StampId | Edm.Guid | Yes | The identifier of the stamp that restricts the query. |
Name | Edm.String | Yes | The name of the virtual network |
LogicalNetworkId | Edm.Guid | Yes | The logical network to assign the new virtual network to |
Description | Edm.String | No | The description of the virtual network |
IsolationType | Edm.String | No | Specifies an isolation type for the virtual network. Valid values are NoIsolation , WindowsNetworkVirtualization , External , VLANNetwork . |
RoutingDomainId | Edm.Guid | No | Specifies the ID of a routing domain in the form of a GUID. |
PROTipID | Edm.Guid | No | Specifies the ID of the PRO tip that triggered this action. This enables the auditing of PRO tips. |
PAIPAddressPoolType | Edm.String | No | Specifies an address pool type. Valid values are: IPV4, IPV6. |
ExternalName | Edm.String | No | Specifies an external name for an object. |
CAIPAddressPoolType | Edm.String | No | Specifies an address pool type. Valid values are: IPV4, IPV6. |
AutoCreateSubnet | Edm.Boolean | No | Indicates that a subnet is automatically created. |
PUT
Updates an existing virtual network.
Entity Properties
Name | Type | Mandatory | Description |
---|---|---|---|
ID | Edm.Guid | Yes | The identifier of the virtual network to update. |
StampId | Edm.Guid | Yes | The identifier of the stamp that restricts the query. |
Owner | UserAndRole | No | The owner of this object. |
GrantedToList | UserAndRole[] | No | The users or roles that are allowed to use this virtual network. Collection may be empty. |
DELETE
Deletes a virtual network.
Entity Properties
Name | Type | Mandatory | Description |
---|---|---|---|
StampId | Edm.Guid | Yes | The identifier of the stamp that restricts the query. |
ID | Edm.Guid | Yes | The identifier of the virtual network to delete. |