Partager via

Remove-SCISO

  • Référence
Module:
VirtualMachineManager

Supprime un fichier ISO de la bibliothèque VMM.

Syntaxe

Remove-SCISO
      [-ISO] <ISO>
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

La cmdlet Remove-SCISO supprime un fichier ISO de la bibliothèque Virtual Machine Manager (VMM) et supprime le fichier ISO sur le serveur de bibliothèque.

Si l’ISO est attaché à une machine virtuelle, un modèle ou un profil matériel, et si vous ne spécifiez pas le paramètre Force, VMM répertorie le conteneur qui inclut l’ISO et vous invite à confirmer que vous souhaitez supprimer l’ISO :

  • Si vous répondez Oui, VMM supprime l’association entre l’ISO et le conteneur auquel il est attaché, puis supprime l’objet ISO de VMM.

  • Si vous répondez Non, l’opération est annulée.

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 objet ISO et supprimer le fichier de .iso correspondant

PS C:\> $ISO = Get-SCISO -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -eq "OsISO.iso" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }
PS C:\> Remove-SCISO -ISO $ISO

La première commande obtient l’objet ISO nommé OsISO.iso de LibraryServer01 et stocke l’objet ISO dans la variable $ISO.

La deuxième commande supprime l’objet ISO de la bibliothèque et supprime le fichier .iso correspondant du système de fichiers sur le serveur de bibliothèque.

Exemple 2 : Supprimer plusieurs objets ISO de la bibliothèque

PS C:\> $ISOs = Get-SCISO -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -match "OsISO" }
PS C:\> $ISOs | Remove-SCISO

La première commande obtient tous les objets ISO dont le nom inclut la chaîne « OsISO » et stocke ces objets ISO dans la variable $ISOs.

La deuxième commande transmet chaque objet ISO dans $ISOs à l’applet de commande Remove-SCISO , qui supprime chaque objet ISO de la bibliothèque et supprime le fichier .iso correspondant du système de fichiers sur le serveur de bibliothèque.

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

-ISO

Spécifie un objet ISO.

Type:ISO
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 ISO VMM, qui peut être récupéré à l’aide de l’applet de commande Get-SCISO Get-SCISO.