Get-Alias

  • Referens
Modul:
Microsoft.PowerShell.Utility

Hämtar aliasen för den aktuella sessionen.

Syntax

Get-Alias
   [[-Name] <String[]>]
   [-Exclude <String[]>]
   [-Scope <String>]
   [<CommonParameters>]
Get-Alias
   [-Exclude <String[]>]
   [-Scope <String>]
   [-Definition <String[]>]
   [<CommonParameters>]

Description

Cmdleten Get-Alias hämtar aliasen i den aktuella sessionen. Detta omfattar inbyggda alias, alias som du har angett eller importerat och alias som du har lagt till i din PowerShell-profil.

Tar som standard Get-Alias ett alias och returnerar kommandonamnet. När du använder parametern Get-Alias Definition tar du ett kommandonamn och returnerar dess alias.

Från och med Windows PowerShell 3.0 Get-Alias visas namn på icke-bindestreckade alias i ett <alias> -> <definition> format som gör det ännu enklare att hitta den information du behöver.

Exempel

Exempel 1: Hämta alla alias i den aktuella sessionen

Get-Alias

CommandType     Name
-----------     ----
Alias           % -> ForEach-Object
Alias           ? -> Where-Object
Alias           ac -> Add-Content
Alias           asnp -> Add-PSSnapin
Alias           cat -> Get-Content
Alias           cd -> Set-Location
Alias           chdir -> Set-Location
Alias           clc -> Clear-Content
Alias           clear -> Clear-Host
Alias           clhy -> Clear-History
...

Det här kommandot hämtar alla alias i den aktuella sessionen.

Utdata visar formatet <alias> -> <definition> som introducerades i Windows PowerShell 3.0. Det här formatet används endast för alias som inte innehåller bindestreck, eftersom alias med bindestreck vanligtvis är föredragna namn för cmdletar och funktioner i stället för smeknamn.

Exempel 2: Hämta alias efter namn

Get-Alias -Name gp*, sp* -Exclude *ps

Det här kommandot hämtar alla alias som börjar med gp eller sp, förutom alias som slutar med ps.

Exempel 3: Hämta alias för en cmdlet

Get-Alias -Definition Get-ChildItem

Det här kommandot hämtar aliasen för cmdleten Get-ChildItem .

Som standard Get-Alias hämtar cmdleten objektnamnet när du känner till aliaset. Parametern Definition hämtar aliaset när du känner till objektnamnet.

Exempel 4: Hämta alias efter egenskap

Get-Alias | Where-Object {$_.Options -Match "ReadOnly"}

Det här kommandot hämtar alla alias där värdet för egenskapen Alternativ är ReadOnly. Med det här kommandot kan du snabbt hitta de alias som är inbyggda i PowerShell, eftersom de har alternativet ReadOnly .

Alternativ är bara en egenskap för de AliasInfo-objekt som Get-Alias hämtas. Om du vill hitta alla egenskaper och metoder för AliasInfo-objekt skriver du Get-Alias | get-member.

Exempel 5: Hämta alias efter namn och filter genom att börja bokstaven

Get-Alias -Definition "*-PSSession" -Exclude e* -Scope Global

Det här exemplet hämtar alias för kommandon som har namn som slutar med "-PSSession", förutom de som börjar med "e".

Kommandot använder parametern Omfång för att tillämpa kommandot i det globala omfånget. Detta är användbart i skript när du vill hämta aliasen i sessionen.

Parametrar

-Definition

Hämtar aliasen för det angivna objektet. Ange namnet på en cmdlet, funktion, skript, fil eller körbar fil.

Den här parametern kallas Definition eftersom den söker efter objektnamnet i egenskapen Definition för aliasobjektet.

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

-Exclude

Utelämnar de angivna objekten. Värdet för den här parametern kvalificerar parametrarna Namn och Definition . Ange ett namn, en definition eller ett mönster, till exempel "s*". Jokertecken tillåts.

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

-Name

Anger de alias som den här cmdleten hämtar. Jokertecken tillåts. Som standard Get-Alias hämtar alla alias som definierats för den aktuella sessionen. Parameternamnet Namn är valfritt. Du kan också skicka aliasnamn till Get-Alias.

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

-Scope

Anger det omfång för vilket den här cmdleten hämtar alias. De acceptabla 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)

Local används som standard. Mer information finns i about_Scopes.

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

Indata

String

Du kan skicka en sträng som innehåller ett aliasnamn till den här cmdleten.

Utdata

AliasInfo

Den här cmdleten returnerar ett objekt som representerar varje alias. Den returnerar samma typ av objekt för varje alias, men PowerShell använder ett pilbaserat format för att visa namnen på icke-bindestreckade alias.

Kommentarer

PowerShell innehåller följande alias för Get-Alias:

  • Alla plattformar:

    • gal

  • Om du vill skapa ett nytt alias använder du Set-Alias eller New-Alias. Om du vill ta bort ett alias använder du Remove-Item.

  • Det pilbaserade aliasnamnets format används inte för alias som innehåller ett bindestreck. Dessa är sannolikt att föredra ersättningsnamn för cmdletar och funktioner, i stället för typiska förkortningar eller smeknamn.