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>]

说明

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 端口也称为服务处理器端口。 示例默认端口为 623（对于 IPMI）和 443，用于通过 WS-Man 进行 SMASH。

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 提示) 的性能和资源优化提示的 ID。 此参数允许审核 PRO 提示。

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

-RunAsynchronously

指示作业以异步方式运行，以便控件立即返回到命令 shell。

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) 表示法中的 IPv4 或 IPv6) IP 子网。

• 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 进行检索。

相关链接

• Add-SCVMHost
• Disable-SCVMHost
• Enable-SCVMHost
• Find-SCComputer
• Get-SCRunAsAccount
• Get-SCVMHost
• Get-SCVMHostGroup
• Get-SCVMHostNetworkAdapter
• Move-SCVMHost
• Read-SCVMHost
• Register-SCVMHost
• Remove-SCVMHost
• Repair-SCVMHost
• Restart-SCVMHost
• Set-SCVMHost
• Start-SCVMHost
• Stop-SCVMHost