Ottiene gli alias della sessione corrente.

Sintassi

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

Get-Alias [-Definition <string[]>] [-Exclude <string[]>] [-Scope <string>] [<CommonParameters>]

Descrizione

Il cmdlet Get-Alias consente di ottenere gli alias (nomi alternativi per comandi e file eseguibili) nella sessione corrente. Sono inclusi alias predefiniti, alias impostati o importati, nonché alias aggiunti al profilo di Windows PowerShell.

Per impostazione predefinita, Get-Alias consente di accettare un alias e di restituire il nome del comando. Quando si utilizza il parametro Definition, Get-Alias consente di accettare il nome di un comando e di restituirne gli alias.

Parametri

-Definition <string[]>

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, poiché consente di cercare il nome dell'elemento nella proprietà Definition dell'oggetto alias.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

true

-Exclude <string[]>

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*". È consentito l'utilizzo di caratteri jolly.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Name <string[]>

Specifica gli alias da recuperare. È consentito l'utilizzo di caratteri jolly. Per impostazione predefinita, Get-Alias consente di recuperare tutti gli alias definiti per la sessione corrente. Il nome del parametro ("Name") è facoltativo. È inoltre possibile reindirizzare i nomi di alias a Get-Alias.

Obbligatorio?

false

Posizione?

1

Valore predefinito

Accettare input da pipeline?

true (ByValue, ByPropertyName)

Accettare caratteri jolly?

false

-Scope <string>

Ottiene solo gli alias nell'ambito specificato. I valori validi sono "Global", "Local", "Script" oppure un numero relativo all'ambito corrente, ovvero da 0 al numero di ambiti, dove 0 corrisponde all'ambito corrente e 1 al relativo padre. Il valore predefinito è "Local". Per ulteriori informazioni, vedere about_Scopes.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

<CommonParameters>

Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.

Input e output

Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.

Input

System.String

È possibile reindirizzare i nomi di alias a Get-Alias.

Output

System.Management.Automation.AliasInfo

Get-Alias restituisce un oggetto che rappresenta ciascun alias.

Note

Un alias è un nome alternativo di un cmdlet, una funzione o un file eseguibile. Per eseguire il cmdlet, la funzione o l'eseguibile, è possibile utilizzare il relativo nome completo o l'eventuale alias. Per ulteriori informazioni, vedere about_Aliases.

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

Esempio 1

C:\PS>get-alias

Descrizione
-----------
Con questo comando si ottengono tutti gli alias nella sessione corrente.






Esempio 2

C:\PS>get-alias -name g*, s* -exclude get-*

Descrizione
-----------
Con questo comando si ottengono tutti gli alias che iniziano con "g" o "s", fatta eccezione per gli alias che iniziano con "get-".






Esempio 3

C:\PS>get-alias -definition Get-ChildItem

Descrizione
-----------
Con questo comando si ottengono gli alias per il cmdlet Get-ChildItem.

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






Esempio 4

C:\PS>get-alias | where-object {$_.Options -match "ReadOnly"}

Descrizione
-----------
Tramite questo comando verranno recuperati tutti gli alias in cui il valore della proprietà è ReadOnly. Il comando rappresenta pertanto una soluzione rapida per trovare rapidamente gli alias predefiniti in Windows PowerShell, perché sono caratterizzati dall'opzione ReadOnly.

Options è solo una delle proprietà degli oggetti AliasInfo ottenuti da Get-Alias. Per trovare tutte le proprietà e i metodi degli oggetti AliasInfo, digitare "get-alias | get-member".






Esempio 5

C:\PS>get-alias -definition "*-pssession" -exclude e* -scope global

Descrizione
-----------
In questo esempio vengono ottenuti gli alias per i comandi con nomi che terminano in "- pssession", fatta eccezione per quelli che iniziano con "e". 

Viene utilizzato il parametro Scope per applicare il comando nell'ambito globale. Si tratta di una soluzione utile negli script quando si desidera ottenere gli alias nella sessione.






Vedere anche




Argomenti della Guida