Condividi tramite

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 cmdlet Get-Alias 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 definizione , accetta un nome di comando e ne restituisce gli alias.

A partire da Windows PowerShell 3.0, Get-Alias visualizza nomi di alias non sillabati in un formato <alias> -> <definition> 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 formato <alias> -> <definition> introdotto in Windows PowerShell 3.0. Questo formato viene usato solo per gli alias che non includono trattini, perché gli alias con trattini sono in genere nomi preferiti per cmdlet e funzioni, anziché 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 cmdlet Get-ChildItem.

Per impostazione predefinita, il cmdlet Get-Alias ottiene il nome dell'elemento quando si conosce l'alias. Il parametro definizione 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 consente di trovare rapidamente 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 di 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 con nomi che terminano in "-PSSession", ad eccezione di quelli che iniziano con "e".

Il comando usa il parametro ambito per applicare il comando nell'ambito globale. Ciò è utile negli script quando si desidera ottenere gli alias nella 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 viene chiamato Definizione, 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 criterio, ad esempio "s*". Sono consentiti caratteri jolly.

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. Sono consentiti caratteri jolly. Per impostazione predefinita, Get-Alias recupera tutti gli alias definiti per la sessione corrente. Il nome del parametro nome è facoltativo. È anche possibile inviare tramite pipe i nomi degli 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 accettabili 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 sulla freccia non viene usato per gli alias che includono un trattino. Questi sono probabilmente nomi sostitutivi preferiti per cmdlet e funzioni, invece di abbreviazioni o nomi alternativi tipici.