Get-Alias
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 Definizione , Get-Alias
accetta un nome di comando e restituisce gli alias.
A partire da Windows PowerShell 3.0, Get-Alias
visualizza i nomi di alias non trattini in un <alias> -> <definition>
formato per semplificare la ricerca delle 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 in base al 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 .
Opzioni è 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 per nome e filtro 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 Ambito 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 viene chiamato Definizione, perché cerca il nome dell'elemento nella proprietà Definition dell'oggetto alias.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 è facoltativo. È anche possibile inviare nomi di alias pipe a Get-Alias
.
Type: | String[] |
Position: | 0 |
Default value: | All aliases |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Scope
Specifica l'ambito per il quale questo cmdlet ottiene alias. I valori validi per questo parametro sono:
Global
Local
Script
- Numero relativo all'ambito corrente (0 al numero di ambiti, dove 0 è l'ambito corrente e 1 è il relativo padre)
Local
è l'impostazione predefinita. Per altre informazioni, vedere about_Scopes.
Type: | String |
Position: | Named |
Default value: | Local |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
È possibile inviare una pipe a una stringa contenente un nome alias a questo cmdlet.
Output
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 trattini.
Note
PowerShell include gli alias seguenti per Get-Alias
:
Tutte le piattaforme:
gal
Per creare un nuovo alias, usare
Set-Alias
oNew-Alias
. Per eliminare un alias, usareRemove-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.