Remove-Variable
Supprime une variable et sa valeur.
Syntax
Remove-Variable
[-Name] <String[]>
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Scope <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet Remove-Variable
de commande supprime une variable et sa valeur de l’étendue dans laquelle elle est définie, comme la session active. Vous ne pouvez pas utiliser cette applet de commande pour supprimer des variables qui sont définies en tant que constantes ou celles qui sont détenues par le système.
Exemples
Exemple 1 : Supprimer une variable
Remove-Variable Smp
Cette commande supprime la $Smp
variable.
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 |
-Exclude
Spécifie un tableau d’éléments que cette applet de commande omet de l’opération. La valeur de ce paramètre qualifie le paramètre Name . Entrez un élément ou un modèle de nom, tel que « s* ». Les caractères génériques sont autorisés.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Force
Indique que l’applet de commande supprime une variable même si elle est en lecture seule. Même à l’aide du paramètre Force , l’applet de commande ne peut pas supprimer une constante.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Include
Spécifie un tableau d’éléments que cette applet de commande supprime dans l’opération. La valeur de ce paramètre qualifie le paramètre Name . Entrez un élément de nom ou un modèle, tel que s*. Les caractères génériques sont autorisés.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Name
Spécifie le nom de la variable à supprimer. Le nom du paramètre (Name) est facultatif. Les caractères génériques sont autorisés
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Scope
Obtient seulement les variables de l'étendue spécifiée. Les valeurs valides pour ce paramètre sont :
- Global
- Local
- Script
- Nombre relatif à l’étendue actuelle (de 0 au nombre d’étendues, où 0 est l’étendue actuelle et 1 est son parent)
Local est la valeur par défaut. Pour plus d’informations, consultez about_Scopes.
Type: | String |
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 |
Entrées
Vous pouvez diriger un objet variable vers Remove-Variable
.
Sorties
None
Cette applet de commande ne retourne aucune sortie.
Notes
Les modifications affectent uniquement l'étendue actuelle, par exemple une session. Pour supprimer une variable de toutes les sessions, ajoutez une
Remove-Variable
commande à votre profil PowerShell.Vous pouvez également faire référence à par
Remove-Variable
son alias intégré,rv
. Pour plus d’informations, consultez about_Aliases.