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 VMM-Bibliothek (Virtual Machine Manager). Durch das Entfernen eines Vorlagenobjekts werden keine virtuellen Festplatten gelöscht, die der Vorlage zugeordnet sind.

Zu den Dateitypen, die einer Vorlage zugeordnet werden können, gehören 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 des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der 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, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

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.