Delen via

Remove-Alias

  • Referentie
Module:
Microsoft.PowerShell.Utility

Verwijder een alias uit de huidige sessie.

Syntax

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

Description

De Remove-Alias cmdlet verwijdert een alias uit de huidige PowerShell-sessie. Als u een alias wilt verwijderen waarvoor de eigenschap Option is ingesteld op ReadOnly, gebruikt u de parameter Force .

De Remove-Alias cmdlet is geïntroduceerd in PowerShell 6.0.

Voorbeelden

Voorbeeld 1: een alias verwijderen

In dit voorbeeld wordt een alias met de naam del verwijderd die de Remove-Item cmdlet vertegenwoordigt.

Remove-Alias -Name del

Voorbeeld 2: alle niet-constante aliassen verwijderen

In dit voorbeeld worden alle aliassen uit de huidige PowerShell-sessie verwijderd, met uitzondering van aliassen waarvoor de eigenschap Options is ingesteld op Constant. Nadat de opdracht is uitgevoerd, zijn de aliassen beschikbaar in andere PowerShell-sessies of nieuwe PowerShell-sessies.

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

Get-Alias haalt alle aliassen in de PowerShell-sessie op en verzendt de objecten in de pijplijn. Where-Object maakt gebruik van een scriptblok en de automatische variabele ($_) en de eigenschap Opties vertegenwoordigen het huidige pijplijnobject. De parameter NE (niet gelijk) selecteert objecten waarvoor geen optiewaarde is ingesteld op Constant. Remove-Alias gebruikt de parameter Force om aliassen, inclusief alleen-lezen aliassen, te verwijderen uit de PowerShell-sessie.

Parameters

-Force

Geeft aan dat de cmdlet een alias verwijdert, inclusief aliassen waarvoor de eigenschap Option is ingesteld op ReadOnly. Met de parameter Force kan geen alias worden verwijderd waarvoor de eigenschap Option is ingesteld op Constant.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Hiermee geeft u de naam van de alias te verwijderen.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Scope

Heeft alleen invloed op de aliassen in het opgegeven bereik. Het standaardbereik is Lokaal. Zie about_Scopes voor meer informatie.

De aanvaardbare waarden voor deze parameter zijn:

  • Global
  • Local
  • Script
  • Een getal ten opzichte van het huidige bereik (0 tot en met het aantal bereiken, waarbij 0 het huidige bereik is en 1 het bovenliggende bereik)
Type:String
Position:Named
Default value:Local
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

String[]

U kunt een aliasobject doorsluisen naar Remove-Alias.

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer.

Notities

Wijzigingen zijn alleen van invloed op het huidige bereik. Als u een alias uit alle sessies wilt verwijderen, voegt u een Remove-Alias opdracht toe aan uw PowerShell-profiel.

Zie about_Aliases voor meer informatie.