Set-VM

Set-VM

Configures a virtual machine.

구문

Parameter Set: Name
Set-VM [-Name] <String[]> [-AllowUnverifiedPaths] [-AutomaticStartAction <StartAction> ] [-AutomaticStartDelay <Int32> ] [-AutomaticStopAction <StopAction> ] [-ComputerName <String[]> ] [-DynamicMemory] [-MemoryMaximumBytes <Int64> ] [-MemoryMinimumBytes <Int64> ] [-MemoryStartupBytes <Int64> ] [-NewVMName <String> ] [-Notes <String> ] [-Passthru] [-ProcessorCount <Int64> ] [-SmartPagingFilePath <String> ] [-SnapshotFileLocation <String> ] [-StaticMemory] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: VMObject
Set-VM [-VM] <VirtualMachine[]> [-AllowUnverifiedPaths] [-AutomaticStartAction <StartAction> ] [-AutomaticStartDelay <Int32> ] [-AutomaticStopAction <StopAction> ] [-DynamicMemory] [-MemoryMaximumBytes <Int64> ] [-MemoryMinimumBytes <Int64> ] [-MemoryStartupBytes <Int64> ] [-NewVMName <String> ] [-Notes <String> ] [-Passthru] [-ProcessorCount <Int64> ] [-SmartPagingFilePath <String> ] [-SnapshotFileLocation <String> ] [-StaticMemory] [-Confirm] [-WhatIf] [ <CommonParameters>]

자세한 설명

The Set-VM cmdlet configures a virtual machine.

매개 변수

-AutomaticStartAction<StartAction>

Specifies the action the virtual machine is to take upon start. Allowed values are Nothing, StartIfRunning, and Start.

-AutomaticStartDelay<Int32>

Specifies the number of seconds by which the virtual machine’s start should be delayed.

-AutomaticStopAction<StopAction>

Specifies the action the virtual machine is to take when the virtual machine host shuts down. Allowed values are TurnOff, Save, and ShutDown.

-ComputerName<String[]>

Specifies one or more Hyper-V hosts on which the virtual machine is to be configured. NetBIOS names, IP addresses, and fully-qualified domain names are allowable. The default is the local computer — use “localhost” or a dot (“.”) to specify the local computer explicitly.

-DynamicMemory

Specifies that the virtual machine is to be configured to use dynamic memory.

-MemoryMaximumBytes<Int64>

Specifies the maximum amount of memory that the virtual machine is to be allocated. (Applies only to virtual machines using dynamic memory.)

-MemoryMinimumBytes<Int64>

Specifies the minimum amount of memory that the virtual machine is to be allocated. (Applies only to virtual machines using dynamic memory.)

-MemoryStartupBytes<Int64>

Specifies the amount of memory that the virtual machine is to be allocated upon startup. (If the virtual machine does not use dynamic memory, then this is the static amount of memory to be allocated.)

-Name<String[]>

Specifies the name of the virtual machine to be configured.

-NewVMName<String>

Specifies the name to which the virtual machine is to be renamed.

-Passthru

Specifies that an object is to be passed through to the pipeline representing the virtual machine to be configured.

-ProcessorCount<Int64>

Specifies the number of virtual processors for the virtual machine.

-SnapshotFileLocation<String>

Specifies the folder in which the virtual machine is to store its snapshot files.

-StaticMemory

This cmdlet configures the virtual machine to use static memory. Specify the amount of static memory to allocate by using the MemoryStartupBytes parameter.

-VM<VirtualMachine[]>

Specifies the virtual machine to be configured.

-AllowUnverifiedPaths

Specifies that no error is to be thrown if the specified path is not verified as accessible by the cluster. This parameter is applicable to clustered virtual machines.

-SmartPagingFilePath<String>

Specifies the folder in which the Smart Paging file is to be stored.

-Notes<String>

Specifies notes to be associated with the virtual machine.

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

<CommonParameters>

이 cmdlet은 일반 매개 변수 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer 및 -OutVariable을 지원합니다. 자세한 내용은 다음을 참조하세요. about_CommonParameters(https://go.microsoft.com/fwlink/p/?LinkID=113216).

입력

입력 유형은 cmdlet에 파이프할 수 있는 개체의 유형입니다.

출력

출력 유형은 cmdlet이 내보내는 개체의 유형입니다.

• None by default; Microsoft.HyperV.PowerShell.VirtualMachine if –PassThru is specified.

예제

Example 1

Configures virtual machine TestVM to shut down when the Hyper-V host shuts down.

PS C:\> Set-VM –Name TestVM –AutomaticStopAction Shutdown

Example 2

Stops virtual machine TestVM, sets it to use dynamic memory, sets its maximum amount of memory to 2GB, sets it to use 2 virtual processors, and starts it.

PS C:\> Stop-VM -Name TestVM -Passthru | Set-VM -ProcessorCount 2 -DynamicMemory -MemoryMaximumBytes 2GB -Passthru | Start-VM