Partager via

Remove-SCGuestOSProfile

  • Référence
Module:
VirtualMachineManager

Supprime un objet de profil de système d’exploitation invité de VMM.

Syntaxe

Remove-SCGuestOSProfile
      [-GuestOSProfile] <GuestOSProfile>
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

La cmdlet Remove-SCGuestOSProfile supprime un ou plusieurs objets de profil de système d’exploitation invité 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 de système d’exploitation invité spécifique de la bibliothèque

PS C:\> $OSProfile = Get-SCGuestOSProfile -Name "NewOSProfile01"
PS C:\> Remove-SCGuestOSProfile -GuestOSProfile $OSProfile -Confirm

La première commande obtient l’objet de profil du système d’exploitation invité nommé NewOSProfile01 et stocke l’objet dans la variable $OSProfile.

La deuxième commande supprime le profil du système d’exploitation invité stocké dans $OSProfile, en demandant confirmation avant d’effectuer l’opération.

Exemple 2 : Supprimer tous les profils de système d’exploitation sans être invités à confirmer chaque suppression

PS C:\> $OSProfiles = Get-SCGuestOSProfile -VMMServer "VMMServer01.Contoso.com"
PS C:\> $OSProfiles | Remove-SCGuestOSProfile

La première commande obtient tous les objets de profil du système d’exploitation de VMMServer01 et stocke les objets dans le tableau d’objets $OSProfiles.

La deuxième commande transmet chaque objet dans $OSProfiles à l’applet de commande Remove-OSProfile , qui supprime chacun des objets de profil du système d’exploitation invité de la bibliothèque VMM.

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

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

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

-GuestOSProfile

Spécifie un objet de profil de système d’exploitation invité.

Type:GuestOSProfile
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 de système d’exploitation invité VMM, qui peut être récupéré à l’aide de l’applet de commande Get-SCGuestOSProfile .