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.
       Qualifies the -Name parameter.

   -Exclude string
       Omit the specified items. Wildcards are permitted.
       Qualifies the -Name parameter.
	   
   -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_scopes".

   -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 remove a constant.

   -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, -WarningAction, -WarningVariable,
       -OutBuffer -OutVariable.

Standard Aliases for Remove-Variable: rv

Remove-Variable deletes a variable and its value from the scope in which it is defined, such as the current session.
This cmdlet cannot delete variables that are set as constants or those that are owned by the system.

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
Environment Variables
Equivalent bash command: unset - Remove variable or function names


© Copyright SS64.com 1999-2013
Some rights reserved