Delen via

Remove-SCVMTemplate

  • Referentie
Module:
VirtualMachineManager

Hiermee verwijdert u een sjabloonobject uit VMM.

Syntaxis

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

Description

De cmdlet Remove-SCVMTemplate verwijdert een sjabloonobject uit de VMM-bibliotheek (Virtual Machine Manager). Als u een sjabloonobject verwijdert, worden geen virtuele harde schijven verwijderd die aan de sjabloon zijn gekoppeld.

De typen bestanden die aan een sjabloon kunnen worden gekoppeld, zijn virtuele hardeschijfbestanden (Windows-VHD-bestanden, VHD-bestanden op basis van Citrix XenServer of VMware-bestanden op basis van .vmdk), virtuele diskettebestanden (VFD-bestanden of VMware-bestanden op basis van VMware) en scriptbestanden (Windows PowerShell .ps1 scriptbestanden of antwoordbestandsscripts, waaronder Sysprep.inf- en Unattend.xml-bestanden).

Deze cmdlet retourneert het object bij succes (waarbij de eigenschap MarkedForDeletion is ingesteld op TRUE) of retourneert een foutbericht bij een fout.

Voorbeelden

Voorbeeld 1: Een specifieke sjabloon uit de bibliotheek verwijderen

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

Met de eerste opdracht wordt het sjabloonobject template01 opgehaald uit de bibliotheek op VMMServer01 en wordt het object opgeslagen in de $Template variabele.

Met de tweede opdracht wordt het sjabloonobject verwijderd dat is opgeslagen in $Template uit de bibliotheek.

Voorbeeld 2: Alle sjablonen uit de bibliotheek verwijderen

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

Met de eerste opdracht worden alle sjabloonobjecten opgehaald uit VMMServer01 en worden de objecten opgeslagen in de matrix met de naam $Templates.

Met de tweede opdracht wordt elk sjabloonobject in $Templates doorgegeven aan de cmdlet Remove-SCVMTemplate, waardoor elk sjabloonobject uit de VMM-bibliotheek wordt verwijderd. De Bevestig parameter vraagt u om te bevestigen of u elke sjabloon wilt verwijderen.

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-JobVariable

Hiermee geeft u op dat de voortgang van de taak wordt bijgehouden en opgeslagen in de variabele met de naam van deze parameter.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PROTipID

Hiermee geeft u de id op van de tip Prestatie- en resourceoptimalisatie (PRO-tip) die deze actie heeft geactiveerd. Met deze parameter kunt u PRO-tips controleren.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VMTemplate

Hiermee geeft u een VMM-sjabloonobject op dat wordt gebruikt om virtuele machines te maken.

Type:Template
Aliassen:Template
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Uitvoerwaarden

SCVMTemplate

Met deze cmdlet wordt een SCVMTemplate--object geretourneerd.

Notities

  • Hiervoor is een VMM-sjabloonobject vereist dat kan worden opgehaald met behulp van de cmdlet Get-SCVMTemplate.