Remove-SCVMTemplate
Supprime un objet de modèle de VMM.
Syntax
Remove-SCVMTemplate
[-VMTemplate] <Template>
[-Force]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
L’applet de commande Remove-SCVMTemplate supprime un objet de modèle de la bibliothèque Virtual Machine Manager (VMM). La suppression d’un objet de modèle ne supprime aucun disque dur virtuel associé au modèle.
Les types de fichiers qui peuvent être associés à un modèle incluent des fichiers de disque dur virtuel (fichiers .vhd basés sur Windows, fichiers .vhd basés sur Citrix XenServer ou fichiers .vmdk basés sur VMware), des fichiers de disque de floppy virtuel (fichiers .vfd basés sur Windows ou fichiers .flp basés sur VMware) et des fichiers script (Windows PowerShell .ps1 fichiers de script ou de fichiers de réponse, y compris Sysprep.inf et Unattend.xml fichiers).
Cette cmdlet retourne l’objet en cas de réussite (avec la propriété MarkedForDeletion définie sur TRUE) ou un message d’erreur en cas d’échec.
Exemples
Exemple 1 : Supprimer un modèle spécifique de la bibliothèque
PS C:\> $Template = Get-SCVMTemplate -VMMServer "VMMServer1.Contoso.com" | where { $_.Name -eq "Template01" }
PS C:\> Remove-SCVMTemplate -VMTemplate $TemplateLa première commande obtient l’objet de modèle nommé Template01 à partir de la bibliothèque sur VMMServer01 et stocke l’objet dans la variable $Template.
La deuxième commande supprime l’objet de modèle stocké dans $Template de la bibliothèque.
Exemple 2 : Supprimer tous les modèles de la bibliothèque
PS C:\> $Templates = Get-SCVMTemplate -VMMServer "VMMServer01.Contoso.com"
PS C:\> $Templates | Remove-SCVMTemplate -ConfirmLa première commande obtient tous les objets de modèle de VMMServer01 et stocke les objets dans le tableau nommé $Templates.
La deuxième commande transmet chaque objet de modèle dans $Templates à l’applet de commande Remove-SCVMTemplate , qui supprime chaque objet de modèle de la bibliothèque VMM. Le paramètre Confirm vous invite à confirmer si vous souhaitez supprimer chaque modèle.
Paramètres
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Force l’exécution de la commande sans demander la confirmation de l’utilisateur.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Spécifie que la progression des travaux est suivie et stockée dans la variable nommée par ce paramètre.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Spécifie l’ID du conseil d’optimisation des performances et des ressources qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils PRO.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Indique que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMTemplate
Spécifie un objet modèle VMM utilisé pour créer des ordinateurs virtuels.
| Type: | Template |
| Aliases: | Template |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Sorties
SCVMTemplate
Cette applet de commande retourne un objet SCVMTemplate .
Notes
- Nécessite un objet de modèle VMM, qui peut être récupéré à l’aide de l’applet de commande Get-SCVMTemplate .