Partager via

Remove-SCScript

  • Référence
Module:
VirtualMachineManager

Supprime un objet de script de VMM.

Syntaxe

Remove-SCScript
      [-Script] <Script>
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

La cmdlet Remove-SCScript Remove-SCScript supprime un ou plusieurs objets de script de la bibliothèque VMM et supprime le fichier de script correspondant sur le serveur de bibliothèque.

Si le script est attaché à un modèle ou à un profil matériel (et si vous n’utilisez pas le paramètre Force), Virtual Machine Manager (VMM) répertorie le conteneur qui contient le script et vous invite à confirmer que vous souhaitez supprimer le script :

  • Si vous répondez Oui, VMM supprime l’association entre le script et le conteneur auquel il est attaché, puis supprime l’objet de script 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 de script et supprimer le fichier de script correspondant

PS C:\> $Scripts = @(Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "AddHost.ps1"} )
PS C:\> $Scripts.Count
PS C:\> $Scripts | select Name,SharePath | Format-List
PS C:\> Remove-SCScript -Script $Scripts[0] -Force

La première commande obtient l’objet de script nommé AddHost.ps1 à partir de la bibliothèque VMM sur VMMServer01 et stocke l’objet dans le tableau nommé $Scripts. Plusieurs fichiers portant le même nom peuvent exister si plusieurs conteneurs pour les scripts existent sur le serveur de bibliothèque spécifié.

La deuxième commande compte le nombre de scripts dans $Scrips et affiche les résultats à l’utilisateur.

La troisième commande transmet chaque objet de script dans $Scripts à l’applet de commande Select-Object, qui sélectionne le nom et le chemin d’accès de partage pour chaque script du tableau. La commande transmet ensuite ces résultats à l’applet de commande Format-List pour afficher chaque nom de script et son chemin de partage à l’utilisateur.

La dernière commande supprime le premier objet du tableau $Scripts et utilise le paramètre force pour vous assurer que l’objet de script est supprimé de la base de données VMM et que le fichier de script correspondant est supprimé du système de fichiers sur le serveur de bibliothèque.

Exemple 2 : Supprimer plusieurs scripts de la bibliothèque

PS C:\> $Scripts = Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -match "Sysprep" }
PS C:\> $Scripts | Remove-SCScript -Confirm

La première commande obtient tous les objets de script dont les noms incluent la chaîne « Sysprep » à partir de VMMServer01, puis stocke ces objets dans le tableau nommé $Scripts.

La deuxième commande transmet chaque objet de script dans $Scripts à Remove-SCScript, qui supprime chaque objet de script de la bibliothèque et supprime chaque fichier de script correspondant du système de fichiers sur le serveur de bibliothèque.

Le paramètre Confirmer vous invite à confirmer que vous souhaitez supprimer ces scripts. Vous avez la possibilité de confirmer la suppression de tous les scripts à la fois ou de confirmer la suppression de chaque script un par un.

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

-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

-Script

Spécifie un objet de script VMM.

Type:Script
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
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