Partager via

Remove-SCVMTemplate

  • Référence
Module:
VirtualMachineManager

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 $Template

La 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 -Confirm

La 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 .