Set-VMNetworkAdapterRoutingDomainMapping
Sets virtual subnets on a routing ___domain.
Syntax
Set-VMNetworkAdapterRoutingDomainMapping
[-VMNetworkAdapterName <String>]
[-CimSession <CimSession[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential[]>]
[-VMName] <String[]>
[-RoutingDomainID <Guid>]
[-RoutingDomainName <String>]
[-NewRoutingDomainName <String>]
[-IsolationID <Int32[]>]
[-IsolationName <String[]>]
[-Passthru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-VMNetworkAdapterRoutingDomainMapping
[-VMNetworkAdapter] <VMNetworkAdapterBase[]>
[-RoutingDomainID <Guid>]
[-RoutingDomainName <String>]
[-NewRoutingDomainName <String>]
[-IsolationID <Int32[]>]
[-IsolationName <String[]>]
[-Passthru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-VMNetworkAdapterRoutingDomainMapping
[-ManagementOS]
[-VMNetworkAdapterName <String>]
[-CimSession <CimSession[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential[]>]
[-RoutingDomainID <Guid>]
[-RoutingDomainName <String>]
[-NewRoutingDomainName <String>]
[-IsolationID <Int32[]>]
[-IsolationName <String[]>]
[-Passthru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-VMNetworkAdapterRoutingDomainMapping
[-VMNetworkAdapterName <String>]
[-VM] <VirtualMachine[]>
[-RoutingDomainID <Guid>]
[-RoutingDomainName <String>]
[-NewRoutingDomainName <String>]
[-IsolationID <Int32[]>]
[-IsolationName <String[]>]
[-Passthru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-VMNetworkAdapterRoutingDomainMapping
[-InputObject] <VMNetworkAdapterRoutingDomainSetting>
[-NewRoutingDomainName <String>]
[-IsolationID <Int32[]>]
[-IsolationName <String[]>]
[-Passthru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
The Set-VMNetworkAdapterRoutingDomainMapping cmdlet sets virtual subnets on a routing ___domain.
Examples
Example 1: Set a virtual subnet on a routing ___domain
PS C:\> Set-VMNetworkAdapterRoutingDomainMapping -VMName "Gateway01" -VMNetworkAdapterName "Internal NIC" -RoutingDomainID "{5a07361e-6a54-49fc-9210-bfbf14a5c56f}" -IsolationID 6001
This command sets the virtual subnet that has the ID 6001 for the specified routing ___domain. The command specifies that the routing ___domain is on the network adapter named Internal NIC that belongs to the multitenant virtual machine named Gateway01.
Parameters
-CimSession
Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session object, such as the output of a New-CimSession or Get-CimSession cmdlet. The default is the current session on the local computer.
Type: | CimSession[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputerName
Specifies an array of Hyper-V hosts. The cmdlet adds the virtual subnets to the routing ___domain on the Hyper-V hosts that you specify.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Specifies one or more user accounts that have permission to perform this action. The default is the current user.
Type: | PSCredential[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Specifies the input to this cmdlet. You can use this parameter, or you can pipe the input to this cmdlet.
Type: | VMNetworkAdapterRoutingDomainSetting |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-IsolationID
Specifies an array of IDs of virtual subnets. The cmdlet adds the virtual subnets that you specify to the routing ___domain. The subnets use VLAN or Hyper-V Network Virtualization. For more information about isolation IDs, see the Set-VMNetworkAdapterIsolation cmdlet.
Type: | Int32[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsolationName
Specifies an array of names of virtual subnets. The cmdlet adds the virtual subnets that you specify to the routing ___domain. The subnets use VLAN or Hyper-V Network Virtualization.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ManagementOS
Indicates that the cmdlet operates on the parent partition or host operating system.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewRoutingDomainName
Specifies a new name for the routing ___domain.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Passthru
Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RoutingDomainID
Specifies the ID of a routing ___domain. The ID of a routing ___domain is a system-assigned GUID. The cmdlet adds the virtual subnets to the routing ___domain that you specify.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RoutingDomainName
Specifies the name of a routing ___domain. The cmdlet adds the virtual subnets to the routing ___domain that you specify.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VM
Specifies an array of virtual machine objects. The cmdlet adds the virtual subnets to the routing ___domain from the network interfaces that belong to the virtual machines that you specify. To obtain a virtual machine object, use the Get-VM cmdlet.
Type: | VirtualMachine[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMName
Specifies an array of names of virtual machines. The cmdlet adds the virtual subnets to the routing ___domain from the network interfaces that belong to the virtual machines that you specify. To obtain a virtual machine object, use the Get-VM cmdlet.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMNetworkAdapter
Specifies an array of virtual network adapters as a VMNetworkAdapterBase object. The cmdlet adds the virtual subnets to the routing ___domain on the adapters that you specify. To obtain a network adapter, use the Get-VMNetworkAdapter cmdlet.
Type: | VMNetworkAdapterBase[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMNetworkAdapterName
Specifies the name of a virtual network adapter. The cmdlet adds the virtual subnets to the routing ___domain on the adapter that you specify.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Outputs
Microsoft.HyperV.PowerShell.VMNetworkAdapterRoutingDomainSetting