Partager via

Remove-SCHardwareProfile

  • Référence
Module:
VirtualMachineManager

Supprime un objet de profil matériel de la bibliothèque VMM.

Syntax

Remove-SCHardwareProfile
      [-HardwareProfile] <HardwareProfile>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

L’applet de commande Remove-SCHardwareProfile supprime un ou plusieurs objets de profil matériel de la bibliothèque VMM.

Cette applet de commande retourne l’objet en cas de réussite avec la propriété MarkedForDeletion définie sur $True ou retourne un message d’erreur en cas d’échec.

Exemples

Exemple 1 : Supprimer un profil matériel spécifique de la bibliothèque

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01"}
PS C:\> Remove-SCHardwareProfile -HardwareProfile $HWProfile -Confirm

La première commande obtient l’objet de profil matériel nommé NewHWProfile01 à partir de la bibliothèque VMM et stocke l’objet dans la variable $HWProfile.

La deuxième commande supprime NewHWProfle01 de la bibliothèque, invitant l’utilisateur à confirmer avant d’effectuer l’opération.

Exemple 2 : Supprimer tous les profils matériels sans être invité à confirmer chaque suppression

PS C:\> Get-SCHardwareProfile | Remove-SCHardwareProfile

Cette commande obtient tous les objets de profil matériel de la bibliothèque et transmet chaque objet de profil à l’applet de commande Remove-SCHardwareProfile , qui supprime chaque profil matériel. En n’utilisant pas le paramètre Confirm , vous n’êtes pas invité à confirmer s’il faut supprimer ces objets de profil matériel.

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

-HardwareProfile

Spécifie un objet profil matériel.

Type:HardwareProfile
Position:0
Default value:None
Required:True
Accept pipeline input:True
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

-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

Notes

  • Nécessite un objet de profil matériel VMM, qui peut être récupéré à l’aide de l’applet de commande Get-SCHardwareProfile .