Set-SCVirtualMachine

リファレンス

モジュール:: VirtualMachineManager

VMM によって管理される仮想マシンのプロパティを変更します。

構文

Set-SCVirtualMachine
   [-VM] <VM>
   [-VMwareResourcePool <VmwResourcePool>]
   [-StartAction <VMStartAction>]
   [-StopAction <VMStopAction>]
   [-RemoveSelfServiceUserRole <Boolean>]
   [-EnableOperatingSystemShutdown <Boolean>]
   [-EnableTimeSync <Boolean>]
   [-EnableDataExchange <Boolean>]
   [-EnableHeartbeat <Boolean>]
   [-EnableBackup <Boolean>]
   [-InstallVirtualizationGuestServices <Boolean>]
   [-Owner <String>]
   [-OperatingSystem <OperatingSystem>]
   [-Enabled <Boolean>]
   [-HighlyAvailable <Boolean>]
   [-HAVMPriority <UInt32>]
   [-DRProtectionRequired <Boolean>]
   [-ReplicationGroup <ReplicationGroup>]
   [-SecureBootEnabled <Boolean>]
   [-NumLock <Boolean>]
   [-CPULimitFunctionality <Boolean>]
   [-CPULimitForMigration <Boolean>]
   [-VMShieldingData <KeyFile>]
   [-RunAsSystem]
   [-RunAsUserCredential <PSCredential>]
   [-DelayStartSeconds <Int32>]
   [-UseHardwareAssistedVirtualization <Boolean>]
   [-Cloud <Cloud>]
   [-CapabilityProfile <CapabilityProfile>]
   [-RemoveCapabilityProfile]
   [-RemoveFromCloud]
   [-ClusterNonPossibleOwner <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]>]
   [-ClusterPreferredOwner <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]>]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-UserRole <UserRole>]
   [-Name <String>]
   [-JobGroup <Guid>]
   [-QuotaPoint <UInt32>]
   [-CostCenter <String>]
   [-Tag <String>]
   [-Custom1 <String>]
   [-Custom2 <String>]
   [-Custom3 <String>]
   [-Custom4 <String>]
   [-Custom5 <String>]
   [-Custom6 <String>]
   [-Custom7 <String>]
   [-Custom8 <String>]
   [-Custom9 <String>]
   [-Custom10 <String>]
   [-BlockDynamicOptimization <Boolean>]
   [-ClearDRProtection]
   [-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>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

説明

Set-SCVirtualMachine コマンドレットは、Virtual Machine Manager (VMM) によって管理される仮想マシンのプロパティを変更します。

変更できるプロパティは次のとおりです。

仮想マシンをクラウドに関連付けます。
仮想マシンの名前、所有者、および説明。
仮想マシンが Hyper-V ホストにデプロイされている場合は、BIOS のブート順序。
仮想マシンによって使用されるホスト上のリソースの量。これらには、次のものが含まれます。
仮想マシンで使用できるホスト CPU リソースの最大量。
仮想マシンによるホスト CPU の使用が予想されます。
1 つの仮想マシンが同じホスト上の他の仮想マシンに対して相対的に使用するホスト CPU リソースの量。
仮想マシンで使用できるホストメモリの量。
仮想マシンで使用できるホストのネットワーク上の帯域幅の量。
ホストリソースに関係のない仮想マシンのハードウェア設定。これらには、次のものが含まれます。
[CPU 数]:
CPU の種類。
1 秒あたりのディスク入出力操作の数 (IOPS)。
Windows NT 4.0 などの古いオペレーティングシステムの CPU 機能を制限する。
条件で仮想マシンをフィルター処理するために使用されるコストセンター、タグ、およびカスタム設定。
次のようなさまざまなオプション機能を有効にする設定。
ライブラリオブジェクトを有効または無効にして、ユーザーがライブラリオブジェクトを使用できるようにする(または一時的に使用できないようにする)。
ボリュームシャドウコピーサービスを使用した Hyper-V ホストでの仮想マシンのバックアップを有効にする。
仮想マシンとその Hyper-V ホスト間のデータ交換のキーと値のペアを有効にします。
Hyper-V コンソールからの仮想マシンのシャットダウンの有効化。
仮想マシンとその Hyper-V ホスト間の時刻同期を有効にする。
Hyper-V ホスト上の仮想マシンに対して NumLock の BIOS 値を有効にします。
仮想マシンが高可用性であるか、つまり Hyper-V ホストクラスターまたは Citrix XenServer ホストクラスターのノードにデプロイされる仮想マシンであるかを識別する設定。
Hyper-V ホストにデプロイされた仮想マシンに仮想化ゲストサービスをインストールするかどうかを決定する設定。
仮想マシンを起動するまでの待機時間の秒数。
仮想マシンに使用されるオペレーティングシステムを識別する設定。
仮想マシンのアクションを開始および停止します。
セルフサービスユーザーが作成できる仮想マシンの数を制限する設定。
複数のロールに属するセルフサービスユーザーが仮想マシンの管理に使用するロールの切り替えに使用する設定。
ESX ホスト上の仮想マシンを VMware リソースプールに割り当てる設定。

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

例

例 1: 既存の仮想マシンのメモリ量を指定する

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> If($VM.Status -ne "PowerOff"){Stop-SCVirtualMachine -VM $VM}
PS C:\> Set-SCVirtualMachine -VM $VM -MemoryMB 1024

最初のコマンドは、VM01 という名前の仮想マシンオブジェクトを取得し、そのオブジェクトを $VM 変数に格納します。

2 つ目は、$VMに格納されている仮想マシンが電源オフ状態であるかどうかを判断します。仮想マシンが電源オフ状態でない場合、コマンドは Stop-SCVirtualMachine コマンドを使用して仮想マシンの電源をオフにします。仮想マシンの電源オフの詳細については、「」と入力します Get-Help Stop-SCVirtualMachine。

最後のコマンドは、VM01 に割り当てられるメモリを 1,024 MB に変更します。

例 2: 複数のセルフサービスユーザーロールに属するユーザーの仮想マシンの管理に使用するユーザーロールを変更する

PS C:\> $VM = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" -Name "VM02"
PS C:\> $SSRole = Get-SCUserRole -Name "ContosoSelfServiceUsers"
PS C:\> Set-SCVirtualMachine -VM $VM -UserRole $SSRole

最初のコマンドは、VMMServer01 から VM02 という名前の仮想マシンオブジェクトを取得し、そのオブジェクトを $VM 変数に格納します。

2 番目のコマンドは、ContosoSelfServiceUsers という名前のユーザーロールオブジェクトを取得し、そのオブジェクトを $SSRole 変数に格納します。

最後のコマンドでは、SSUserRole3 というセルフサービスユーザーロールのメンバーに、VM02 という仮想マシンを管理するアクセス許可が付与されるように指定します。

注: VMM では UserRole パラメーターを使用して、特定のセルフサービスユーザーロールのメンバーによって管理される仮想マシンを設定します。通常、この設定を構成するために、 Set-SCVirtualMachine コマンドレットを UserRole パラメーターと共に使用する必要はありません。ただし、1 人以上のユーザーが複数のセルフサービスユーザーロールのメンバーであり、同じホスト上の複数の仮想マシンを管理するためのアクセス許可をユーザーに付与した場合、特定の仮想マシンの管理が承認されているユーザーロールを切り替える必要がある場合があります。この例はこのシナリオに沿っています。

例 3: ドメインコントローラーとして使用される仮想マシンで時刻同期を無効にする

PS C:\> $EAP = $ErrorActionPreference
PS C:\> $ErrorActionPreference = "STOP"
PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> trap{"Fail: Cannot disable Time Synchronization for VM: $VM";continue} Set-SCVirtualMachine -VM $VM -EnableTimeSynchronization $TRUE | Out-Null
PS C:\> $ErrorActionPreference = $EAP

最初のコマンドは、$ErrorActionPreference の現在の設定を変数 $EAP に保管します。この変数は、後で設定を元の値に戻すために使用されます。

2 番目のコマンドは、アクション設定を STOP に設定します。このエラーアクション設定は、エラーを "終了しないエラー" から "終了するエラー" に変更するものです。エラーオブジェクトは、出力パイプに書き込まれるのではなく例外として発生し、コマンドは引き続き実行されません。

3 番目のコマンドは、VM03 という名前の仮想マシンオブジェクトを取得し、そのオブジェクトを $VM 変数に格納します。

4 番目のコマンドは、時刻同期設定を無効にします。通常、ドメインコントローラーとして機能する仮想マシンでは、時刻同期を無効にする必要があります。コマンドは 、trap ステートメントを使用して終了する例外をキャッチします。 Set-SCVirtualMachine コマンドが失敗すると、trap ステートメントの文字列が表示されます。終了する代わりに実行を続行するには、 トラップ ステートメントで Continue が使用されます。 Out-Null コマンドレットは、出力をコンソールに送る代わりに $Null にリダイレクトします。

最後のコマンドは、$ErrorActionPreference の値を $EAP に保管された値に設定します。

例 4: この機能をサポートするすべての仮想マシンのデバイスの開始順序を設定する

PS C:\> $EAP = $ErrorActionPreference
PS C:\> $ErrorActionPreference = "Stop"
PS C:\> $VMs = @(Get-SCVirtualMachine)
PS C:\> ForEach($VM in $VMs){trap{"Fail: Cannot set BIOS for VM: $VM";continue} Set-SCVirtualMachine -VM $VM -BootOrder "PXEBoot","IDEHarddrive","CD","Floppy" | Out-Null}
PS C:\> $ErrorActionPreference = $EAP

最初のコマンドは、$ErrorActionPreference の現在の設定を $EAP に保管します。この変数は、後で設定を元の値に戻すために使用されます。

2 番目のコマンドは、エラーアクションの基本設定を [停止] に設定します。このエラーアクション設定は、エラーを "終了しないエラー" から "終了するエラー" に変更するものです。エラーオブジェクトは、出力パイプに書き込まれるのではなく例外として発生し、コマンドは引き続き実行されません。

3 番目のコマンドは、$VMsにオブジェクトを格納する各仮想マシンオブジェクトを取得します。 @ 記号とかっこを使用すると、コマンドが単一のオブジェクトまたは null 値を返した場合に、コマンドによって結果が配列に格納されます。

4 番目のコマンドは、各仮想マシンの BIOS ブート順序を PXEBoot、IDEHarddrive、CD、フロッピーに設定します。コマンドはトラップステートメントを使用して、終了する例外をキャッチします。 Set-SCVirtualMachine コマンドが失敗すると、trap ステートメントの文字列が表示されます。 ForEach ループを終了する代わりに、トラップステートメントで Continue を使用して実行を続行します。 Out-Null コマンドレットは、出力をコンソールに送信するのではなく、$Nullにリダイレクトします。

注: BootOrder パラメーターは、Hyper-V および Citrix XenServer ホスト上の仮想マシンにのみ使用されます。 VMware ESX ホスト上の仮想マシンには使用されません。 XenServerホストはフロッピーディスクをサポートしていないため、ブート順に表示されている場合はフロッピーを無視します。

最後のコマンドは、$ErrorActionPreference の値を $EAP に保管された値に設定します。

標準の Windows PowerShell ForEach ループステートメントの詳細については、「」と入力しますGet-Help about_ForEach。

例 5: 所有者のないすべての仮想マシンの所有者を指定する

PS C:\> Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | where {$_.Owner -eq ""} | Set-SCVirtualMachine -Owner "Contoso\ReneeLo"

このコマンドは、VMMServer01 上のすべての仮想マシンオブジェクトを取得し、所有者が一覧表示されていない仮想マシンオブジェクトのみを選択し、各仮想マシンの所有者を指定します。

例 6: 既存の仮想マシンの動的メモリを有効にする

PS C:\> $VM = Get-SCVirtualMachine -Name "VM06"
PS C:\> if($VM.Status -ne "PowerOff"){Stop-SCVirtualMachine -VM $VM}
PS C:\> Set-SCVirtualMachine -VM $VM -DynamicMemoryEnabled $True -MemoryMB 1024 -DynamicMemoryMaximumMB 2048

最初のコマンドは仮想マシンオブジェクト VM06 を取得し、そのオブジェクトを $VM 変数に格納します。仮想マシンで動的メモリを有効にするには、仮想マシンが Windows Server 2008 R2 SP1 以降のバージョンを実行するホスト上に存在する必要があります。

2 番目のコマンドは、$VMに格納されている仮想マシンが電源オフ状態であるかどうかを判断します。仮想マシンが電源オフ状態でない場合、コマンドは Stop-SCVirtualMachine コマンドを使用して仮想マシンの電源をオフにします。

最後のコマンドは動的メモリを有効にし、スタートアップメモリを 1024 MB に設定し、最大メモリを 2048 MB に設定します。スタートアップメモリは、起動時に VM06 に割り当てられるホスト上のメモリの量です。最大メモリは、VM06 に割り当てられているホスト上の最大メモリ量です。

パラメーター

-AutomaticCriticalErrorAction

仮想マシンで重大なエラーが発生し、 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

-AvailabilitySetNames

可用性セット名の一覧を指定します。

Type:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BlockDynamicOptimization

仮想マシンの動的最適化がブロックされているかどうかを示します。

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

-BootOrder

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

CD
IDEHardDrive
PXEBoot
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

-ClearDRProtection

このコマンドレットがデータ回復保護オプションをリセットすることを示します。

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

-Cloud

プライベートクラウドオブジェクトを指定します。

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

-ClusterNonPossibleOwner

指定した仮想マシンで使用できないクラスターノード所有者の名前の一覧を指定します。

Type:	System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClusterPreferredOwner

特定の仮想マシンの優先クラスターノード所有者の名前の一覧を指定します。

Type:	System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CostCenter

仮想マシンのコストセンターを指定します。課金システムの仮想マシンに割り当てられた仮想マシンまたはリソースの割り当てに関するデータを収集できます。

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

-CPUCount

仮想マシン上の CPU の数を指定します。次のホストは、次の数のプロセッサをサポートしています。

Hyper-V。ゲストオペレーティングシステムに応じて、仮想マシンあたり最大 4 つの CPU。
VMware ESX。サポートされているゲストオペレーティングシステムの仮想マシンあたり最大 4 つの CPU(4.0 Windows NT実行する仮想マシン上の 1 つの CPU を除く)。
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 などの古いオペレーティングシステムをサポートするには、$Trueの値を指定します。

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

-CPUMaximumPercent

仮想マシンが同時に使用できるホスト上の 1 つの CPU の合計リソースの最大割合を指定します。

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。高。 2000.
VMware ESX。標準より上。 1500.
VMware ESX。標準 (既定値)。 1000。
VMware ESX。標準より下。 750.
VMware ESX。低。 500.
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

仮想マシンに割り当てるホスト上の 1 つの 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

-Custom1

仮想マシンのカスタムプロパティを指定します。

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

-Custom10

仮想マシンのカスタムプロパティを指定します。

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

-Custom2

仮想マシンのカスタムプロパティを指定します。

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

-Custom3

仮想マシンのカスタムプロパティを指定します。

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

-Custom4

仮想マシンのカスタムプロパティを指定します。

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

-Custom5

仮想マシンのカスタムプロパティを指定します。

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

-Custom6

仮想マシンのカスタムプロパティを指定します。

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

-Custom7

仮想マシンのカスタムプロパティを指定します。

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

-Custom8

仮想マシンのカスタムプロパティを指定します。

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

-Custom9

仮想マシンのカスタムプロパティを指定します。

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

-DelayStartSeconds

仮想化サービスの開始後バーチャルマシンが自動的に起動するまでの待機時間を秒数で指定します。

この遅延により、物理コンピューターリソースの需要を減らすために、複数の仮想マシンの起動時間がずれます。通常は、30 ～ 60 秒に設定します。ホストの構成可能な最大遅延は次のとおりです。

Hyper-V。 1000000000 秒 (277777 時間)
VMware ESX。 65535 秒 (18 時間)

このパラメーターは、XenServer 仮想マシンには適用されません。

Type:	Int32
Aliases:	DelayStart
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) を指定します。

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 です。

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 以降のバージョンを実行するホストに制限されます。

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

