Condividi tramite

Get-Alias

Modulo:
Microsoft.PowerShell.Utility Module

Ottiene gli alias per la sessione corrente.

Sintassi

Default (Impostazione predefinita) 

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

Definition 

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, Get-Alias 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.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:True
DontShow:False

Set di parametri

Definition
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

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

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:True
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

Specifica gli alias che ottiene questo cmdlet. Sono consentiti i metacaratteri. 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.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:All aliases
Supporta i caratteri jolly:True
DontShow:False

Set di parametri

Default
Posizione:0
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Scope

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

  • Global
  • Local
  • Script
  • Numero riferito all'ambito attuale (da 0 al numero di ambiti, dove 0 è l'ambito attuale e 1 è l'ambito padre)

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

Proprietà dei parametri

Tipo:String
Valore predefinito:Local
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

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

Windows PowerShell include gli alias seguenti per Get-Alias:

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