Stop-SCVirtualMachine

참조

모듈:: VirtualMachineManager

VMM에서 관리하는 가상 머신을 중지합니다.

Syntax

Stop-SCVirtualMachine
    [-VM] <VM>
    [-Shutdown]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Stop-SCVirtualMachine
    [-VM] <VM>
    [-SaveState]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Stop-SCVirtualMachine
    [-VM] <VM>
    [-DiscardSavedState]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Stop-SCVirtualMachine
    [-VM] <VM>
    [-Force]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Description

Stop-SCVirtualMachine cmdlet은 VMM(Virtual Machine Manager)에서 관리하는 호스트에서 하나 이상의 실행 중인 가상 머신을 중지하고 중지된 상태로 가상 머신 개체를 반환합니다.

이 cmdlet은 컴퓨터에서 운영 체제를 종료하는 것처럼 가상 머신을 중지합니다. Force 매개 변수를 지정하는 경우 이 cmdlet은 컴퓨터를 끄는 것처럼 가상 머신을 중지합니다.

중지된 가상 머신을 다시 시작하려면 Start-SCVirtualMachine cmdlet을 사용합니다.

예제

예제 1: 지정된 가상 머신 중지

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Stop-SCVirtualMachine -VM $VM

첫 번째 명령은 VM01이라는 가상 머신 개체를 가져온 다음 해당 개체를 $VM 변수에 저장합니다.

두 번째 명령은 $VM 저장된 가상 머신을 중지하고 중지된 개체에 대한 정보를 표시합니다.

예제 2: 여러 가상 머신 중지

PS C:\> $VMs = Get-SCVirtualMachine | where { $_.Name -match "VM" -and $_.Status -eq "Running" }
PS C:\> $VMs | Stop-SCVirtualMachine

첫 번째 명령은 이름이 문자열 VMM을 포함하고 현재 상태가 실행 중인 모든 가상 머신 개체를 가져옵니다. 그런 다음 명령은 해당 개체를 $VMs 배열에 저장합니다.

두 번째 명령은 $VMs 저장된 각 가상 머신 개체를 현재 cmdlet에 전달하여 각 가상 머신을 중지합니다. 이 명령은 중지된 가상 머신에 대한 정보를 표시합니다.

매개 변수

-DiscardSavedState

이 cmdlet은 가상 머신과 연결된 저장된 상태를 삭제한다는 것을 나타냅니다.

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

-Force

이 cmdlet은 컴퓨터를 끄는 것처럼 가상 머신을 중지한다는 것을 나타냅니다.

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

-OnBehalfOfUser

사용자 이름을 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 사용자를 대신하여 작동합니다.

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

-OnBehalfOfUserRole

사용자 역할을 지정합니다. 사용자 역할을 가져오려면 Get-SCUserRole cmdlet을 사용합니다. 이 cmdlet은 이 매개 변수가 지정하는 사용자 역할을 대신하여 작동합니다.

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

-RunAsynchronously

컨트롤이 명령 셸로 즉시 반환되도록 작업이 비동기적으로 실행됨을 나타냅니다.

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

-SaveState

이 cmdlet이 가상 머신의 상태를 저장한다는 것을 나타냅니다.

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

-Shutdown

이 cmdlet이 가상 머신을 종료했음을 나타냅니다. 이 cmdlet은 운영 체제를 사용하여 가상 머신을 정상적으로 종료합니다.

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

출력

VirtualMachine

이 cmdlet은 VirtualMachine 개체를 반환합니다.

참고

이 cmdlet에는 Get-SCVirtualMachine cmdlet을 사용하여 검색할 수 있는 가상 머신 개체가 필요합니다.