Set-SCHardwareProfile

リファレンス

モジュール:: VirtualMachineManager

VMM で使用されるハードウェアプロファイルのプロパティを変更します。

構文

Set-SCHardwareProfile
   [-HardwareProfile] <HardwareProfile>
   [-HighlyAvailable <Boolean>]
   [-HAVMPriority <UInt32>]
   [-DRProtectionRequired <Boolean>]
   [-ReplicationGroup <ReplicationGroup>]
   [-SecureBootEnabled <Boolean>]
   [-NumLock <Boolean>]
   [-CPULimitFunctionality <Boolean>]
   [-CPULimitForMigration <Boolean>]
   [-Name <String>]
   [-RemoveCapabilityProfile]
   [-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>]

説明

Set-SCHardwareProfile コマンドレットは、仮想マシンマネージャー (VMM) 環境で使用されるハードウェアプロファイルオブジェクトの 1 つ以上のプロパティを変更します。変更できるプロパティとしては、ブート順序の設定、CPU 設定、仮想マシンに割り当てられるホストのメモリの量、およびその他のオプションなどの設定があります。

特定のハードウェアプロファイルに関連付けられている仮想フロッピードライブ、仮想 DVD ドライブ、仮想 COM ポート、仮想ネットワークアダプター、または仮想 SCSI アダプターのプロパティを変更するには、それぞれ Set-SCVirtualFloppyDrive、Set-SCVirtualDVDDrive、Set-SCVirtualNetworkAdapter、または Set-SCVirtualScsiAdapter コマンドレットを使用します。

ハードウェアプロファイルに対して行う変更によって影響を受けるのは、そのハードウェアプロファイル自体のみです。この変更は、このプロファイルを使用して作成された既存の仮想マシンには影響しません。

例

例 1: 既存のハードウェア・プロファイルのメモリーの量を指定する

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> Set-SCHardwareProfile -HardwareProfile $HWProfile -MemoryMB 1024

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

2 番目のコマンドは、NewHWProfile01 のメモリ値を 1024 MB に変更します。

例 2: 複数のハードウェアプロファイルの新しい所有者を指定する

PS C:\> $HWProfiles = Get-SCHardwareProfile | where {$_.Name -match "Profile"}
PS C:\> ForEach ($HWProfile in $HWProfiles) {Set-SCHardwareProfile -HardwareProfile $HWProfile -Owner "Contoso\Cesar"}

最初のコマンドは、検索条件に一致するハードウェアプロファイルオブジェクトを取得し、$HWProfiles オブジェクト配列にオブジェクトを格納します。

2 番目のコマンドでは、 ForEach ステートメントを使用して、配列内の各プロファイルの新しい所有者を指定します。

標準の PowerShell ForEach ループステートメントの詳細については、「 Get-Help about_ForEach.

例 3: 複数のハードウェアプロファイルの新しいブート順序を指定する

PS C:\> $HWProfiles = @(Get-SCHardwareProfile | where {$_.Name -match "HWProfile"})
PS C:\> ForEach ($HWProfile in $HWProfiles) {Set-SCHardwareProfile -HardwareProfile $HWProfile -BootOrder PXEBoot,CD,IDEHardDrive,Floppy}

最初のコマンドは、検索条件に一致するライブラリ (プロファイル名に文字列 "HWProfile" が含まれている) ハードウェアプロファイルオブジェクトをすべて取得し、ハードウェアプロファイルオブジェクトを $HWProfiles オブジェクト配列に格納します。 @ 記号とかっこを使用すると、コマンドから単一のオブジェクトまたは$Null値が返された場合に、結果が配列に確実に格納されます。

2 番目のコマンドでは、 ForEach ステートメントを使用して、$HWProfiles配列内の各ハードウェアプロファイルオブジェクトの新しいブート順序を指定します。

例 4: 特定の構成を持つハードウェアプロファイルを検索し、説明フィールドにテキストを追加する

PS C:\> $HWProfiles = @(Get-SCHardwareProfile | where {$_.CPUCount -eq 4})
PS C:\> ForEach ($HWProfile in $HWProfiles) {$Text = $HWProfile.Description; Set-SCHardwareProfile -HardwareProfile $HWProfile -Description $Text" (Contains four Processors)"}

最初のコマンドは、検索条件に一致するすべてのハードウェアプロファイルオブジェクト (CPU 数が 4) を取得し、$HWProfiles オブジェクト配列にハードウェアプロファイルオブジェクトを格納します。

