Partager via

Remove-SCGuestOSProfile

  • Référence
Module:
VirtualMachineManager

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

Syntax

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

Description

L’applet de commande 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é à 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 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

-GuestOSProfile

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

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