Get-Alias

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Ottiene gli alias per la sessione corrente.

Sintassi

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

Descrizione

Il Get-Alias cmdlet ottiene gli alias nella sessione corrente. Sono inclusi alias predefiniti, alias impostati o importati e alias aggiunti al profilo di PowerShell.

Per impostazione predefinita, Get-Alias accetta un alias e restituisce il nome del comando. Quando si usa il parametro Definition , Get-Alias accetta un nome di comando e ne restituisce gli alias.

A partire da Windows PowerShell 3.0, Get-Alias visualizza i nomi di alias non sillabati in un <alias> -> <definition> formato per rendere ancora più semplice trovare le informazioni necessarie.

Esempio

Esempio 1: Ottenere tutti gli alias nella sessione corrente

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
...

Questo comando ottiene tutti gli alias nella sessione corrente.

L'output mostra il <alias> -> <definition> formato introdotto in Windows PowerShell 3.0. Questo formato viene usato solo per gli alias che non includono trattini, poiché gli alias con trattini sono in genere i nomi preferiti per cmdlet e funzioni, anziché i nomi alternativi.

Esempio 2: Ottenere alias per nome

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

Questo comando ottiene tutti gli alias che iniziano con gp o sp, ad eccezione degli alias che terminano con ps.

Esempio 3: Ottenere alias per un cmdlet

Get-Alias -Definition Get-ChildItem

Questo comando ottiene gli alias per il Get-ChildItem cmdlet.

Per impostazione predefinita, il Get-Alias cmdlet ottiene il nome dell'elemento quando si conosce l'alias. Il parametro Definition ottiene l'alias quando si conosce il nome dell'elemento.

Esempio 4: Ottenere alias per proprietà

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

Questo comando ottiene tutti gli alias in cui il valore della proprietà Options è ReadOnly. Questo comando offre un modo rapido per trovare gli alias incorporati in PowerShell, perché hanno l'opzione ReadOnly .

Options è solo una proprietà degli oggetti AliasInfo che Get-Alias ottiene. Per trovare tutte le proprietà e i metodi degli oggetti AliasInfo , digitare Get-Alias | get-member.

Esempio 5: Ottenere alias in base al nome e filtrare in base alla lettera iniziale

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

Questo esempio ottiene gli alias per i comandi i cui nomi finiscono con "-PSSession", ad eccezione di quelli che iniziano con "e".

Il comando usa il parametro Scope per applicare il comando nell'ambito globale. Ciò è utile negli script per ottenere gli alias della sessione.

Parametri

-Definition

Ottiene gli alias per l'elemento specificato. Immettere il nome di un cmdlet, una funzione, uno script, un file o un file eseguibile.

Questo parametro è denominato Definition, perché cerca il nome dell'elemento nella proprietà Definition dell'oggetto alias.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-Exclude

Omette gli elementi specificati. Il valore di questo parametro qualifica i parametri Name e Definition . Immettere un nome, una definizione o un modello, ad esempio "s*". I caratteri jolly sono consentiti.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-Name

Specifica gli alias che ottiene questo cmdlet. I caratteri jolly sono consentiti. Per impostazione predefinita, Get-Alias recupera tutti gli alias definiti per la sessione corrente. Il nome del parametro Name è facoltativo. È anche possibile inviare tramite pipe i nomi alias a Get-Alias.

Tipo:String[]
Posizione:0
Valore predefinito:All aliases
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:True

-Scope

Specifica l'ambito per il quale questo cmdlet ottiene gli alias. I valori validi per questo parametro sono:

  • Global
  • Local
  • Script
  • Numero relativo all'ambito corrente (da 0 al numero di ambiti, dove 0 è l'ambito corrente e 1 è il relativo elemento padre)

Local è l'impostazione predefinita. Per altre informazioni, vedere about_Scopes.

Tipo:String
Posizione:Named
Valore predefinito:Local
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String

È possibile inviare tramite pipe una stringa contenente un nome alias a questo cmdlet.

Output

AliasInfo

Questo cmdlet restituisce un oggetto che rappresenta ogni alias. Restituisce lo stesso tipo di oggetto per ogni alias, ma PowerShell usa un formato basato sulla freccia per visualizzare i nomi di alias non sillabati.

Note

PowerShell include gli alias seguenti per Get-Alias:

  • Tutte le piattaforme:

    • gal

  • Per creare un nuovo alias, usare Set-Alias o New-Alias. Per eliminare un alias, usare Remove-Item.

  • Il formato del nome alias basato su freccia non viene usato per gli alias che includono un trattino. Rappresentano probabilmente i nomi sostitutivi preferiti per cmdlet e funzioni, anziché le abbreviazioni o i nomi alternativi tipici.