New-SCPhysicalComputerConfig

コンピュータ構成オブジェクトを作成します。

構文

FromExistingComputer

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

SkipBMCPowerControl

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

UseBMCPowerControl

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

説明

New-SCPhysicalComputerConfig コマンドレットは、オペレーティング システムのカスタマイズ プロセス中に使用されるコンピューター構成オブジェクトを作成します。

例 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 変数に格納します。

2 番目のコマンドは、ID が d1ce0773-4f50-4f12-a244-38a5a35c5326 の物理コンピューター プロファイルを $PhysicalComputerProfile 変数に格納します。

3 番目のコマンドは、物理コンピューター ネットワーク アダプター構成を作成し、$NetworkAdapters 変数に格納します。

4 番目のコマンドレットは、ホスト グループを $HostGroup 変数に格納します。

最後のコマンドは、物理コンピューター構成を作成します。 このコマンドは、前のコマンドで作成した値を指定します。

パラメーター

-BMCAddress

特定の物理マシンのアウトオブバンド ベースボード管理コントローラー (BMC) アドレスを指定または更新します。 これには、IP アドレス、完全修飾ドメイン名 (FQDN)、または DNS プレフィックス (通常は NetBIOS 名と同じ名前) があります。

通常、BMC アドレスとそのネットワークへの接続は、標準のネットワーク アダプターに関連付けられている IP アドレスとは別のものです。 また、一部のコンピュータでは、標準のネットワーク アダプタを使用して、BMC とネットワーク アダプタに 1 つのアドレスを提供します。 ただし、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 を使用します。 ただし、他の種類のアドレスを BMC アドレスとして指定できる PowerShell モジュールを作成することもできます。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

FromExistingComputer
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-BMCCustomConfigurationProvider

ベースボード管理コントローラー (BMC) の構成プロバイダー オブジェクトを指定または更新します。 構成プロバイダーは、VMM PowerShell コマンドをベースボード管理コントローラーの種類に固有の API 呼び出しに変換する VMM のプラグインです。 このパラメータは、カスタム BMCProtocol と共に使用する必要があります。

パラメーターのプロパティ

型:ConfigurationProvider
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

FromExistingComputer
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UseBMCPowerControl
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-BMCPort

特定の物理マシンのアウトオブバンド ベースボード管理コントローラー (BMC) ポートを指定または更新します。 BMC ポートは、サービス・プロセッサー・ポートとも呼ばれます。 デフォルトのポートの例としては、IPMI の場合は 623、WS-MAN 経由の SMASH の場合は 443 があります。

パラメーターのプロパティ

型:Int32
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

FromExistingComputer
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UseBMCPowerControl
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-BMCProtocol

VMM が帯域外ベースボード管理コントローラー (BMC) との通信に使用するプロトコルを指定 (更新) します。 有効な値は次のとおりです。

  • IPMIの
  • 打ち砕く
  • 習慣

BMC (サービス プロセッサまたは管理コントローラーとも呼ばれます) は、サーバーのマザーボード上にある特殊なコントローラーで、ハードウェアとシステム管理ソフトウェアの間のインターフェイスとして機能します。 物理マシンのマザーボードに BMC が含まれている場合、マシンが接続されると (電源がオフになっているか電源がオンになっているか、オペレーティング システムがインストールされているかどうか)、システム ハードウェアに関する情報とそのシステム ハードウェアの正常性の状態が使用可能になります。

形式の例: -BMCProtocol "Custom"

注: カスタム・プロトコルでは、 BMCCustomConfigurationProvider パラメーターを使用する必要があります。

パラメーターのプロパティ

型:OutOfBandManagementType
規定値:None
指定可能な値:None, IPMI, SMASH, Custom
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

FromExistingComputer
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-BMCRunAsAccount

ベースボード管理コントローラー (BMC) デバイスで使用する実行アカウントを指定します。

パラメーターのプロパティ

型:RunAsAccount
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

FromExistingComputer
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-BootDiskVolume

物理マシンの物理ハード ディスク オブジェクトを指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-BypassADMachineAccountCheck

このコマンドレットが Active Directory に既に存在するコンピューター アカウントを再利用することを示します。 既定では、このコマンドレットは、コンピューター アカウントの上書きを防ぐために、指定した名前の既存のアカウントを Active Directory でチェックします。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

SkipBMCPowerControl
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UseBMCPowerControl
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値: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 を使用します。 ただし、他の種類のアドレスを BMC アドレスとして指定できる PowerShell モジュールを作成することもできます。

パラメーターのプロパティ

型:ClientObject
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

FromExistingComputer
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ComputerName

VMM がネットワーク上で一意に識別できるコンピューターの名前を指定します。 このパラメーターに使用できる値は次のとおりです。

  • FQDN
  • IPv4 または IPv6 アドレス
  • NetBIOS 名

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

FromExistingComputer
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Description

構成オブジェクトの説明を指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-JobVariable

ジョブの進行状況を追跡され、このパラメーターで指定された変数に格納するように指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-PhysicalComputerNetworkAdapterConfig

PhysicalComputerNetworkAdapterConfig オブジェクトの配列を指定します。

パラメーターのプロパティ

型:

PhysicalComputerNetworkAdapterConfig[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

FromExistingComputer
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-PhysicalComputerProfile

オペレーティング システムをコンピューターに展開するために使用されるプロファイルを指定します。

パラメーターのプロパティ

型:PhysicalComputerProfile
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-PROTipID

このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。

パラメーターのプロパティ

型:Guid
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-RunAsynchronously

コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-SkipBmcPowerControl

BMC 情報をスキップし、BMC インターフェイスを使用してコンピューターの電源をオンまたはオフにせずにオペレーティング システムを展開します。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

SkipBMCPowerControl
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-SMBiosGuid

VMM の物理コンピューターのレコードに関連付けられている物理コンピューターのシステム管理 BIOS グローバル一意識別子 (SMBIOS GUID) を指定します。 SMBIOS は、ユーザーまたはアプリケーションがシステムの名前、製造元、システム BIOS バージョンなど、このコンピューター上のハードウェアに関する情報を格納および取得できるようにするデータ構造とアクセス方法を定義します。 Windows オペレーティング システムは、システムの起動時に SMBIOS データを取得し、そのデータをプログラムで使用できるようにします。

パラメーターのプロパティ

型:Guid
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

SkipBMCPowerControl
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UseBMCPowerControl
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-VMHostGroup

仮想マシンのホストグループオブジェクトまたはホストグループオブジェクトの配列を指定します。

パラメーターのプロパティ

型:HostGroup
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

SkipBMCPowerControl
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UseBMCPowerControl
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-VMMServer

VMM サーバー オブジェクトを指定します。

パラメーターのプロパティ

型:ServerConnection
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

出力

PhysicalComputerConfig

このコマンドレットは、 PhysicalComputerConfig オブジェクトを返します。