Clear-Variable

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

Cmdleten Clear-Variable tar bort data som lagras i en variabel, men variabeln tas inte bort. Därför är värdet för variabeln NULL (tom). Om variabeln har en angiven data- eller objekttyp bevarar den här cmdleten typen av objekt som lagras i variabeln.

Clear-Variable my* -Scope Global

Det här kommandot tar bort värdet för globala variabler som har namn som börjar med mina.

$a = 3
&{ Clear-Variable a }
$a

3

Dessa kommandon visar att rensning av en variabel i ett underordnat omfång inte rensar värdet i det överordnade omfånget. Det första kommandot anger värdet för variabeln $a till 3. Det andra kommandot använder anroparoperatorn (&) för att köra kommandot Clear-Variable i ett nytt omfång. Variabeln rensas i det underordnade omfånget (även om den inte fanns), men den rensas inte i det lokala omfånget. Det tredje kommandot, som hämtar värdet $a, visar att värdet 3 inte påverkas.

Clear-Variable -Name "Processes"

Det här kommandot tar bort värdet för variabeln med namnet Processer. När cmdleten har slutfört åtgärden finns variabeln Med namnet Processer fortfarande, men värdet är null.

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Du kan inte skicka objekt till den här cmdleten.

Som standard returnerar den här cmdleten inga utdata.

När du använder parametern PassThru returnerar den här cmdleten ett PSVariable--objekt som representerar den rensade variabeln.

PowerShell innehåller följande alias för Clear-Variable:

• Alla plattformar:

  • clv

• Om du vill ta bort en variabel, tillsammans med dess värde, använder du Remove-Variable eller Remove-Item.

  Den här cmdleten tar inte bort värdena för variabler som anges som konstanter eller ägs av systemet, även om du använder parametern Force.

  Om variabeln som du rensar inte finns har cmdleten ingen effekt. Den skapar inte en variabel med ett null-värde.