-DynamicMemoryMaximumMB

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

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

-DynamicMemoryMinimumMB

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

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

-EnableBackup

このコマンドレットを使用して、ボリュームシャドウコピーサービスで仮想マシンをバックアップできるかどうかを示します。仮想マシンは Hyper-V ホストにデプロイする必要があります。

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

-Enabled

このコマンドレットで仮想マシンを有効または無効にするかどうかを示します。

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

-EnableDataExchange

このコマンドレットが、仮想マシンとホストオペレーティングシステム間のデータ交換に対するキーと値のペアの使用を有効または無効にするかどうかを示します。仮想マシンは Hyper-V ホストにデプロイする必要があります。

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

-EnableHeartbeat

このコマンドレットが、仮想マシンの正常性を監視するためのハートビートの使用を有効または無効にするかどうかを示します。ハートビートは、設定された間隔で出力される信号です。仮想マシンは Hyper-V ホストにデプロイする必要があります。

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

-EnableNestedVirtualization

入れ子になった仮想化を有効にします。

注意

このパラメーターは、VMM 2019 UR1 以降に適用できます。

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

-EnableOperatingSystemShutdown

このコマンドレットが、ホスト上の Hyper-V 管理インターフェイスから VMM によって管理される仮想マシン上のオペレーティングシステムのシャットダウンを有効または無効にするかどうかを示します。仮想マシンは Hyper-V ホストにデプロイする必要があります。

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

