Partager via

Remove-SCHardwareProfile

  • Référence
Module:
VirtualMachineManager

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

Syntaxe

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

Description

La cmdlet 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, en 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 au Remove-SCHardwareProfile applet de commande, qui supprime chaque profil matériel. En n’utilisant pas le paramètre Confirmer, vous n’êtes pas invité à confirmer s’il faut supprimer ces objets de profil matériel.

Paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-HardwareProfile

Spécifie un objet de profil matériel.

Type:HardwareProfile
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-JobVariable

Spécifie que la progression du travail est suivie et stockée dans la variable nommée par ce paramètre.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PROTipID

Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (CONSEIL PRO) qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils pro.

Type:Guid
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RunAsynchronously

Indique que le travail s’exécute de façon asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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.