2 番目のコマンドでは、 ForEach ステートメントを使用して、$HWProfiles配列内の各プロファイルオブジェクトを反復処理します。プロファイルごとに説明テキストが変数 ($Text) に格納され、 Set-SCHardwareProfile コマンドレットは Description パラメーターを使用して、$Textの各インスタンスの内容に "(4 つのプロセッサを含む) " を追加します。

例 5: 既存のハードウェアプロファイルに対して動的メモリを有効にする

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile05" }
PS C:\> Set-SCHardwareProfile -HardwareProfile $HWProfile -DynamicMemoryEnabled $True -MemoryMB 1024 -DynamicMemoryMaximumMB 2048

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

2 番目のコマンドは、NewHWProfile05 の動的メモリを有効にし、スタートアップメモリの値を 1024 MB に変更し、最大メモリ値を 2048 MB に設定します。

パラメーター

-AutomaticCriticalErrorAction

VM で重大なエラーが発生したときに実行するアクションを指定し、 AutomaticCriticalErrorActionTimeout パラメーターで指定されたタイムアウト時間を超えています。このパラメーターで使用できる値は、Pause と None です。

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

-AutomaticCriticalErrorActionTimeout

仮想マシンの電源を切るまでの重大な一時停止を待機する時間を分単位で指定します。

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

-BootOrder

Hyper-V ホスト上の仮想マシンが開始に使用するデバイスの順序を配列として指定します。有効な値は次のとおりです。

CD
IDEHardDrive
PXEBoot
Floppy

形式の例: -BootOrder PXEBoot,IDEHardDrive,CD,Floppy

Type:	BootDevice[]
Accepted values:	Floppy, CD, IdeHardDrive, PxeBoot, Unknown
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CapabilityProfile

機能プロファイルオブジェクトを指定します。

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

-CheckpointType

チェックポイントの種類を指定します。このパラメーターの有効値は、次のとおりです。

無効
Production
ProductionOnly
Standard

Type:	CheckpointType
Accepted values:	Disabled, Production, ProductionOnly, Standard
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CPUCount

仮想マシン、ハードウェアプロファイル、またはテンプレートの CPU 数を指定します。

ホストの種類は、次の数の CPU をサポートします。

Hyper-V。ゲストオペレーティングシステムに応じて、仮想マシンあたり最大 4 つの CPU。
VMware ESX。仮想マシンあたり最大 4 つの CPU ですが、4.0 Windows NT実行する仮想マシン上の CPU は 1 つだけです。
Citrix XenServer。ゲストオペレーティングシステムに応じて、仮想マシンあたり最大 8 個の CPU。

Type:	Byte
Aliases:	ProcessorCount
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CPUExpectedUtilizationPercent

この仮想マシンで使用する必要があるホスト上の CPU の割合を指定します。この値は、VMM がバーチャルマシン用の適切なホストを決定する場合にのみ使用されます。

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

-CPULimitForMigration

ソースコンピューターと同じプロセッサのバージョンが異なる物理コンピューターへの移行を有効にするために、指定された仮想マシンのプロセッサ機能を制限するかどうかを示します。物理コンピュータに搭載されるプロセッサの製造元が互いに異なる場合、VMM はその物理コンピュータ間の移行をサポートしません。

Type:	Boolean
Aliases:	LimitCPUForMigration
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CPULimitFunctionality

仮想マシンの CPU 機能を制限することで、Hyper-V ホストまたは VMware ESX ホストにデプロイされた仮想マシンで、Windows NT 4.0 などの古いオペレーティングシステムの実行を有効にするかどうかを示します。

Type:	Boolean
Aliases:	LimitCPUFunctionality
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CPUMaximumPercent

ホスト上の単一の CPU について (特定の仮想マシンがいつでも使用できる CPU)、リソース合計に対する最高の割合を指定します。

例: -CPUMaximumPercent 80 (80% を指定する場合)

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

-CPUPerVirtualNumaNodeMaximum

仮想 NUMA ノードごとに許可される CPU の最大数を指定します。

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

-CPURelativeWeight

同じホスト上の他の仮想マシンに対して、この仮想マシンが使用できるホスト上の CPU リソースの量を指定します。重み値が高い仮想マシンには、重量値が低い仮想マシンよりも多くの CPU リソースが割り当てられます。これらの値の VMware 用語は共有です。

ホストの種類は、次の相対値をサポートします。

Hyper-V。 1 ~ 10000。
VMware ESX。高。

VMware ESX。通常より上。

VMware ESX。標準 (既定)。 1000。
VMware ESX。標準より下。

VMware ESX。低。

