Remove-Variable

Delete a variable and its value.

Syntax
      Remove-Variable [[-Name] String[] ]
         [-Include string] [-Exclude string] 
            [-scope string] [-force] [-whatIf]
               [-confirm] [CommonParameters]
Key
   -Name 
       The name of the variable(s) to be removed.

   -include string
       Delete only the specified items.
       Wildcards are permitted.

   -exclude string
       Omit the specified items. Wildcards are permitted.
	   
   -valueOnly
       Get only the value of the variable.

   -scope string
       The scope in which this alias is valid. 
       Valid values are "Global", "Local", "Private" or "Script", or a number 
       relative to the current scope ( 0 through the number of scopes, where 
       0 is the current scope and 1 is its parent). "Local" is the default.
       For more, type "get-help about_scope".

   -force
       Override restrictions that prevent the command from succeeding, apart
       from security settings. e.g. -force will override a files read-only
       attribute, but will not change file permissions.

   -whatIf
       Describe what would happen if you executed the command without
       actually executing the command.

   -confirm
       Prompt for confirmation before executing the command.

   CommonParameters:
       -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutVariable.

Examples

Remove an existing variable $myvar:

PS C:\>remove-variable myvar

"If any question why we died, Tell them, because our fathers lied" - Rudyard Kipling

Related:

Clear-Variable - Remove the value from a variable
Get-Variable - Get a powershell variable
New-Variable - Create a new variable
Set-Variable - Set a variable and a value
Equivalent bash command: unset - Remove variable or function names



Back to the Top

Simon Sheppard
SS64.com