New-SCPhysicalComputerConfig

模块:

VirtualMachineManager

创建计算机配置对象。

语法

New-SCPhysicalComputerConfig
   -PhysicalComputerProfile <PhysicalComputerProfile>
   [-BMCAddress <String>]
   [-BMCRunAsAccount <RunAsAccount>]
   [-BMCPort <Int32>]
   [-BMCProtocol <OutOfBandManagementType>]
   [-BMCCustomConfigurationProvider <ConfigurationProvider>]
   [-PhysicalComputerNetworkAdapterConfig <PhysicalComputerNetworkAdapterConfig[]>]
   [-VMMServer <ServerConnection>]
   [-Description <String>]
   [-ComputerName <String>]
   [-BootDiskVolume <String>]
   -Computer <ClientObject>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCPhysicalComputerConfig
   -PhysicalComputerProfile <PhysicalComputerProfile>
   [-SMBiosGuid <Guid>]
   [-SkipBmcPowerControl]
   -PhysicalComputerNetworkAdapterConfig <PhysicalComputerNetworkAdapterConfig[]>
   [-VMMServer <ServerConnection>]
   [-Description <String>]
   -ComputerName <String>
   [-VMHostGroup <HostGroup>]
   [-BypassADMachineAccountCheck]
   [-BootDiskVolume <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCPhysicalComputerConfig
   -PhysicalComputerProfile <PhysicalComputerProfile>
   [-SMBiosGuid <Guid>]
   -BMCAddress <String>
   -BMCRunAsAccount <RunAsAccount>
   [-BMCPort <Int32>]
   -BMCProtocol <OutOfBandManagementType>
   [-BMCCustomConfigurationProvider <ConfigurationProvider>]
   -PhysicalComputerNetworkAdapterConfig <PhysicalComputerNetworkAdapterConfig[]>
   [-VMMServer <ServerConnection>]
   [-Description <String>]
   -ComputerName <String>
   [-VMHostGroup <HostGroup>]
   [-BypassADMachineAccountCheck]
   [-BootDiskVolume <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

说明

New-SCPhysicalComputerConfig cmdlet 创建在操作系统自定义过程中使用的计算机配置对象。

示例

示例 1：创建物理计算机配置

PS C:\> $Account = Get-SCRunaAsAccount -Name "BMCAdmin" 
PS C:\> $PhysicalComputerProfile = Get-SCPhysicalComputerProfile -ID "d1ce0773-4f50-4f12-a244-38a5a35c5326" 
PS C:\> $NetworkAdapters = New-SCPhysicalComputerNetworkAdapterConfig -UseDhcpForIPConfiguration -SetAsManagementNIC -SetAsPhysicalNetworkAdapter 
PS C:\> $HostGroup = Get-SCVMHostGroup -ID "0e3ba228-a059-46be-aa41-2f5cf0f4b96e" 
PS C:\> New-SCPhysicalComputerConfig -BMCAddress 10.0.0.21 -BMCPort 623 -BMCProtocol IPMI -BMCRunAsAccount $Account -ComputerName "Host01" -SMBiosGuid "4c4c4544-0039-4410-8042-c3c04f395031" -PhysicalComputerProfile $PhysicalComputerProfile -VMHostGroup $HostGroup -PhysicalComputerNetworkAdapterConfig $NetworkAdapters

第一个命令获取运行方式帐户对象，并将其存储在$Account变量中。

第二个命令将 ID 为 d1ce0773-4f50-4f12-a244-38a5a35c5326 的物理计算机配置文件存储在$PhysicalComputerProfile变量中。

第三个命令创建物理计算机网络适配器配置，并将其存储在$NetworkAdapters变量中。

第四个 cmdlet 将主机组存储在$HostGroup变量中。

最后一个命令创建物理计算机配置。 该命令指定在前面的命令中创建的值。

参数

-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 对 BMC 地址使用 IP 地址或 FQDN。 但是，还可以创建一个 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:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BMCProtocol

指定或更新 VMM 用来与带外基板管理控制器通信的协议， (BMC) 。 有效值为：

• IPMI
• 粉碎
• 自定义

BMC (也称为服务处理器或管理控制器) 是服务器主板上的专用控制器，它充当硬件和系统管理软件之间的接口。 如果物理计算机的主板包括 BMC，则当计算机插入 (它是否关闭或开机，以及操作系统是否安装) ，系统硬件的相关信息以及系统硬件运行状况的状态可用。

示例格式： -BMCProtocol "Custom"

注意：自定义协议要求使用 BMCCustomConfigurationProvider 参数。

Type:	OutOfBandManagementType
Accepted values:	None, IPMI, SMASH, Custom, 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

-BootDiskVolume

指定物理计算机的物理硬盘对象。

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

-BypassADMachineAccountCheck

指示此 cmdlet 将重复使用 Active Directory 中已存在的计算机帐户。 默认情况下，此 cmdlet 检查 Active Directory 中是否存在具有指定名称的现有帐户，以防止覆盖计算机帐户。

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

-Computer

指定或更新特定物理计算机的带外基板管理控制器 (BMC) 地址。 这可能是 IP 地址、 (FQDN) 的完全限定域名，或 DNS 前缀 (通常与 NetBIOS 名称) 的名称相同。

• 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 对 BMC 地址使用 IP 地址或 FQDN。 但是，还可以创建一个 PowerShell 模块，使你可以将其他类型的地址指定为 BMC 地址。

Type:	ClientObject
Position:	Named
Default value:	None
Required:	True
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

指定配置对象的说明。

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

-PhysicalComputerNetworkAdapterConfig

指定 PhysicalComputerNetworkAdapterConfig 对象的数组。

Type:	PhysicalComputerNetworkAdapterConfig[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PhysicalComputerProfile

指定用于将操作系统部署到计算机的配置文件。

Type:	PhysicalComputerProfile
Position:	Named
Default value:	None
Required:	True
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

-SkipBmcPowerControl

跳过 BMC 信息并部署操作系统，而无需使用其 BMC 接口打开或关闭计算机。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
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:	False
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

-VMMServer

指定VMM 服务器对象。

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

输出

PhysicalComputerConfig

此 cmdlet 返回 PhysicalComputerConfig 对象。