VMware ESX。カスタム 1 ~ 1000000。
Citrix XenServer。 1 ~ 65536、通常は 256 です。

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

-CPUReserve

バーチャルマシンに割り当てる、ホスト上の単一の CPU のリソースの最小の割合を指定します。バーチャルマシンで使用可能な CPU 容量の割合がこの割合を下回ることはありません。

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

-CPUType

仮想マシンの CPU の種類を指定します。 VMM 環境の仮想マシンで使用できるすべての CPU の種類の一覧を取得するには、次のように入力します Get-SCCPUType。

Type:	ProcessorType
Position:	Named
Default value:	None
Required:	False
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

-DiskIops

特定の仮想マシンで使用可能な、ホスト上の 1 秒あたりのディスク入出力操作 (IOPS) の回数を指定します。

例: -DiskIO 1500 (1500 IOPS を指定する場合)

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

-DRProtectionRequired

このパラメーターは将来使用するために予約されています。

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

-DynamicMemoryBufferPercentage

ホストがバッファーとして予約しようとする仮想マシンの現在のメモリ割り当てより上のメモリの割合を指定します。既定値は 20 です。

形式の例: -DynamicMemoryTargetBufferPercentage 20

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

-DynamicMemoryEnabled

仮想マシンの動的メモリを有効にするかどうかを示します。動的メモリは、仮想マシンで直接有効にすることも、仮想マシンを作成するのに使用するテンプレートまたはハードウェアプロファイルで有効にすることもできます。既定値は$Falseです。

必須: 仮想マシンが Windows Server 2008 SP1 以降を実行しているホストに仮想マシンがデプロイされている場合、または仮想マシンがライブラリに停止状態で格納されている場合にのみ、仮想マシンの動的メモリを有効にすることができます (仮想マシンにスナップショットがない場合にのみ、格納されている仮想マシンに対するハードウェアの変更を行うことができます)。ライブラリに格納されている仮想マシンで動的メモリを有効にすると、そのマシンを Windows Server 2008 SP1 以降を実行するホストへの配置が制限されます。

形式の例: -DynamicMemoryEnabled $True

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

-DynamicMemoryMaximumMB

動的メモリが有効になっている場合に仮想マシンに割り当てることができるメモリの最大量を指定します。既定値は 65536 です。

必須: 仮想マシンが Windows Server 2008 R2 SP1 以降を実行しているホストに仮想マシンがデプロイされている場合、または仮想マシンがライブラリに停止状態で格納されている場合にのみ、仮想マシンの動的メモリを有効にすることができます (仮想マシンにスナップショットがない場合にのみ、格納されている仮想マシンに対するハードウェアの変更を行うことができます)。ライブラリに保管されている仮想マシンの動的メモリを有効にすると、そのマシンは、Windows Server 2008 R2 SP1 以降を実行しているホストにしか配置できなくなります。

形式の例: -DynamicMemoryMaximumMB 1024

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

-DynamicMemoryMinimumMB

動的メモリが有効になっている場合に仮想マシンに割り当てることができるメモリの最小量を指定します。既定値は 65536 です。

形式の例: -DynamicMemoryMinimumMB 1024

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

-FirstBootDevice

ブートが最初に試行されるデバイスを指定します。

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

-HardwareProfile

ハードウェアプロファイルオブジェクトを指定します。

Type:	HardwareProfile
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-HAVMPriority

仮想マシンの優先度を指定します。仮想マシンは、ホストクラスターノードの上限までの優先順位で開始されます。このパラメーターに対して有効な入力は、優先度の数値表現です。

高。 3000
中。 2000
低。 1000

ゼロ (0) の値を指定した場合、仮想マシンは自動的に再起動しません。

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

-HighlyAvailable

ホストクラスターの一部である Hyper-V ホストに仮想マシンを配置するかどうかを示します。この設定は、バーチャルマシンで構成するか、バーチャルマシンの作成に使用するテンプレートまたはハードウェアプロファイルで構成できます。

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

-JobGroup

同じジョブグループ識別子を含む最後のコマンドが実行される直前に一括して実行される、一連のコマンドの識別子を指定します。

Type:	Guid
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

-MemoryMB

変換された仮想マシンにこのコマンドレットが割り当てるホスト上のランダムアクセスメモリ (RAM) の量を MB (MB) 単位で指定します。既定値は 512 MB です。 Windows Server 2008 R2 SP1 以降のバージョンを実行するホストで動的メモリが有効になっている仮想マシンの場合は、スタートアップメモリの値を指定します。

ホストの種類には、仮想マシンに割り当て可能な最大メモリが次のとおりです。

