New-SCVMHost

參考

模組:: VirtualMachineManager

使用主機設定檔中定義的屬性，從實體電腦建立 VMM 主機。

Syntax

New-SCVMHost
   [-VMMServer <ServerConnection>]
   [-Description <String>]
   -ComputerName <String>
   -VMHostProfile <PhysicalComputerProfile>
   -SMBiosGuid <Guid>
   [-VMHostGroup <HostGroup>]
   [-IPAddress <String>]
   [-LogicalNetwork <LogicalNetwork>]
   [-Subnet <String>]
   [-BypassADMachineAccountCheck]
   [-ManagementAdapterMACAddress <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCVMHost
   [-VMMServer <ServerConnection>]
   -VMHostConfig <PhysicalComputerConfig>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCVMHost
   [-VMMServer <ServerConnection>]
   [-Description <String>]
   -ComputerName <String>
   -VMHostProfile <PhysicalComputerProfile>
   -SMBiosGuid <Guid>
   [-VMHostGroup <HostGroup>]
   [-IPAddress <String>]
   [-LogicalNetwork <LogicalNetwork>]
   [-Subnet <String>]
   [-BypassADMachineAccountCheck]
   [-ManagementAdapterMACAddress <String>]
   -BMCAddress <String>
   -BMCRunAsAccount <RunAsAccount>
   [-BMCPort <UInt32>]
   -BMCProtocol <OutOfBandManagementType>
   [-BMCCustomConfigurationProvider <ConfigurationProvider>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

New-SCVMHost Cmdlet 會使用主機設定檔中定義的屬性，從實體電腦建立 Virtual Machine Manager (VMM) 主機。實體電腦必須具有頻外控制器。

建立主機之前，請確定 PXE 伺服器已新增至 VMM、已建立主機設定檔，以及已將任何必要的驅動程式檔案新增至程式庫。注意：您新增至 VMM 的 PXE 伺服器必須與要轉換成受控 Hyper-V 主機的實體電腦位於相同的子網中。

如需 VMM 所支援主機類型的詳細資訊，請輸入 Get-Help Add-SCVMHost -Detailed 。

範例

範例 1：使用 DHCP 型主機設定檔從實體電腦建立主機

PS C:\> $BMCRAA = Get-SCRunAsAccount -Name "BMCRunAsAcct"
PS C:\> $NewPhysicalComputer = Find-SCComputer -BMCAddress "10.10.0.1" -BMCRunAsAccount $BMCRAA -BMCProtocol "IPMI"
PS C:\> $HostGroup = Get-SCVMHostGroup -Name "HostGroup01"
PS C:\> $HostProfile = Get-SCVMHostProfile -Name "HostProfile01"
PS C:\> New-SCVMHost -VMHostGroup $HostGroup -VMHostProfile $HostProfile -ComputerName "NewHost01" -BMCAddress $NewPhysicalComputer.BMCAddress -BMCRunAsAccount $BMCRAA -BMCProtocol "IPMI" -SMBIOSGUID $NewPhysicalComputer.SMBIOSGUID -ManagementAdapterMACAddress "00-1D-D8-B7-1C-00" -LogicalNetwork "LogicalNetwork01" -Subnet "192.168.0.1/24" -IPAddress "192.168.0.91"

第一個命令會取得名為 BMCRunAsAcct 的執行身分帳戶物件，並將物件儲存在$BMCRAA變數中。

第二個命令會使用$BMCRAA中提供的執行身分帳戶，探索 IP 位址為 10.10.0.1 的實體電腦。然後，它會將實體電腦儲存在$NewPhysicalComputer變數中。

第三個命令會取得名為 HostGroup01 的主機群組物件，並將物件儲存在$HostGroup變數中。

第四個命令會取得名為 HostProfile01 的主機設定檔物件，並將物件儲存在$HostProfile變數中。 HostProfile01 已設定為透過 DHCP 服務取得 IP 位址。

最後一個命令會使用儲存在 $HostProfile 中的主機設定檔，從儲存在 $NewPhysicalComputer 中的實體電腦建立主機，並將它命名為 NewHost01。

範例 2：使用靜態 IP 型主機設定檔從實體電腦建立主機

PS C:\> $BMCRAA = Get-SCRunAsAccount -Name "BMCRunAsAcct"
PS C:\> $NewPhysicalComputer = Find-SCComputer -BMCAddress "10.10.0.1" -BMCRunAsAccount $BMCRAA -BMCProtocol "IPMI"
PS C:\> $HostGroup = Get-SCVMHostGroup -Name "HostGroup01"
PS C:\> $HostProfile = Get-SCVMHostProfile -Name "HostProfile02"
PS C:\> New-SCVMHost -VMHostGroup $HostGroup -VMHostProfile $HostProfile -BMCAddress $NewPhysicalComputer.BMCAddress -BMCRunAsAccount $BMCRAA -BMCProtocol "IPMI" -SMBIOSGUID $NewPhysicalComputer.SMBIOSGUID -ComputerName "NewHost02" -ManagementAdapterMACAddress "00-18-8B-0A-4D-76" -LogicalNetwork "LogicalNetwork01" -Subnet "192.168.1.1/24" -IPAddress "192.168.1.101"

第一個命令會取得名為 BMCRunAsAccount 的執行身分帳戶物件，並將物件儲存在$BMCRAA變數中。

第二個命令會使用儲存在 $BMCRAA 中的執行身分帳戶，探索位址為 10.10.0.1 的電腦，然後將電腦儲存在$NewPhysicalComputer變數中。

第三個命令會取得名為 HostGroup01 的主機群組物件，並將物件儲存在$HostGroup變數中。

第四個命令會取得名為 HostProfile02 的主機設定檔物件，並將物件儲存在$HostProfile變數中。 HostProfile02 已設定為配置靜態 IP 位址。

最後一個命令會使用儲存在 $HostProfile 中的主機設定檔，從儲存在 $NewPhysicalComputer 的實體電腦建立主機，並指定名稱 NewHost02，並設定 MAC 位址、IPAddress 和子網。

範例 3：使用新的主機設定檔重新部署現有的主機

PS C:\> $BMCRaa = Get-SCRunAsAccount -Name "BMCRunAsAcct"
PS C:\> $OldHost = Get-SCVMHost "NewHost02"
PS C:\> $OldBMCIP = $OldHost.physicalmachine.BMCAddress
PS C:\> $OldBMCProtocol = $OldHost.physicalmachine.BMCType
PS C:\> $OldComputer = Find-SCComputer -BMCAddress $OldBMCIP -BMCRunAsAccount $BMCRAA -BMCProtocol $OldBMCProtocol
PS C:\> $OldGuid = $OldComputer.SMBIOSGUID
PS C:\> $OldAdapter = Get-SCVMHostNetworkAdapter -VMHost $OldHost
PS C:\> $OldMAC = $OldAdapter[0].macaddress
PS C:\> $OldRAA = Get-SCRunAsAccount -Name "RunAsAccount01"
PS C:\> Remove-SCVMHost $OldHost -Credential $OldRAA
PS C:\> $NewHostGroup = Get-SCVMHostGroup -Name "HostGroup01"
PS C:\> $NewHostProfile = Get-SCVMHostProfile -Name "HostProfile02"
PS C:\> New-SCVMHost -VMHostGroup $NewHostGroup -VMHostProfile $NewHostProfile  -BMCAddress $OldBMCIP -BMCRunAsAccount $BMcRAA -BMCProtocol $OldBMCProtocol -SMBIOSGUID $OldGUID -ManagementAdapterMACAddress $OldMAC -ComputerName "Computer01" -LogicalNetwork "LogicalNetwork01" -Subnet "192.168.0.1/24" -IPAddress "192.168.0.93"

第一個命令會取得名為 BMCRunAsAccount 的執行身分帳戶物件，並將物件儲存在$BMCRaa變數中。

接下來八個命令會儲存您要重新部署之主機的屬性。

第十個命令會從 VMM 移除舊的主機。

第十一個命令會取得名為 New HostGroup01 的主機群組物件，並將物件儲存在$NewHostGroup變數中。

第十二個命令會取得名為 HostProfile02 的主機設定檔物件，並將物件儲存在$NewHostProfile變數中。

最後一個命令會使用先前識別主機的設定來重新部署舊主機，但新的主機會 (儲存在 $NewHostGroup) 中，並使用儲存在 $NewHostProfile) 中的更新設定檔設定 (。

參數

-BMCAddress

指定或更新特定實體機器的頻外基板管理控制器 (BMC) 位址。這可能是 IP 位址、FQDN () 的完整功能變數名稱，或 DNS 前置詞 (，通常是與 NetBIOS 名稱相同的名稱) 。

一般而言，BMC 位址及其與網路連線與標準網路介面卡相關聯的 IP 位址不同。或者，有些電腦會使用標準網路介面卡來提供 BMC 和網路介面卡的單一位址。不過，BMC 位址具有唯一的埠，因此可在網路上唯一識別。

範例 IPv4 格式： -BMCAddress "10.0.0.21"
範例 Ipv6 格式： -BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829"
範例 FQDN 格式： -BMCAddress "Computer01.Contoso.com"
範例 NetBIOS 格式： -BMCAddress "Computer01"

注意：根據預設，VMM 會針對 BMCAddress 使用 IP 位址或 FQDN。不過，您也可以建立Windows PowerShell模組，讓您將其他類型的位址指定為 BMC 位址。

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

-BMCCustomConfigurationProvider

指定或更新基板管理控制器的組態提供者物件， (BMC) 。組態提供者是 VMM 的外掛程式，可將 VMM PowerShell 命令轉譯為基板管理控制器類型專屬的 API 呼叫。您應該搭配自訂 BMCProtocol 使用此參數。

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

-BMCPort

指定或更新特定實體電腦的頻外基板管理控制器 (BMC) 埠。 BMC 埠也稱為服務處理器埠。 IPMI 的範例預設埠為 623，而透過 WS-Man 的 SMASH 則為 443。

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

-BMCProtocol

指定或更新 VMM 用來與頻外基板管理控制器通訊的通訊協定， (BMC) 。有效值為：IPMI、SMASH、Custom。

BMC (也稱為服務處理器或管理控制器) 是伺服器主機板上的特製化控制器，可作用硬體與系統管理軟體之間的介面。如果實體機器的主機板包含 BMC，則當電腦插入電源時， (是否已關閉或開機，以及是否已安裝作業系統) 、系統硬體的相關資訊，以及該系統硬體健康情況的狀態是否可用。

範例格式： -BMCProtocol "Custom"

注意：自訂通訊協定要求您使用 BMCCustomConfigurationProvider 參數。

Type:	OutOfBandManagementType
Accepted values:	None, IPMI, SMASH, Custom
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-BMCRunAsAccount

指定要與基板管理控制器搭配使用的執行身分帳戶， (BMC) 裝置。

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

-BypassADMachineAccountCheck

指出此 Cmdlet 會重複使用已在 Active Directory 中的電腦帳戶。根據預設， New-SCVMHost 會檢查 Active Directory 是否有具有指定名稱的現有帳戶，以防止覆寫電腦帳戶。

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

-ComputerName

指定 VMM 可在您的網路中唯一識別的電腦名稱。此參數可接受的值為：

FQDN
IPv4 或 IPv6 位址
NetBIOS 名稱

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

-Description

指定 VMM 主機的描述。

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

-IPAddress

指定 IPv4 或 IPv6 位址。

Type:	String
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

-LogicalNetwork

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

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

-ManagementAdapterMACAddress

指定 VMM 伺服器用來與此主機通訊之電腦上的實體網路介面卡 MAC 位址。

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

-SMBiosGuid

針對與 VMM 中該實體電腦之記錄相關聯的實體電腦，指定系統管理 BIOS 全域唯一識別碼 (SMBIOS GUID) 。

SMBIOS 會定義資料結構和存取方法，讓使用者或應用程式能夠儲存和擷取這部電腦上硬體的相關資訊，例如系統名稱、製造商或系統 BIOS 版本。 Windows 會在系統啟動時取得 SMBIOS 資料，並讓該資料可供程式使用。

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

-Subnet

指定 Inter-Domain無類別路由 (CIDR) 標記法中的 IP 子網 (IPv4 或 IPv6) 。

IPv4 子網的範例格式： 192.168.0.1/24
IPv6 子網的範例格式： FD4A:29CD:184F:3A2C::/64

注意：IP 子網不能與主機群組或子主機群組中的其他任何子網重迭。

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

-VMHostConfig

指定實體電腦群組態物件。

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

-VMHostGroup

指定虛擬機器主機群組物件。

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

-VMHostProfile

指定虛擬機器主機設定檔物件。

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

-VMMServer

指定 VMM 伺服器物件。

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

輸出

Host

此 Cmdlet 會傳回 Host 物件。

備註

需要可使用 Get-SCVMHostProfile Cmdlet 擷取的主機設定檔物件。

共用方式為

New-SCVMHost

Syntax

Description

範例

範例 1：使用 DHCP 型主機設定檔從實體電腦建立主機

範例 2：使用靜態 IP 型主機設定檔從實體電腦建立主機

範例 3：使用新的主機設定檔重新部署現有的主機

參數

-BMCAddress

-BMCCustomConfigurationProvider

-BMCPort

-BMCProtocol

-BMCRunAsAccount

-BypassADMachineAccountCheck

-ComputerName

-Description

-IPAddress

-JobVariable

-LogicalNetwork

-ManagementAdapterMACAddress

-PROTipID

-RunAsynchronously

-SMBiosGuid

-Subnet

-VMHostConfig

-VMHostGroup

-VMHostProfile

-VMMServer

輸出

備註

其他資源

共用方式為

New-SCVMHost

Syntax

Description

範例

範例 1：使用 DHCP 型主機設定檔從實體電腦建立主機

範例 2：使用靜態 IP 型主機設定檔從實體電腦建立主機

範例 3：使用新的主機設定檔重新部署現有的主機

參數

-BMCAddress

-BMCCustomConfigurationProvider

-BMCPort

-BMCProtocol

-BMCRunAsAccount

-BypassADMachineAccountCheck

-ComputerName

-Description

-IPAddress

-JobVariable

-LogicalNetwork

-ManagementAdapterMACAddress

-PROTipID

-RunAsynchronously

-SMBiosGuid

-Subnet

-VMHostConfig

-VMHostGroup

-VMHostProfile

-VMMServer

輸出

備註

相關連結

其他資源