Set-VmNetworkAdapterIsolation

Set-VmNetworkAdapterIsolation

Modifies isolation settings for a virtual network adapter.

語法

Parameter Set: VMName
Set-VmNetworkAdapterIsolation [-VMName] <String[]> [-AllowUntaggedTraffic <Boolean]> ] [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [-DefaultIsolationID <Int32]> ] [-IsolationMode <VMNetworkAdapterIsolationMode]> ] [-MultiTenantStack <OnOffState]> ] [-Passthru] [-VMNetworkAdapterName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: ManagementOS
Set-VmNetworkAdapterIsolation -ManagementOS [-AllowUntaggedTraffic <Boolean]> ] [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [-DefaultIsolationID <Int32]> ] [-IsolationMode <VMNetworkAdapterIsolationMode]> ] [-MultiTenantStack <OnOffState]> ] [-Passthru] [-VMNetworkAdapterName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: ResourceObject
Set-VmNetworkAdapterIsolation [-VMNetworkAdapter] <VMNetworkAdapterBase[]> [-AllowUntaggedTraffic <Boolean]> ] [-DefaultIsolationID <Int32]> ] [-IsolationMode <VMNetworkAdapterIsolationMode]> ] [-MultiTenantStack <OnOffState]> ] [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: VMObject
Set-VmNetworkAdapterIsolation [-VM] <VirtualMachine[]> [-AllowUntaggedTraffic <Boolean]> ] [-DefaultIsolationID <Int32]> ] [-IsolationMode <VMNetworkAdapterIsolationMode]> ] [-MultiTenantStack <OnOffState]> ] [-Passthru] [-VMNetworkAdapterName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細描述

The Set-VmNetworkAdapterIsolation cmdlet modifies isolation settings for a virtual network adapter. You can isolate a virtual machine adapter by using virtual local area network (VLAN), Hyper-V Network Virtualization or a third party virtualization solution. You can specify the isolation method and modify other settings, which include multitenancy settings. For more information about multitenancy, see the Add-VmNetworkAdapterRoutingDomainMapping cmdlet.

參數

-AllowUntaggedTraffic<Boolean]>

Indicates whether the virtual machine sends and receives untagged traffic.

-CimSession<Microsoft.Management.Infrastructure.CimSession[]>

在遠端工作階段或遠端電腦上執行 Cmdlet。輸入電腦名稱或工作階段物件，例如 New-CimSession 或 Get-CimSession Cmdlet 的輸出。預設為本機電腦上目前的工作階段。

-ComputerName<String[]>

Specifies an array of Hyper-V hosts. The cmdlet modifies isolation settings for virtual machines hosted by the computers that you specify.

-Credential<System.Management.Automation.PSCredential[]>

Specifies one or more user accounts that have permission to perform this action. The default is the current user.

-DefaultIsolationID<Int32]>

Specifies the ID of the network for traffic to the default compartment on virtual machines that have multitenancy enabled.

-IsolationMode<VMNetworkAdapterIsolationMode]>

Specifies the isolation mode for the adapter. 這個參數可接受的值如下：

-- NativeVirtualSubnet. Hyper-V Network Virtualization.
-- ExternalVirtualSubnet. A third party network virtualization solution.
-- VLAN.
-- None.

If you specify a value of None, the network adapter uses its default isolation mode. Set the default isolation mode by using the Set-VMNetworkAdapterVlan cmdlet or the Set-VMNetworkAdapter cmdlet.

-ManagementOS

Indicates that the cmdlet operates on the parent or host operating system. If you specify this parameter, this cmdlet modifies isolation settings for the parent or host operating system.

-MultiTenantStack<OnOffState]>

Specifies whether to use multiple isolation IDs for the virtual machine. 這個參數可接受的值如下：

-- On. Indicate isolation IDs so that the virtual machine provides services to multiple tenants on different isolation subnets.
-- Off. Do not indicate isolation IDs to virtual machine.

-Passthru

傳回物件，表示您所使用的項目。此 Cmdlet 依預設不會產生任何輸出。

-VM<VirtualMachine[]>

Specifies an array of virtual machine objects. The cmdlet modifies isolation settings for adapters that belong to the virtual machines that you specify. To obtain a virtual machine object, use the Get-VM cmdlet.

-VMName<String[]>

Specifies an array of names of virtual machines. The cmdlet modifies isolation settings for adapters that belong to the virtual machines that you specify.

-VMNetworkAdapter<VMNetworkAdapterBase[]>

Specifies an array VM network adapters as VMNetworkAdapterBase objects. The cmdlet modifies isolation settings for the adapters that you specify. To obtain a network adapter, use the Get-VMNetworkAdapter cmdlet.

-VMNetworkAdapterName<String>

Specifies the name of a virtual network adapter. The cmdlet modifies isolation settings for the adapters that you specify.

-Confirm

在執行指令程式之前提示您確認。

-WhatIf

示範當執行指令程式時會發生什麼事情。此指令程式並未執行。

<CommonParameters>

這個指令程式支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊，請參閱 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

輸入

輸入類型是可透過管道傳送至指令程式的物件類型。

• None

輸出

輸出類型是指令程式所發出的物件類型。

• Microsoft.HyperV.PowerShell.VMNetworkAdapterIsolation

範例

Example 1: Set isolation mode for a virtual machine

This command sets the isolation mode of the virtual machine named TSQA01 to NativeVirtualSubnet, which indicates Hyper-V Network Virtualization. The virtual machine does not accept untagged traffic, but the MultitenantStack parameter has a value of On, so the virtual machine can provide services to multiple tenants.

PS C:\> Set-VMNetworkAdapterIsolation -VMName "TSQA01" -AllowUntaggedTraffic $False -IsolationMode NativeVirtualSubnet -MultiTenantStack On

Example 2: Set isolation mode and untagged traffic setting for a virtual machine

This command sets the isolation mode for virtual machine named TSQA01 to be VLAN. The virtual machine accepts untagged traffic, which is sent and received on VLAN 1, specified by the DefaultIsolationID parameter. Untagged traffic goes to the default compartment in the virtual machine. Multitenancy is enabled, therefore, the virtual machine receives isolation subnet and routing domain information.

PS C:\> Set-VMNetworkAdapterIsolation -VMName "TSQA01" -AllowUntaggedTraffic $True -IsolationMode VLAN -DefaultIsolationID 1 -MultiTenantStack On

相關主題

Get-VmNetworkAdapterIsolation

Get-VM

Get-VMNetworkAdapter

Set-VMNetworkAdapter

Set-VMNetworkAdapterVlan