Hyper-V。仮想マシンあたり最大 65536 MB の RAM。
VMware ESX Server 3.0.x。仮想マシンあたり最大 16384 MB の RAM。
VMware ESX Server 3.5.x。仮想マシンあたり最大 65532 MB の RAM。
Citrix XenServer。仮想マシンあたり最大 32265 MB の RAM。

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

-MemoryPerVirtualNumaNodeMaximumMB

各仮想 NUMA ノードが許可される最大メモリ量を MB 単位で指定します。

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

-MemoryWeight

同じホスト上の他の仮想マシンに対して相対的に、仮想マシンにメモリを割り当てる優先順位を示します。高い設定値の仮想マシンに、低い設定値の仮想マシンよりも多くのメモリリソースが割り当てられます。

Windows Server 2008 R2 SP1 以降を実行しているホストの場合:

5000 - 標準
10000 - 高
0 - 低
1 から 10000 - カスタム

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

-MonitorMaximumCount

仮想ビデオアダプターがサポートするモニターの最大数を指定します。

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

-MonitorMaximumResolution

仮想ビデオアダプターの可能な最大モニター解像度を表す値を文字列として指定します。このパラメーターの有効値は、次のとおりです。

1024 × 768
1280x1024
1600 × 1200
1920x1200

既定値は 1280x1024 です。

形式の例: -MonitorResolutionMaximum "1600x1200"

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

-Name

VMM オブジェクトの名前を指定します。

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

-NetworkUtilizationMbps

特定の仮想マシンで使用できるホストのネットワーク上の帯域幅の量を、1 秒あたりのメガビット数 (Mbps) 単位で指定します。

形式の例: -NetworkUtilization 10

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

-NumaIsolationRequired

NUMA 分離が必要かどうかを示します。

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

-NumLock

Hyper-V ホストで仮想マシンを作成するために使用されるハードウェアプロファイルで NumLock の BIOS 値を有効にするかどうかを示します。このパラメーターは、VMware ESX ホストまたは Citrix XenServer ホスト上の仮想マシンには適用されません。

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

-Owner

有効なドメインユーザーアカウントの形式で VMM オブジェクトの所有者を指定します。

形式の例: -Owner "Contoso\PattiFuller"
形式の例: -Owner "PattiFuller@Contoso"

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

-ProtectionProvider

保護プロバイダーを指定します。

Type:	ProtectionProvider
Accepted values:	None, HVR8, HVRBlue, HVRAzure, DiskReplication, SANReplication
Position:	Named
Default value:	None
Required:	False
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

-RecoveryPointObjective

重大なインシデントが原因で IT サービスからデータを失う許容できる最大期間を指定します。

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

-RemoveCapabilityProfile

指定した 1 つ以上の機能プロファイルオブジェクトを削除します。

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

-ReplicationGroup

ReplicationGroup オブジェクトを指定します。

Type:	ReplicationGroup
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

-SecureBootEnabled

セキュアブートが有効かどうかを示します。

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

-SecureBootTemplate

セキュアブートテンプレートを指定します。

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

-UserRole

ユーザーロールオブジェクトを指定します。

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

-VirtualNumaNodesPerSocketMaximum

ソケットごとに許可される NUMA ノードの最大数を指定します。

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

-VirtualVideoAdapterEnabled

仮想マシンに対して Microsoft Synthetic 3D Virtual Video Adapter を有効にするかどうかを示します。仮想マシン上で直接、または仮想マシンの作成に使用されるテンプレートまたはハードウェアプロファイルで、仮想ビデオアダプターを有効にすることができます。

必須: 仮想マシンに対して Microsoft Synthetic 3D Virtual Video Adapter を有効にできるのは、その仮想マシンが Windows Server 2008 R2 SP1 (リモートデスクトップサービスの役割とリモートデスクトップ仮想グラフィックス役割サービスがインストールされている) を実行しているホストに展開されている場合、または仮想マシンが停止状態でライブラリに格納されている場合 (仮想マシンに対するハードウェアの変更は、仮想マシンの場合にのみ行うことができます)マシンにスナップショットがありません)。ライブラリに格納されている仮想マシンで Microsoft Synthetic 3D Virtual Video Adapter を有効にすると、そのマシンを Windows Server 2008 R2 SP1 を実行しているホスト (リモートデスクトップサービスロールとリモートデスクトップ仮想グラフィックスロールサービスがインストールされている) 以降への配置が制限されます。

形式の例: -VirtualVideoAdapterEnabled $True

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

出力

HardwareProfile

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

次の方法で共有