-EnableTimeSync

このコマンドレットで、仮想マシンのシステム時刻とホスト上で実行されるオペレーティングシステムのシステム時刻の同期を有効または無効にするかどうかを示します。仮想マシンは Hyper-V ホストにデプロイする必要があります。

Type:	Boolean
Aliases:	EnableTimeSynchronization
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

-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

-InstallVirtualizationGuestServices

このコマンドレットが Windows ベースの仮想マシンに仮想化ゲストサービスをインストールするかどうかを示します。既定値は$Falseであり、VMM によって適切な仮想化ゲストサービスが自動的にインストールされます。

Hyper-V ホスト上の仮想マシンの場合、仮想化ゲストサービスは統合コンポーネントまたはVMGuest.isoと呼ばれます。 XenServer ホスト上の仮想マシンの場合、仮想化ゲストサービスは Citrix Tools for Virtual Machines または xs-tools.iso と呼ばれます。 VMware ESX ホスト上のバーチャルマシンは、仮想化ゲストサービスを使用しません。

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 です。動的メモリが有効になっている仮想マシンの場合は、スタートアップメモリの値を指定します。割り当て可能な最大ホストメモリは次のとおりです。

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 ノードを許可するメモリの最大量をメガバイト単位で指定します。

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

-MemoryWeight

