Dela via

Remove-Alias

  • Referens
Modul:
Microsoft.PowerShell.Utility

Ta bort ett alias från den aktuella sessionen.

Syntax

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. Parametern NE (inte lika med) markerar objekt som inte har ett Alternativ värdet 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 ett alias med egenskapen Alternativ inställd på Konstant.

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

-Name

Anger namnet på aliaset som ska tas bort.

Typ:String[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken: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 (0 genom antalet omfång, där 0 är det aktuella omfånget och 1 är dess överordnade)
Typ:String
Position:Named
Standardvärde:Local
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

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.