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 met de eigenschap Option 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 verwijderd met de naam del 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 op in de PowerShell-sessie en verzendt de objecten omlaag in de pijplijn. Where-Object maakt gebruik van een scriptblok en de eigenschap Automatische variabele ($_) en Opties vertegenwoordigen het huidige pijplijnobject. Met de parameter NE (niet gelijk aan) selecteert u objecten waarvoor geen optieswaarde is ingesteld op Constant. Remove-Alias gebruikt de parameter Force om aliassen, inclusief alleen-lezen aliassen, te verwijderen uit de PowerShell-sessie. De parameter Force kan constante aliassen niet verwijderen.

Parameters

-Force

Geeft aan dat de cmdlet een alias verwijdert, inclusief aliassen met de eigenschap Option die is ingesteld op ReadOnly. De parameter Force kan een alias niet verwijderen met een optieeigenschap 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 die moet worden verwijderd.

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

-Scope

Is alleen van 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 het aantal bereiken, waarbij 0 het huidige bereik is en 1 het bovenliggende bereik is)
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 deze cmdlet.

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.