Set-SCVirtualNetwork
變更 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 秘訣。
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 物件。