New-SCVMHost
使用主機設定檔中定義的屬性,從實體電腦建立 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 擷取的主機設定檔物件。