Set-SCVirtualNetwork

模組:

VirtualMachineManager

變更 VMM 所管理主機上所設定之虛擬網路的屬性。

Syntax

Set-SCVirtualNetwork
   [-VirtualNetwork] <VirtualNetwork>
   [-Name <String>]
   [-Description <String>]
   [-BoundToVMHost <Boolean>]
   [-HostBoundVLanId <UInt16>]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCVirtualNetwork
   [-VirtualNetwork] <VirtualNetwork>
   -LogicalSwitch <LogicalSwitch>
   [-VMHostNetworkAdapters <HostNetworkAdapter[]>]
   [-Description <String>]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCVirtualNetwork
   [-VirtualNetwork] <VirtualNetwork>
   -LogicalSwitch <LogicalSwitch>
   [-Description <String>]
   [-JobGroup <Guid>]
   [-ConvertToLogicalSwitch]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCVirtualNetwork
   [-ClusterVirtualNetwork] <ClusterVirtualNetwork>
   [-Name <String>]
   [-Description <String>]
   [-BoundToVMHost <Boolean>]
   [-HostBoundVLanId <UInt16>]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

Set-SCVirtualNetwork Cmdlet 會變更 Virtual Machine Manager 所管理主機上所設定之虛擬網路的屬性， (VMM) 。

您可以變更的虛擬網路屬性包括：

• 任何主機。 針對針對 VMM 所支援之任何主機上部署的虛擬機器所設定的虛擬網路， (Hyper-V、VMware ESX 或 Citrix XenServer 主機) ，您可以設定或修改名稱或描述。

• 僅限 Hyper-V 主機。 如果主機是 Hyper-V 主機，您也可以設定虛擬機器是否系結至主機 (，因此可以存取主機作業系統) ，而且您可以為主機上的虛擬區域網路 (VLAN) 指定數值識別碼。

範例

範例 1：將虛擬網路從主機解除系結

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com" 
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "InternalVNet01"
PS C:\> Set-SCVirtualNetwork -VirtualNetwork $VirtualNetwork -Name "UnboundVNet01" -BoundToVMHost $False

第一個命令會取得名為 VMHost01 的主機物件，並將物件儲存在$VMHost變數中。

第二個命令會從 VMHost01 取得名為 InternalVNet01 的虛擬網路物件，並將物件儲存在 $VirtualNetwork 變數中。

最後一個命令會將虛擬網路重新命名為 UnboundVNet01，並將 VMHostBound 設定為 $False。 這樣會將虛擬網路從主機解除繫結，可防止附加到此虛擬網路的任何虛擬機器透過此網路存取主機。

參數

-BoundToVMHost

指出虛擬網路是否系結至主機。 將虛擬網路系結至主機可讓主機進行網路通訊。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClusterVirtualNetwork

指定叢集虛擬網路物件。

Type:	ClusterVirtualNetwork
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ConvertToLogicalSwitch

表示此 Cmdlet 會將虛擬網路轉換成邏輯交換器。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

指定虛擬網路的描述。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HostBoundVLanId

將 VLAN 指派給為指定虛擬網路的主機所建立的虛擬網路介面卡。

Type:	UInt16
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-JobGroup

指定一系列命令的識別碼，這些命令會在執行包含相同工作群組識別碼的最終命令之前，使用整組的方式來執行。

Type:	Guid
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-JobVariable

指定追蹤工作進度，並將工作進度存放在這個參數命名的變數中。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LogicalSwitch

指定邏輯交換器物件。

Type:	LogicalSwitch
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

指定 VMM 物件的名稱。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PROTipID

指定觸發此動作之 PRO 提示 (PRO 提示的識別碼) 。 此參數可讓您稽核 PRO 秘訣。

Type:	Guid
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RunAsynchronously

表示作業會以非同步方式執行，讓控制項立即返回命令殼層。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VirtualNetwork

指定虛擬網路物件。

Type:	VirtualNetwork
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VMHostNetworkAdapters

指定主機上一或多個實體網路介面卡物件的陣列，以供部署在該主機上的虛擬機器連線。

範例格式： -VMHostNetworkAdapters $VMHostNICs

Type:	HostNetworkAdapter[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

輸出

VirtualNetwork

此 Cmdlet 會傳回 VirtualNetwork 物件。

相關連結

• Get-SCVirtualNetwork
• Get-SCVMHost
• New-SCVirtualNetwork
• Remove-SCVirtualNetwork
• Repair-SCVirtualNetwork