次の方法で共有

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

例

例 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
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-BMCCustomConfigurationProvider

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

型:ConfigurationProvider
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-BMCPort

特定の物理マシンの帯域外ベースボード管理コントローラー (BMC) ポートを指定または更新します。 BMC ポートは、サービス プロセッサ ポートとも呼ばれます。 既定のポートの例は、IPMI の場合は 623、WS-Man 経由の SSA の場合は 443 です。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-BMCProtocol

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

  • IPMI
  • 打ち砕く
  • 習慣

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

形式の例: -BMCProtocol "Custom"

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

型:OutOfBandManagementType
指定可能な値:None, IPMI, SMASH, Custom, None, IPMI, SMASH, Custom
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-BMCRunAsAccount

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

型:RunAsAccount
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-BootDiskVolume

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-BypassADMachineAccountCheck

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

型:SwitchParameter
配置:Named
規定値:None
必須: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
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ComputerName

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

  • FQDN
  • IPv4 または IPv6 アドレス
  • NetBIOS 名
型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Description

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-JobVariable

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PhysicalComputerNetworkAdapterConfig

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

型:PhysicalComputerNetworkAdapterConfig[]
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PhysicalComputerProfile

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

型:PhysicalComputerProfile
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PROTipID

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

型:Guid
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RunAsynchronously

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SkipBmcPowerControl

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

型:SwitchParameter
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SMBiosGuid

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

型:Guid
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-VMHostGroup

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

型:HostGroup
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-VMMServer

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

型:ServerConnection
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

出力

PhysicalComputerConfig

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