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 reindirizzare i nomi degli alias a Get-Alias.

Output

AliasInfo

Get-Alias Restituisce un oggetto che rappresenta ogni alias. Get-Alias Restituisce lo stesso oggetto per ogni alias, ma PowerShell usa un formato basato su frecce per visualizzare i nomi degli alias senza trattino.

Note

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