共用方式為

New-SCVMHostNetworkAdapterConfig

  • 參考
模組:
VirtualMachineManager

建立主機網路適配器組態。

語法

New-SCVMHostNetworkAdapterConfig
   [-VMMServer <ServerConnection>]
   [-SetAsPhysicalNetworkAdapter]
   -LogicalSwitch <LogicalSwitch>
   -UplinkPortProfileSet <UplinkPortProfileSet>
   [-MACAddress <String>]
   [-ConsistentDeviceName <String>]
   [-DisableAdapterDNSRegistration <Boolean>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterConfig
   [-VMMServer <ServerConnection>]
   [-SetAsPhysicalNetworkAdapter]
   [-SetAsGenericNIC]
   [-UseStaticIPForIPConfiguration]
   -LogicalNetwork <LogicalNetwork>
   [-MACAddress <String>]
   [-ConsistentDeviceName <String>]
   [-IPv4Subnet <String>]
   [-IPv6Subnet <String>]
   [-IPv4Address <String>]
   [-IPv6Address <String>]
   [-DisableAdapterDNSRegistration <Boolean>]
   [-AdapterName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterConfig
   [-VMMServer <ServerConnection>]
   [-SetAsPhysicalNetworkAdapter]
   [-SetAsManagementNIC]
   [-UseDhcpForIPConfiguration]
   [-MACAddress <String>]
   [-ConsistentDeviceName <String>]
   [-AdapterName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterConfig
   [-VMMServer <ServerConnection>]
   [-SetAsPhysicalNetworkAdapter]
   [-SetAsGenericNIC]
   [-UseDhcpForIPConfiguration]
   [-MACAddress <String>]
   [-ConsistentDeviceName <String>]
   [-DisableAdapterDNSRegistration <Boolean>]
   [-AdapterName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterConfig
   [-VMMServer <ServerConnection>]
   [-SetAsPhysicalNetworkAdapter]
   [-SetAsManagementNIC]
   [-UseStaticIPForIPConfiguration]
   -LogicalNetwork <LogicalNetwork>
   [-MACAddress <String>]
   [-ConsistentDeviceName <String>]
   [-IPv4Subnet <String>]
   [-IPv6Subnet <String>]
   [-IPv4Address <String>]
   [-IPv6Address <String>]
   [-AdapterName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterConfig
   [-VMMServer <ServerConnection>]
   [-SetAsVirtualNetworkAdapter]
   [-SetAsGenericNIC]
   [-UseDhcpForIPConfiguration]
   -LogicalSwitch <LogicalSwitch>
   [-PortClassification <PortClassification>]
   -VMNetwork <VMNetwork>
   [-MACAddress <String>]
   [-AdapterName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterConfig
   [-VMMServer <ServerConnection>]
   [-SetAsVirtualNetworkAdapter]
   [-SetAsGenericNIC]
   [-UseStaticIPForIPConfiguration]
   -LogicalSwitch <LogicalSwitch>
   [-PortClassification <PortClassification>]
   -VMNetwork <VMNetwork>
   [-MACAddress <String>]
   [-IPv4Subnet <String>]
   [-IPv6Subnet <String>]
   [-IPv4Address <String>]
   [-IPv6Address <String>]
   [-AdapterName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterConfig
   [-VMMServer <ServerConnection>]
   [-SetAsVirtualNetworkAdapter]
   [-SetAsManagementNIC]
   -TransientManagementNetworkAdapter <PhysicalComputerNetworkAdapterConfig>
   [-UseDhcpForIPConfiguration]
   -LogicalSwitch <LogicalSwitch>
   [-PortClassification <PortClassification>]
   -VMNetwork <VMNetwork>
   [-MACAddress <String>]
   [-AdapterName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCVMHostNetworkAdapterConfig
   [-VMMServer <ServerConnection>]
   [-SetAsVirtualNetworkAdapter]
   [-SetAsManagementNIC]
   -TransientManagementNetworkAdapter <PhysicalComputerNetworkAdapterConfig>
   [-UseStaticIPForIPConfiguration]
   -LogicalSwitch <LogicalSwitch>
   [-PortClassification <PortClassification>]
   -VMNetwork <VMNetwork>
   [-MACAddress <String>]
   [-IPv4Subnet <String>]
   [-IPv6Subnet <String>]
   [-IPv4Address <String>]
   [-IPv6Address <String>]
   [-AdapterName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

New-SCVMHostNetworkAdapterConfig Cmdlet 會建立主機網路適配器組態，用於主機操作系統部署程式。

範例

範例 1：使用靜態 IP 位址建立管理實體主機網路適配器組態

PS C:\> $LogicalNetwork = Get-SCLogicalNetwork -Name "LogicalNetwork01"
PS C:\> New-SCVMHostNetworkAdapterConfig -SetAsPhysicalNetworkAdapter -SetAsManagementNIC -UseStaticIPForIPConfiguration -LogicalNetwork $LogicalNetwork -MacAddress "00-1D-D8-B7-1C-00" -IPv4Subnet "10.0.0.1/24"

第一個命令會取得名為 LogicalNetwork01 的邏輯網路物件，並將物件儲存在 $LogicalNetwork 變數中。

第二個命令會建立實體主機網路適配器組態，並將其設定為管理網路適配器，並在IP組態期間使用靜態IP位址。 組態包括 LogicalNetwork01、提供的 MAC 位址和指定的子網。

範例 2：建立使用邏輯交換器的實體主機網路適配器組態

PS C:\> $LogicalSwitch = Get-SCLogicalSwitch -Name "LogicalSwitch01"
PS C:\> $UplinkPortProfSet = Get-SCUplinkPortProfileSet -Name "UplinkPortProfileSet01"
PS C:\> New-SCVMHostNetworkAdapterConfig -SetAsPhysicalNetworkAdapter -LogicalSwitch $LogicalSwitch -UplinkPortProfileSet $UplinkPortProfSet

第一個命令會取得名為 LogicalSwitch01 的邏輯交換器物件，並將物件儲存在$LogicalSwitch變數中。

第二個命令會取得名為UplinkPortProfileSet01的上行通訊埠配置檔集物件，並將物件儲存在 $UplinkPortProfSet變數中。

最後一個命令會使用LogicalSwitch01和UplinkPortProfileSet01建立實體主機網路適配器組態。

範例 3：使用 DHCP 建立一般虛擬主機網路適配器組態

PS C:\> $LogicalSwitch = Get-SCLogicalSwitch -Name "LogicalSwitch01"
PS C:\> $VMNetwork = Get-SCVMNetwork -Name "VMNetwork01"
PS C:\> New-SCVMHostNetworkAdapterConfig -SetAsVirtualNetworkAdapter -SetAsGenericNIC -UseDhcpForIPConfiguration -LogicalSwitch $LogicalSwitch -VMNetwork $VMNetwork

第一個命令會取得名為 LogicalSwitch01 的邏輯交換器物件，並將物件儲存在$LogicalSwitch變數中。

第二個命令會取得名為 VMNetwork01 的 VM 網路物件，並將物件儲存在$VMNetwork變數中。

最後一個命令會使用LogicalSwtich01和VMNetwork01建立一般虛擬網路組態，以使用 DHCP 來取得IP位址。

參數

-AdapterName

指定網路配接器的名稱。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ConsistentDeviceName

指定網路配接器的一致裝置名稱。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DisableAdapterDNSRegistration

指出是否要停用網路適配器的 DNS 註冊。

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-IPv4Address

指定 IPv4 位址。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-IPv4Subnet

指定 IPv4 子網。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-IPv6Address

指定 IPv6 位址。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-IPv6Subnet

指定 IPv6 子網。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-JobVariable

指定作業進度會追蹤並儲存在此參數所命名的變數中。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-LogicalNetwork

指定邏輯網路。 邏輯網路是IP子網和VLAN的具名群組，可用來組織和簡化網路指派。

類型:LogicalNetwork
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-LogicalSwitch

指定邏輯交換器物件。

類型:LogicalSwitch
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-MACAddress

指定電腦上的實體或虛擬網路適配器的媒體存取控制 （MAC） 位址或一組 MAC 位址。 有效值為：一或多個 MAC 位址。

單一 MAC 位址的範例格式：

-MACAddress "00-15-5D-B4-DC-00"

一組 MAC 位址的範例格式：

-MACAddress "00-15-5D-B4-DC-00", "00-1A-A0-E3-75-29"

一組 MAC 位址的範例格式：

$Macs = "00-15-5D-B4-DC-00", "00-1A-A0-E3-75-29"

Set-SCPXEServer -MACAddress $Macs

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-PortClassification

指定虛擬網路適配器所連線之交換器的埠分類。

類型:PortClassification
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-PROTipID

指定觸發此動作之效能和資源優化提示 （PRO 提示） 的識別碼。 此參數可讓您稽核 PRO 秘訣。

類型:Guid
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-RunAsynchronously

表示作業會以異步方式執行，讓控件立即返回命令殼層。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-SetAsGenericNIC

指出網路適配器不是主機的管理網路適配器。

類型:SwitchParameter
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-SetAsManagementNIC

指出網路適配器是主機的管理網路適配器。

類型:SwitchParameter
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-SetAsPhysicalNetworkAdapter

指出網路適配器是實體網路適配器。

類型:SwitchParameter
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-SetAsVirtualNetworkAdapter

指出網路適配器是虛擬網路適配器。

類型:SwitchParameter
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-TransientManagementNetworkAdapter

指定管理虛擬網路適配器在初始操作系統部署階段期間所系結的實體網路適配器。 在部署主機之前，會暫時使用這個屬性。

類型:PhysicalComputerNetworkAdapterConfig
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-UplinkPortProfileSet

指定上行通訊埠配置檔集物件。

若要取得上行通訊埠配置檔集物件，請使用 Get-SCUplinkPortProfileSet Cmdlet。

類型:UplinkPortProfileSet
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-UseDhcpForIPConfiguration

指出網路適配器的IP位址是使用 DHCP 取得的。

類型:SwitchParameter
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-UseStaticIPForIPConfiguration

指出網路適配器是使用靜態IP位址設定的。

類型:SwitchParameter
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-VMMServer

指定 VMM 伺服器物件。

類型:ServerConnection
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-VMNetwork

指定 VM 網路物件。

若要取得 VM 網路物件，請使用 get-SCVMNetwork Cmdlet 。

類型:VMNetwork
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

輸出

HostNetworkAdapterConfig

此 Cmdlet 會傳回 HostNetworkAdapterConfig 物件。