This is the built-in help made by Microsoft for the command 'Clear-Variable', in PowerShell version 4 - as retrieved from
Windows version 'Microsoft Windows 8.1 Enterprise' PowerShell help files on 2016-06-23.
For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.
Deletes the value of a variable.
Clear-Variable [-Name] <String[]> [-Exclude <String[]>] [-Force] [-Include <String[]>] [-PassThru] [-Scope <String>] [-Confirm] [-WhatIf] [<CommonParameters>]
The Clear-Variable cmdlet deletes the data stored in a variable, but it does not delete the variable. As a result, the value of the variable is NULL (empty). If the v
ariable has a specified data or object type, Clear-Variable preserves the type of the object stored in the variable.
<
Online Version: http://go.microsoft.com/fwlink/p/?linkid=293944
Get-Variable
New-Variable
Remove-Variable
Set-Variable
<
-------------------------- EXAMPLE 1 --------------------------
PS C:\>Clear-Variable my* -Scope Global
This command deletes the value of global variables that have names that begin with "my".
-------------------------- EXAMPLE 2 --------------------------
PS C:\>$a=3
PS C:\>&{ Clear-Variable a }
PS C:\>$a
3
These commands demonstrate that clearing a variable in a child scope does not clear the value in the parent scope. The first command sets the value of the variable $a
to "3". The second command uses the invoke operator (&) to run a Clear-Variable command in a new scope. The variable is cleared in the child scope (although it did n
ot exist), but it is not cleared in the local scope. The third command, which gets the value of $a, shows that the value "3" is unaffected.
-------------------------- EXAMPLE 3 --------------------------
PS C:\>Clear-variable -Name Processes
This command deletes the value of the $processes variable. The $processes variable still exists, but the value is null.