共用方式為


New-SCPhysicalComputerConfig

建立電腦群組態物件。

Syntax

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

Description

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

第二個命令會將識別碼為 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 埠也稱為服務處理器埠。 IPMI 的範例預設埠為 623,而透過 WS-Man 的 SMASH 則為 443。

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

-BMCProtocol

指定或更新 VMM 用來與頻外基板管理控制器通訊的通訊協定, (BMC) 。 有效值為:

  • IPMI
  • 粉碎
  • Custom

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 提示 (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

-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 物件。