Delen via

Remove-SCVMTemplate

  • Referentie
Module:
VirtualMachineManager

Hiermee verwijdert u een sjabloonobject uit VMM.

Syntax

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 er geen virtuele harde schijven verwijderd die aan de sjabloon zijn gekoppeld.

De typen bestanden die aan een sjabloon kunnen worden gekoppeld, omvatten virtuele hardeschijfbestanden (Op Windows gebaseerde VHD-bestanden, VHD-bestanden op basis van Citrix XenServer of VMware-bestanden op basis van .vmdk), virtuele diskettebestanden (Op Windows gebaseerde VFD-bestanden of VMware-bestanden .flp-bestanden) 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 verwijderen uit de bibliotheek

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 met de naam Template01 opgehaald uit de bibliotheek op VMMServer01 en wordt het object opgeslagen in de $Template variabele.

Met de tweede opdracht verwijdert u het sjabloonobject 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 , waarmee elk sjabloonobject uit de VMM-bibliotheek wordt verwijderd. Met de parameter Bevestigen wordt u gevraagd om te bevestigen of u elke sjabloon wilt verwijderen.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-Force

Hiermee dwingt u de opdracht uit te voeren zonder om bevestiging van de gebruiker te vragen.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMTemplate

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

Type:Template
Aliases:Template
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .