Freigeben über

Remove-SCVMTemplate

  • Referenz
Modul:
VirtualMachineManager

Entfernt ein Vorlagenobjekt aus VMM.

Syntax

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

Beschreibung

Das Cmdlet Remove-SCVMTemplate entfernt ein Vorlagenobjekt aus der Virtual Machine Manager -Bibliothek (VMM). Das Entfernen eines Vorlagenobjekts löscht keine virtuellen Festplatten, die der Vorlage zugeordnet sind.

Die Arten von Dateien, die einer Vorlage zugeordnet werden können, umfassen virtuelle Festplattendateien (Windows-basierte .vhd-Dateien, Citrix XenServer-basierte .vhd-Dateien oder VMware-basierte .vmdk-Dateien), virtuelle Floppy-Datenträgerdateien (Windows-basierte .vfd-Dateien oder VMware-basierte .flp-Dateien) und Skriptdateien (Windows PowerShell .ps1 Skriptdateien oder Antwortdateiskripts, einschließlich Sysprep.inf und Unattend.xml Dateien).

Dieses Cmdlet gibt bei Erfolg (die MarkedForDeletion-Eigenschaft ist auf TRUE festgelegt) das Objekt oder bei einem Fehler eine Fehlermeldung zurück.

Beispiele

Beispiel 1: Entfernen einer bestimmten Vorlage aus der Bibliothek

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

Der erste Befehl ruft das Vorlagenobjekt namens Template01 aus der Bibliothek auf VMMServer01 ab und speichert das Objekt in der $Template Variablen.

Der zweite Befehl entfernt das in $Template gespeicherte Vorlagenobjekt aus der Bibliothek.

Beispiel 2: Entfernen aller Vorlagen aus der Bibliothek

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

Der erste Befehl ruft alle Vorlagenobjekte von VMMServer01 ab und speichert die Objekte im Array namens $Templates.

Der zweite Befehl übergibt jedes Vorlagenobjekt in $Templates an das Cmdlet Remove-SCVMTemplate , das jedes Vorlagenobjekt aus der VMM-Bibliothek entfernt. Der Parameter " Bestätigen " fordert Sie auf, zu bestätigen, ob Sie jede Vorlage löschen möchten.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-Force

Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.

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

-JobVariable

Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.

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

-PROTipID

Gibt die ID der Leistungs- und Ressourcenoptimierungs-Tipp (PRO-Tipp) an, die diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

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

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, sodass das Steuerelement sofort an die Befehlsshell zurückgibt.

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

-VMTemplate

Gibt ein zum Erstellen virtueller Maschinen verwendetes VMM-Vorlagenobjekt an.

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Ausgaben

SCVMTemplate

Dieses Cmdlet gibt ein SCVMTemplate-Objekt zurück.

Hinweise

  • Erfordert ein VMM-Vorlagenobjekt, das mithilfe des Cmdlets Get-SCVMTemplate abgerufen werden kann.