Remove-SCVMTemplate
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 $TemplateDer 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 -ConfirmDer 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.