Partager via

Remove-SCScript

  • Référence
Module:
VirtualMachineManager

Supprime un objet de script de VMM.

Syntax

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

Description

L’applet de commande 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 le serveur de bibliothèque spécifié comprend plusieurs conteneurs de scripts.

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 s’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 » 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 Confirm 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 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

-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

-Script

Spécifie un objet script VMM.

Type:Script
Position:0
Default value:None
Required:True
Accept pipeline input:True
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