Remove-Variable
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 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.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Name
Anger namnet på variabeln som ska tas bort. Parameternamnet (namn) är valfritt. Jokertecken tillåts
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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)
Lokalt är standardinställningen. Mer information finns i about_Scopes.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Indata
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.