New-SCHardwareProfile

構文

New-SCHardwareProfile
   [-VMMServer <ServerConnection>]
   [-Generation <Int32>]
   [-HighlyAvailable <Boolean>]
   [-HAVMPriority <UInt32>]
   [-DRProtectionRequired <Boolean>]
   [-ReplicationGroup <ReplicationGroup>]
   [-SecureBootEnabled <Boolean>]
   [-NumLock <Boolean>]
   [-CPULimitFunctionality <Boolean>]
   [-CPULimitForMigration <Boolean>]
   [-Name] <String>
   [-HardwareProfile <HardwareProfile>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-JobGroup <Guid>]
   [-CapabilityProfile <CapabilityProfile>]
   [-Description <String>]
   [-MemoryMB <Int32>]
   [-DynamicMemoryEnabled <Boolean>]
   [-DynamicMemoryMaximumMB <Int32>]
   [-DynamicMemoryBufferPercentage <Int32>]
   [-MemoryWeight <Int32>]
   [-VirtualVideoAdapterEnabled <Boolean>]
   [-MonitorMaximumCount <Int32>]
   [-MonitorMaximumResolution <String>]
   [-RecoveryPointObjective <Int32>]
   [-ProtectionProvider <ProtectionProvider>]
   [-BootOrder <BootDevice[]>]
   [-FirstBootDevice <String>]
   [-SecureBootTemplate <String>]
   [-CPUCount <Byte>]
   [-CPUType <ProcessorType>]
   [-CPUExpectedUtilizationPercent <Int32>]
   [-DiskIops <Int32>]
   [-NetworkUtilizationMbps <Int32>]
   [-CPURelativeWeight <Int32>]
   [-CPUReserve <Int32>]
   [-CPUMaximumPercent <Int32>]
   [-CPUPerVirtualNumaNodeMaximum <Byte>]
   [-MemoryPerVirtualNumaNodeMaximumMB <Int32>]
   [-VirtualNumaNodesPerSocketMaximum <Byte>]
   [-DynamicMemoryMinimumMB <Int32>]
   [-NumaIsolationRequired <Boolean>]
   [-AutomaticCriticalErrorAction <UInt16>]
   [-AutomaticCriticalErrorActionTimeout <Int32>]
   [-CheckpointType <CheckpointType>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

説明

New-SCHardwareProfile コマンドレットは、ハードウェア構成情報を格納する仮想マシン マネージャー (VMM) で使用するハードウェア プロファイルを作成します。 スタンドアロンのハードウェア プロファイルを作成するか、テンプレートまたは仮想マシンをカスタマイズしてハードウェア プロファイルの設定を含めることができます。 New-SCHardwareProfile は、VMM ライブラリに新しいハードウェア プロファイル オブジェクトを格納します。

既定または既存のハードウェア プロファイルに基づいてハードウェア プロファイルを作成することも、ハードウェア プロファイルを作成するときにカスタマイズすることもできます。 Name 以外のパラメーターを指定しない場合は、VMM によって既定のハードウェア プロファイル オブジェクトが作成されます。

仮想マシンに対して構成できるハードウェア プロファイル設定は次のとおりです。

• 仮想マシンのデバイスの起動順序を指定する BIOS のブート順序設定。 ブート順序の設定は、Hyper-V ホストまたは Citrix XenServer ホスト上の仮想マシンでのみ使用できます。

• 仮想マシンの CPU 設定。

• 仮想マシンで使用可能なメモリ。

• 仮想フロッピー ドライブ。

• 2 つの仮想 COM ポート (COM1 と COM2)。

• 組み込みの仮想 IDE デバイス。

• 1 つ以上の仮想 SCSI アダプター。

• 論理ネットワークに接続できる 1 つ以上の仮想ネットワーク アダプター。 仮想ネットワーク アダプタは、エミュレートされたネットワーク アダプタまたは統合ネットワーク アダプタになります。

• 同じホストにデプロイされている他の仮想マシンによるホストの CPU の使用に関連して、ホストの CPU リソースを使用するために仮想マシンに割り当てられた優先順位。 CPU の優先順位は仮想化ソフトウェアによって決定されます。

• このプロファイルから作成された仮想マシンが高可用性になるかどうか。 高可用性仮想マシンは、ホスト クラスターの一部であるホストにのみ配置できる仮想マシンです。

例

例 1: 既定のハードウェア プロファイルを作成する

PS C:\> New-SCHardwareProfile -Name "NewHWProfile01"

このコマンドは、NewHWProfile01 という名前の既定のハードウェア プロファイルを作成します。

例 2: ブート順序、CPU、およびメモリを設定するハードウェア プロファイルを作成する

PS C:\> New-SCHardwareProfile -Name "NewHWProfile02" -BootOrder PXEBoot,CD,Floppy,IDEHardDrive -MemoryMB 1024 -CPUCount 4

このコマンドは、新しいハードウェア プロファイルを作成し、NewHWProfile02 という名前を付け、BIOS ブート順序の最初のエントリとして PXEBoot を設定し、1024 MB のメモリを指定し、このハードウェア プロファイルを使用して作成された仮想マシンに 4 つのプロセッサがあることを指定します。

例 3: 既存のハードウェア プロファイルを複製してから変更する

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> New-SCHardwareProfile -Name "NewHWProfile03" -HardwareProfile $HWProfile -RelativeWeight 100

最初のコマンドは、NewHWProfile01 という名前のハードウェア プロファイル オブジェクトを取得し、$HWProfile変数にオブジェクトを格納します。

2 番目のコマンドは、NewHWProfile01 に基づいて NewHWProfile03 というハードウェア プロファイルを作成しますが、相対的な重みの値を変更します。 NewHWProfile03 の他のすべての設定は、NewHWProfile01 の設定と同じです。

例 4: ネットワーク・アダプター、SCSI アダプター、および DVD ドライブを含むハードウェア・プロファイルを作成する

PS C:\> $JobGroupId = [Guid]::NewGuid().ToString()
PS C:\> New-SCVirtualNetworkAdapter -JobGroup $JobGroupID -PhysicalAddressType Dynamic -VirtualNetwork "Internal Network" 
PS C:\> New-SCVirtualSCSIAdapter -JobGroup $JobGroupID -AdapterID 6 -Shared $False
PS C:\> New-SCVirtualDVDDrive -JobGroup $JobGroupID -Bus 1 -LUN 0
PS C:\> New-SCHardwareProfile -Name "NewHWProfile04" -Owner "Contoso\Katarina" -Description "Temporary Hardware Config used to create a VM/Template" -MemoryMB 512 -JobGroup $JobGroupID

最初のコマンドは、グローバル一意識別子 (GUID) を生成し、GUID 文字列を変数$JobGroupIDに格納します。 ジョブ グループ ID は、この ID を含む後続のコマンドを 1 つのジョブ グループとしてまとめるための識別子として機能します。

2 番目のコマンドは仮想ネットワーク アダプターを作成しますが、 JobGroup パラメーターを使用して、最後のコマンドで New-SCHardwareProfile コマンドレットが実行される直前までネットワーク アダプターが作成されないことを指定します。 このコマンドは、物理 (MAC) アドレスの種類を動的に設定し、新しい仮想ネットワーク アダプターが内部ネットワークという名前の仮想ネットワークに接続することを指定します。

3 番目のコマンドは仮想 SCSI アダプターを作成しますが、 JobGroup パラメーターを使用して、最後のコマンドで New-SCHardwareProfile コマンドレットが実行される直前まで SCSI アダプターが作成されないことを指定します。 このコマンドはアダプター ID を 6 に設定し、 共有 パラメーターを $False に設定して、アダプターが共有されないようにします (ゲスト クラスタリングでアダプターを使用する場合と同様)。

4 番目のコマンドは仮想 DVD ドライブを作成しますが、 JobGroup パラメーターを使用して、最後のコマンドで New-SCHardwareProfile コマンドレットが実行される直前まで DVD ドライブが作成されないことを指定します。 Bus 1 と LUN 0 の指定によって、DVD ドライブを IDE バス上のセカンダリ チャネル (0) に接続します。

最後のコマンドでは、NewHWProfile04 という名前のハードウェア プロファイルを作成し、所有者を Contoso\Katarina に設定し、説明を指定し、このハードウェア プロファイルを使用して作成された仮想マシンが使用するホスト上のメモリの量が 512 MB であることを指定します。 New-SCHardwareProfile コマンドレットがハードウェア プロファイルを作成する前に、この最後のコマンドの JobGroup パラメーターは、同じ JobGroup GUID を指定する上記のすべてのコマンドレットを実行します。 New-SCVirtualNetworkAdapter、New-SCVirtualScsiAdapter、および New-SCVirtualDVDDrive を実行すると、作成された結果のオブジェクトは新しいハードウェア プロファイルに自動的に関連付けられます。

例 5: ハードウェア プロファイルを作成し、新しい仮想マシン テンプレートに追加する

PS C:\> $HWProfile = New-SCHardwareProfile -Name "NewHWProfile05" -CPUCount 4 -MemoryMB 64000 -CPUMax 100 -Owner "Contoso\Katarina" -HighlyAvailable $True 
PS C:\> $VHD = Get-SCVirtualHardDisk | where { $_.Name -eq "VHD01.vhd"  -and $_.LibraryServer.Name -eq "LibServer01.Contoso.com" }
PS C:\> $OS = Get-SCOperatingSystem | where {$_.Name -eq "64-bit edition of Windows Server 2008 R2 Datacenter"}
PS C:\> New-SCVMTemplate -Name "LargeVMTemplate" -HardwareProfile $HWProfile -OperatingSystem $OS -VirtualHardDisk $VHD -NoCustomization

最初のコマンドは、新しいハードウェア プロファイルを作成し、NewHWProfile05 という名前を付け、4 つのプロセッサが含まれていること、および仮想マシンで使用できるホスト上の 1 つの CPU の合計リソースの最大割合が 100% であることを指定し、64 GB の RAM と所有者を割り当て、 HighAvailable パラメーターを$Trueに設定します。 新しいハードウェア プロファイル オブジェクトを$HWProfile変数に格納します。 HighlyAvailable パラメーターは、このハードウェア プロファイルを使用して作成された仮想マシンを、直接またはテンプレートを使用して、ホスト クラスターのノードであるホストに配置することを指定します。

2 番目のコマンドは、VHD01 という名前の仮想ハード ディスク オブジェクトをライブラリから取得し、そのオブジェクトを $VHD 変数に格納します。

3 番目のコマンドは、オペレーティング システム オブジェクトを名前で取得し、そのオブジェクトを $OS 変数に格納します。

最後のコマンドでは、新しい仮想マシン テンプレートを作成し、LargeVMTemplate という名前を付け、オペレーティング システムに対するカスタマイズを行わずに、上記のコマンドで取得または作成したオペレーティング システム、ハードウェア プロファイル、および仮想ハード ディスクを使用するように指定します。

パラメーター

-AutomaticCriticalErrorAction

-AutomaticCriticalErrorActionTimeout

-BootOrder

-CapabilityProfile

-CheckpointType

-CPUCount

-CPUExpectedUtilizationPercent

-CPULimitForMigration

-CPULimitFunctionality

-CPUMaximumPercent

-CPUPerVirtualNumaNodeMaximum

-CPURelativeWeight

-CPUReserve

-CPUType

-Description

-DiskIops

-DRProtectionRequired

-DynamicMemoryBufferPercentage

-DynamicMemoryEnabled

-DynamicMemoryMaximumMB

-DynamicMemoryMinimumMB

-FirstBootDevice

-Generation

-HardwareProfile

-HAVMPriority

-HighlyAvailable

-JobGroup

-JobVariable

-MemoryMB

-MemoryPerVirtualNumaNodeMaximumMB

-MemoryWeight

-MonitorMaximumCount

-MonitorMaximumResolution

-Name

-NetworkUtilizationMbps

-NumaIsolationRequired

-NumLock

-Owner

-ProtectionProvider

-PROTipID

-RecoveryPointObjective

-ReplicationGroup

-RunAsynchronously

-SecureBootEnabled

-SecureBootTemplate

-UserRole

-VirtualNumaNodesPerSocketMaximum

-VirtualVideoAdapterEnabled

-VMMServer

出力

HardwareProfile

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

関連リンク

• Get-SCHardwareProfile
• Get-SCOperatingSystem
• Get-SCVirtualHardDisk
• New-SCVirtualDVDDrive
• New-SCVirtualNetworkAdapter
• New-SCVirtualScsiAdapter
• New-SCVMTemplate
• Remove-SCHardwareProfile
• Set-SCHardwareProfile