Dela via


Remove-Alias

Ta bort ett alias från den aktuella sessionen.

Syntax

Default (Standard)

Remove-Alias
    [-Name] <String[]>
    [-Scope <String>]
    [-Force]
    [<CommonParameters>]

Description

Cmdleten Remove-Alias tar bort ett alias från den aktuella PowerShell-sessionen. Om du vill ta bort ett alias med egenskapen Alternativ inställd på ReadOnlyanvänder du parametern Force.

Cmdleten Remove-Alias introducerades i PowerShell 6.0.

Exempel

Exempel 1 – Ta bort ett alias

Det här exemplet tar bort ett alias med namnet del som representerar cmdleten Remove-Item.

Remove-Alias -Name del

Exempel 2 – Ta bort alla icke-konstanta alias

Det här exemplet tar bort alla alias från den aktuella PowerShell-sessionen, förutom alias med egenskapen Alternativ inställd på Konstant. När kommandot har körts är aliasen tillgängliga i andra PowerShell-sessioner eller nya PowerShell-sessioner.

Get-Alias | Where-Object { $_.Options -ne "Constant" } | Remove-Alias -Force

Get-Alias hämtar alla alias i PowerShell-sessionen och skickar objekten nedåt i pipelinen. Where-Object använder ett skriptblock och den automatiska variabeln ($_) och egenskapen Alternativ representerar det aktuella pipelineobjektet. Operatorn -ne (inte lika med) markerar objekt som inte har värdet Alternativ inställt på Konstant. Remove-Alias använder parametern Force för att ta bort alias, inklusive skrivskyddade alias, från PowerShell-sessionen. Parametern Force kan inte ta bort konstanta alias.

Parametrar

-Force

Anger att cmdleten tar bort ett alias, inklusive alias med egenskapen Alternativ inställd på ReadOnly. Parametern Force kan inte ta bort en alias där egenskapen Alternativ är inställd på Konstant.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
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

-Name

Anger namnet på aliaset som ska tas bort.

Parameteregenskaper

Typ:

String[]

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

Parameteruppsättningar

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

-Scope

Påverkar endast aliasen i det angivna omfånget. Standardomfånget är Lokal. Mer information finns i about_Scopes.

De godtagbara värdena för den här parametern är:

  • Global
  • Local
  • Script
  • 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)

Parameteregenskaper

Typ:String
Standardvärde:Local
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

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

String

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

Utdata

None

Den här cmdleten returnerar inga utdata.

Kommentarer

Ändringar påverkar bara det aktuella omfånget. Om du vill ta bort ett alias från alla sessioner lägger du till ett Remove-Alias kommando i PowerShell-profilen.

Mer information finns i about_Aliases.