Remove-SCVirtualMachine

  • 참조
모듈:
VirtualMachineManager

VMM에서 가상 머신 개체를 제거합니다.

Syntax

Remove-SCVirtualMachine
      [-VM] <VM>
      [-SkipFileRemoval]
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

Description

Remove-SCVirtualMachine cmdlet은 호스트에 배포되거나 VMM(Virtual Machine Manager) 라이브러리 서버에 저장된 가상 머신 개체를 제거합니다.

이 cmdlet은 VMM 데이터베이스에서 가상 머신 레코드를 삭제하고, 가상 머신과 연결된 모든 파일을 삭제하고, 가상 머신이 배포된 호스트 또는 가상 머신이 저장된 라이브러리 서버에서 가상 머신을 제거합니다.

호스트의 폴더가 Hyper-V 또는 VMware 대신 VMM에서 이 가상 머신에 대해 만들어진 경우 해당 폴더에 다른 가상 머신 또는 다른 데이터가 없는 경우 가상 머신을 제거한 후 파일 시스템을 사용하여 폴더를 삭제할 수 있습니다.

Force 매개 변수를 지정하는 경우 이 cmdlet은 VMM 데이터베이스에서만 가상 머신을 삭제합니다. 가상 머신 자체는 삭제하지 않습니다.

이 cmdlet은 성공 시 MarkedForDeletion 속성에 대한 값이 $True 개체를 반환합니다. 실패하면 cmdlet은 오류 메시지를 반환합니다.

예제

예제 1: 호스트에 배포된 특정 가상 머신 제거

PS C:\> $VM = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | where { $_.VMHost.Name -eq "VMHost01.Contoso.com" -and $_.Name -eq "VM01" }
PS C:\> Remove-SCVirtualMachine -VM $VM

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

두 번째 명령은 $VM 저장된 개체를 제거하고 해당 호스트의 파일 시스템에서 해당 가상 머신 파일을 삭제합니다.

예제 2: 특정 문자열을 포함하는 이름의 모든 가상 머신 제거

PS C:\> $VMs = @(Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -Match "VM0" } )
PS C:\> $VMs | Remove-SCVirtualMachine

첫 번째 명령은 이름에 문자열 VM0이 포함된 모든 호스트에 배포된 모든 가상 머신 개체를 가져온 다음, 이러한 가상 머신 개체를 $VMs 배열에 저장합니다.

두 번째 명령은 $VMs 배열의 각 가상 머신 개체를 제거하고 각 호스트의 파일 시스템에서 해당 가상 머신 파일을 삭제합니다.

예제 3: VMM 라이브러리 서버에 저장된 특정 가상 머신 제거

PS C:\> $VM = Get-SCVirtualMachine -VMMServer "VMMServer1.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "VM02" }
PS C:\> Remove-SCVirtualMachine -VM $VM

첫 번째 명령은 VM03이라는 가상 머신을 나타내는 개체를 가져온 다음 $VM 가상 머신 개체를 저장합니다. 이 예제에서는 VM03이라는 가상 머신이 하나만 존재합니다.

두 번째 명령은 라이브러리에서 VM03을 나타내는 개체를 제거하고 라이브러리 서버의 파일 시스템에서 해당 가상 컴퓨터 파일도 삭제합니다.

예제 4: VMM 라이브러리에서 저장된 가상 머신 여러 대 제거

PS C:\> $VMs = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -match "VM0" }
PS C:\> $VMs | Remove-SCVirtualMachine -Confirm

첫 번째 명령은 이름에 문자열 VM0이 포함되고 LibraryServer01에 저장된 모든 가상 머신 개체를 가져옵니다. 그런 다음 이 명령은 가상 머신 개체를 $VMs 배열에 저장합니다.

두 번째 명령은 $VMs 저장된 각 가상 머신 개체를 현재 cmdlet에 전달합니다. 이 cmdlet은 라이브러리에서 각 개체를 제거하고 라이브러리 서버의 파일 시스템에서 해당 가상 머신 파일을 삭제합니다. Confirm 매개 변수는 이러한 각 가상 머신을 삭제할지 여부를 확인하라는 메시지를 표시합니다.

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인을 요청합니다.

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

-Force

이 cmdlet은 VMM 데이터베이스에서 가상 머신만 삭제한다는 것을 나타냅니다. 가상 머신 자체는 삭제하지 않습니다.

참고

서비스 템플릿 또는 VMRole을 사용하여 배포된 가상 머신의 경우 이 매개 변수는 무시되고 실제 가상 머신도 삭제됩니다.

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

-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

-SkipFileRemoval

이 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

-WhatIf

cmdlet을 실행할 경우 발생하는 일을 표시합니다. cmdlet은 실행되지 않습니다.

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

참고

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