Delen via


Remove-Alias

Verwijder een alias uit de huidige sessie.

Syntaxis

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

Description

Met de Remove-Alias-cmdlet wordt een alias uit de huidige PowerShell-sessie verwijderd. 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 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 met de eigenschap Options ingesteld op Constante. 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 alle aliassen in de PowerShell-sessie ophaalt en de objecten in de pijplijn verzendt. Where-Object maakt gebruik van een scriptblok en de automatische variabele ($_) en Options eigenschap vertegenwoordigt het huidige pijplijnobject. De parameter NE- (niet gelijk aan), selecteert objecten waarvoor geen opties waarde is ingesteld op constante. Remove-Alias de parameter Forceren gebruikt om aliassen, inclusief alleen-lezenaliassen, te verwijderen uit de PowerShell-sessie. De parameter Forceren kan constant aliassen niet verwijderen.

Parameters

-Force

Geeft aan dat de cmdlet een alias verwijdert, inclusief aliassen met de eigenschap Option ingesteld op ReadOnly-. De parameter Forceren kan geen alias verwijderen met een eigenschap Option ingesteld op Constante.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van de alias die moet worden verwijderd.

Type:String[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Scope

Is alleen van invloed op de aliassen in het opgegeven bereik. Het standaardbereik is Lokale. Zie about_Scopesvoor meer informatie.

De acceptabele 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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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_Aliasesvoor meer informatie.