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 モジュールを作成することもできます。

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

-BMCCustomConfigurationProvider

ベースボード管理コントローラー (BMC) の構成プロバイダー オブジェクトを指定または更新します。 構成プロバイダーは、VMM PowerShell コマンドをベースボード管理コントローラーの種類に固有の API 呼び出しに変換する VMM へのプラグインです。 このパラメーターは、カスタム 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 経由のスマッシュの場合は 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

このコマンドレットは、Active Directory に既に存在するコンピューター アカウントを再利用することを示します。 既定では、このコマンドレットは、コンピューター アカウントの上書きを防ぐために、指定した名前の既存のアカウントの 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 を使用します。 ただし、他の種類のアドレスを BMC アドレスとして指定できる PowerShell モジュールを作成することもできます。

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

-ComputerName

ネットワーク内で Virtual Machine Manager が一意に識別できるコンピュータの名前を指定します。 このパラメーターの有効値は、次のとおりです。

  • 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

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

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 でその物理コンピューターのレコードに関連付けられている物理コンピューターの System Management 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

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