Remove-Variable

  • Referens
Modul:
Microsoft.PowerShell.Utility

Tar bort en variabel och dess värde.

Syntax

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

Description

Cmdleten Remove-Variable tar bort en variabel och dess värde från omfånget där den definieras, till exempel den aktuella sessionen. Du kan inte använda den här cmdleten för att ta bort variabler som anges som konstanter eller de som ägs av systemet.

Exempel

Exempel 1: Ta bort en variabel

Remove-Variable Smp

Det här kommandot tar bort variabeln $Smp .

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Exclude

Anger en matris med objekt som cmdleten utelämnar från åtgärden. Värdet för den här parametern kvalificerar parametern Namn . Ange ett namnelement eller mönster, till exempel "s*". Jokertecken tillåts.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:True

-Force

Anger att cmdleten tar bort en variabel även om den är skrivskyddad. Även med hjälp av force-parametern kan cmdleten inte ta bort en konstant.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Include

Anger en matris med objekt som den här cmdleten tar bort i åtgärden. Värdet för den här parametern kvalificerar parametern Namn . Ange ett namnelement eller mönster, till exempel s*. Jokertecken tillåts.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:True

-Name

Anger namnet på variabeln som ska tas bort. Parameternamnet (namn) är valfritt. Jokertecken tillåts

Typ:String[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:True

-Scope

Hämtar endast variablerna i det angivna omfånget. De acceptabla värdena för den här parametern är:

  • Global
  • Lokal
  • Skript
  • Ett tal i förhållande till det aktuella omfånget (0 genom antalet omfång, där 0 är det aktuella omfånget och 1 är dess överordnade)

Lokal är standardinställningen. Mer information finns i about_Scopes.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

PSVariable

Du kan skicka ett variabelobjekt till den här cmdleten.

Utdata

None

Den här cmdleten returnerar inga utdata.

Kommentarer

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

  • rv

  • Ändringar påverkar endast det aktuella omfånget, till exempel en session. Om du vill ta bort en variabel från alla sessioner lägger du till ett Remove-Variable kommando i PowerShell-profilen.