다음을 통해 공유

Remove-SCVMTemplate

  • 참조
모듈:
VirtualMachineManager

VMM에서 템플릿 개체를 제거합니다.

Syntax

Remove-SCVMTemplate
      [-VMTemplate] <Template>
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Remove-SCVMTemplate cmdlet은 VMM(Virtual Machine Manager) 라이브러리에서 템플릿 개체를 제거합니다. 템플릿 개체를 제거해도 템플릿과 연결된 가상 하드 디스크는 삭제되지 않습니다.

템플릿과 연결할 수 있는 파일 유형에는 가상 하드 디스크 파일(Windows 기반 .vhd 파일, Citrix XenServer 기반 .vhd 파일 또는 VMware 기반 .vmdk 파일), 가상 플로피 디스크 파일(Windows 기반 .vfd 파일 또는 VMware 기반 .flp 파일) 및 스크립트 파일(Windows PowerShell .ps1 스크립트 파일 또는 응답 파일 스크립트(Sysprep.inf 및 Unattend.xml 파일 포함).

이 cmdlet은 MarkedForDeletion 속성이 TRUE로 설정된 경우 성공하면 개체를 반환하고 실패하면 오류 메시지를 반환합니다.

예제

예제 1: 라이브러리에서 특정 템플릿 제거

PS C:\> $Template = Get-SCVMTemplate -VMMServer "VMMServer1.Contoso.com" | where { $_.Name -eq "Template01" }
PS C:\> Remove-SCVMTemplate -VMTemplate $Template

첫 번째 명령은 VMMServer01의 라이브러리에서 Template01이라는 템플릿 개체를 가져오고 개체를 $Template 변수에 저장합니다.

두 번째 명령은 라이브러리에서 $Template 저장된 템플릿 개체를 제거합니다.

예제 2: 라이브러리에서 모든 템플릿 제거

PS C:\> $Templates = Get-SCVMTemplate -VMMServer "VMMServer01.Contoso.com"
PS C:\> $Templates | Remove-SCVMTemplate -Confirm

첫 번째 명령은 VMMServer01에서 모든 템플릿 개체를 가져오고 $Templates 배열에 개체를 저장합니다.

두 번째 명령은 $Templates 각 템플릿 개체를 Remove-SCVMTemplate cmdlet에 전달하여 VMM 라이브러리에서 각 템플릿 개체를 제거합니다. Confirm 매개 변수는 각 템플릿을 삭제할지 여부를 확인하는 메시지를 표시합니다.

매개 변수

-Confirm

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

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

-Force

사용자 확인을 요청하지 않고 명령을 강제 실행합니다.

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

-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

-VMTemplate

가상 컴퓨터를 만드는 데 필요한 VMM 템플릿 개체를 지정합니다.

Type:Template
Aliases:Template
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

출력

SCVMTemplate

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

참고

  • Get-SCVMTemplate cmdlet을 사용하여 검색할 수 있는 VMM 템플릿 개체가 필요합니다.