Partager via

Remove-Variable

  • Référence
Module:
Microsoft.PowerShell.Utility

Supprime une variable et sa valeur.

Syntaxe

Remove-Variable
      [-Name] <String[]>
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-Force]
      [-Scope <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

La cmdlet Remove-Variable supprime une variable et sa valeur de l’étendue dans laquelle elle est définie, telle que la session active. Vous ne pouvez pas utiliser cette applet de commande pour supprimer des variables définies en tant que constantes ou celles appartenant au système.

Exemples

Exemple 1 : Supprimer une variable

PS C:\> Remove-Variable Smp

Cette commande supprime la variable $Smp.

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

-Exclude

Spécifie un tableau d’éléments omis par cette applet de commande à partir de 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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-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 Forcer, l’applet de commande ne peut pas supprimer une constante.

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

-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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie le nom de la variable à supprimer. Le nom du paramètre (Name) est facultatif.

Type:String[]
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Scope

Obtient uniquement les variables de l’étendue spécifiée. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Global
  • Local
  • Script
  • Nombre relatif à l’étendue actuelle (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
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

Entrées

PSVariable

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, telle qu’une session. Pour supprimer une variable de toutes les sessions, ajoutez une commande Remove-Variable à votre profil Windows PowerShell.

    Vous pouvez également faire référence à Remove-Variable par son alias intégré, rv . Pour plus d’informations, consultez about_Aliases.