Remove-SCScript
Supprime un objet de script de VMM.
Syntaxe
Default (Par défaut)
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 renvoie l’objet en cas de réussite (avec la propriété MarkedForDeletion définie sur $True) ou renvoie 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 récupère l’objet de script nommé AddHost.ps1 à partir de la bibliothèque VMM sur VMMServer01 et stocke l’objet dans le tableau nommé $Scripts. Il peut exister plusieurs fichiers portant le même nom s’il existe plusieurs conteneurs de scripts 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 en $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 à l’utilisateur le nom de chaque script et son chemin d’accès au partage.
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èques.
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 récupère tous les objets de script dont le nom inclut la chaîne « Sysprep » de VMMServer01, puis stocke ces objets dans le tableau nommé $Scripts.
La deuxième commande transmet chaque objet de script en $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èques.
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 en une seule 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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Force
Force l’exécution de la commande sans demander la confirmation de l’utilisateur.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-JobVariable
Spécifie que la progression du travail est suivie et stockée dans la variable nommée par ce paramètre.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | Guid |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Script
Spécifie un objet de script VMM.
Propriétés du paramètre
| Type: | Script |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.