共用方式為

New-SCVMHost

  • 參考
模組:
VirtualMachineManager

使用主機配置檔中定義的屬性，從實體計算機建立 VMM 主機。

語法

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.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變數中。

最後一個命令會使用先前識別主機的設定來重新部署舊主機，但重新部署到新的主機 gorup （儲存在 $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 位址。

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

-BMCCustomConfigurationProvider

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

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

-BMCPort

指定或更新特定實體計算機的頻外基礎板管理控制器 （BMC） 埠。 BMC 埠也稱為服務處理器埠。 IPMI 的預設埠範例為 623，WS-Man 的 SMASH 為 443。

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

-BMCProtocol

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

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

範例格式：-BMCProtocol "Custom"

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

類型:OutOfBandManagementType
接受的值:None, IPMI, SMASH, Custom
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-BMCRunAsAccount

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

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

-BypassADMachineAccountCheck

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

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

-ComputerName

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

  • FQDN
  • IPv4 或 IPv6 位址
  • NetBIOS 名稱
類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Description

指定 VMM 主機的描述。

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

-IPAddress

指定 IPv4 或 IPv6 位址。

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

-JobVariable

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

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

-LogicalNetwork

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

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

-ManagementAdapterMACAddress

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

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

-PROTipID

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

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

-RunAsynchronously

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

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

-SMBiosGuid

為與 VMM 中該實體電腦之記錄相關聯的實體計算機，指定系統管理 BIOS 全域唯一標識碼 （SMBIOS GUID）。

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

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

-Subnet

在無類別 Inter-Domain 路由 （CIDR） 表示法中指定IP子網 （IPv4 或 IPv6）。

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

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

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

-VMHostConfig

指定實體計算機組態物件。

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

-VMHostGroup

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

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

-VMHostProfile

指定虛擬機主機配置檔物件。

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

-VMMServer

指定 VMM 伺服器物件。

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

輸出

Host

此 Cmdlet 會傳回 Host 物件。

備註

  • 需要主機配置檔物件，可以使用 Get-SCVMHostProfile Cmdlet 來擷取。