Dela via

Remove-Variable

Modul:
Microsoft.PowerShell.Utility Module

Tar bort en variabel och dess värde.

Syntax

Default (Standard) 

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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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 Name. Ange ett namnelement eller mönster, till exempel "s*". Jokertecken tillåts.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Force

Anger att cmdleten tar bort en variabel även om den är skrivskyddad. Även om du använder parametern Force kan cmdleten inte ta bort en konstant.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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 Name. Ange ett namnelement eller mönster, till exempel s*. Jokertecken tillåts.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Name

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

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

(All)
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Scope

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

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

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-WhatIf

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

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.

Indata

PSVariable

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

Utdata

None

Den här cmdleten returnerar inga utdata.

Kommentarer

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

  • Alla plattformar:

    • 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.