同じホスト上の他の仮想マシンを基準にして、仮想マシンにメモリを割り当てる優先順位を指定します。ホストは、設定が低い仮想マシンよりも高い値を持つ仮想マシンに、より多くのメモリを割り当てます。 Windows Server 2008 R2 SP1 以降のバージョンを実行するホストの場合、既定値は次のとおりです。

低。 0
標準。 5000
高。 10,000
カスタム。 10,000

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 です。

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

-Name

仮想マシンの名前を指定します。

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

-NetworkUtilizationMbps

仮想マシンで使用できるホストネットワーク上の帯域幅の量 (メガビット/秒 (Mbps) を指定します。

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

このコマンドレットが仮想マシン上の NumLock の BIOS 値を有効または無効にするかどうかを示します。仮想マシンは Hyper-V ホストにデプロイする必要があります。

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

-OnBehalfOfUser

ユーザー名を指定します。このコマンドレットは、このパラメーターが指定したユーザーの代わりに動作します。

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

-OnBehalfOfUserRole

ユーザーロールを指定します。ユーザーロールを取得するには、 Get-SCUserRole コマンドレットを使用します。このコマンドレットは、このパラメーターが指定するユーザーロールの代わりに動作します。

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

-OperatingSystem

バーチャルマシンのオペレーティングシステムの種類を指定します。 VMM で使用可能なすべてのオペレーティングシステムの名前を一覧表示するには、 Get-SCOperatingSystem コマンドレットを使用します。

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

-Owner

仮想マシンの所有者を有効なドメインユーザーアカウントとして指定します。

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

-QuotaPoint

セルフサービスユーザーがデプロイできる仮想マシンの数を制限するクォータを指定します。

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

-RemoveFromCloud

このコマンドレットは、仮想マシンがクラウドに対して持っている関連付けを削除することを示します。

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

-RemoveSelfServiceUserRole

このコマンドレットが、指定したセルフサービスユーザーロールを仮想マシンのアクセス許可リストから削除するかどうかを示します。

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

-ReplicationGroup

レプリケーショングループを指定します。

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

-RunAsSystem

仮想マシンがローカルシステムアカウントで実行されることを示します。

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

-RunAsUserCredential

仮想マシンを実行するゲストアカウントを指定します。

セキュリティを強化するために、アクセス許可が制限されている特別なアカウントを作成します。最小アクセス許可は次のとおりです。

.vmc ファイル。データの読み取り、データの書き込み、ファイルの実行
.vmc フォルダー。フォルダーの一覧表示、仮想マシンの状態を保存するためのファイルの書き込み/作成
.vhd ファイル。データの読み取り、属性の読み取り、拡張属性の読み取り、データの書き込み
.vnc ファイル。ファイルの実行、データの読み取り、属性の読み取り、仮想マシンが仮想ネットワークに接続した場合の読み取り

このパラメーターは、Hyper-V、VMware ESX、または Citrix XenServer ホストの仮想マシンには適用されません。

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

第 2 世代仮想マシンに使用するセキュアブートテンプレートを指定します。

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

-StartAction

仮想化サービスの起動時の仮想マシンの動作を指定します。有効な値は次のとおりです。

AlwaysAutoTurnOnVM
NeverAutoTurnOnVM
TurnOnVMIfRunningWhenVSStopped

Type:	VMStartAction
Accepted values:	NeverAutoTurnOnVM, AlwaysAutoTurnOnVM, TurnOnVMIfRunningWhenVSStopped
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StopAction

仮想化サービスが停止したときの仮想マシンの動作を指定します。有効な値は次のとおりです。

SaveVM
TurnOffVM
ShutdownGuestOS

Type:	VMStopAction
Accepted values:	SaveVM, TurnOffVM, ShutdownGuestOS
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

仮想マシンに関連付ける単語または語句を指定します。指定したタグのセットを持つすべてのオブジェクトを検索できます。タグのサブセットを検索することも、タグの完全なセットを検索することもできます。

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

-UseHardwareAssistedVirtualization

ハードウェア支援仮想化が使用可能な場合に使用されるかどうかを示します。

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

-UserRole

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

Type:	UserRole
Aliases:	SelfServiceUserRole
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 以降のバージョンを実行するホストへのマシンの配置が制限されます。

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

-VM

仮想マシンオブジェクトを指定します。

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

-VMShieldingData

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

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

-VMwareResourcePool

VMware リソースプールを指定します。このコマンドレットは、VMware ESX ホストまたはプライベートクラウドにデプロイされた仮想マシンを、このパラメーターが指定するリソースプールに割り当てます。

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

出力

VirtualMachine

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

メモ

このコマンドレットには、 Get-SCVirtualMachine コマンドレットを使用して取得できる VMM 仮想マシンオブジェクトが必要です。

次の方法で共有

Set-SCVirtualMachine

構文

説明

例

例 1: 既存の仮想マシンのメモリ量を指定する

例 2: 複数のセルフサービス ユーザー ロールに属するユーザーの仮想マシンの管理に使用するユーザー ロールを変更する

例 3: ドメイン コントローラーとして使用される仮想マシンで時刻同期を無効にする

例 4: この機能をサポートするすべての仮想マシンのデバイスの開始順序を設定する

例 5: 所有者のないすべての仮想マシンの所有者を指定する

例 6: 既存の仮想マシンの動的メモリを有効にする

パラメーター

-AutomaticCriticalErrorAction

-AutomaticCriticalErrorActionTimeout

-AvailabilitySetNames

-BlockDynamicOptimization

-BootOrder

-CapabilityProfile

-CheckpointType

-ClearDRProtection

-Cloud

-ClusterNonPossibleOwner

-ClusterPreferredOwner

-CostCenter

-CPUCount

-CPUExpectedUtilizationPercent

-CPULimitForMigration

-CPULimitFunctionality

-CPUMaximumPercent

-CPUPerVirtualNumaNodeMaximum

-CPURelativeWeight

-CPUReserve

-CPUType

-Custom1

-Custom10

-Custom2

-Custom3

-Custom4

-Custom5

-Custom6

-Custom7

-Custom8

-Custom9

-DelayStartSeconds

-Description

-DiskIops

-DRProtectionRequired

-DynamicMemoryBufferPercentage

-DynamicMemoryEnabled

-DynamicMemoryMaximumMB

-DynamicMemoryMinimumMB

-EnableBackup

-Enabled

-EnableDataExchange

-EnableHeartbeat

-EnableNestedVirtualization

-EnableOperatingSystemShutdown

-EnableTimeSync

-FirstBootDevice

-HAVMPriority

-HighlyAvailable

-InstallVirtualizationGuestServices

-JobGroup

-JobVariable

-MemoryMB

-MemoryPerVirtualNumaNodeMaximumMB

-MemoryWeight

-MonitorMaximumCount

-MonitorMaximumResolution

-Name

-NetworkUtilizationMbps

-NumaIsolationRequired

-NumLock

-OnBehalfOfUser

-OnBehalfOfUserRole

-OperatingSystem

-Owner

-ProtectionProvider

-PROTipID

-QuotaPoint

例 2: 複数のセルフサービスユーザーロールに属するユーザーの仮想マシンの管理に使用するユーザーロールを変更する

例 3: ドメインコントローラーとして使用される仮想マシンで時刻同期を無効にする