about_Alias_Provider
Nome provider
Alias
Unità
Alias:
Funzionalità
ShouldProcess
Descrizione breve
Fornisce l'accesso agli alias di PowerShell e ai valori rappresentati.
Descrizione dettagliata
Il provider PowerShell Alias consente di ottenere, aggiungere, modificare, cancellare ed eliminare alias in PowerShell.
Un alias è un nome alternativo per un cmdlet, una funzione, un file eseguibile, inclusi gli script. PowerShell include un set di alias predefiniti. È possibile aggiungere alias personalizzati alla sessione corrente e al profilo di PowerShell.
L'unità Alias è uno spazio dei nomi flat che contiene solo gli alias oggetti . Gli alias non hanno elementi figlio.
Il Alias provider supporta i cmdlet seguenti, illustrati in questo articolo.
PowerShell include un set di cmdlet progettati per visualizzare e modificare gli alias. Quando si usano Alias i cmdlet, non è necessario specificare l'unità Alias:
nel nome. Questo articolo non illustra l'uso Alias dei cmdlet.
Tipi esposti da questo provider
Ogni alias è un'istanza della classe System.Management.Automation.AliasInfo .
Esplorazione dell'unità Alias
Il Alias provider espone l'archivio dati nell'unità Alias:
. Per usare gli alias, è possibile passare alla posizione dell'unità Alias:
usando il comando seguente:
Set-Location Alias:
Per tornare in un'unità di file system, digitare il relativo nome. Ad esempio, digitare il comando seguente:
Set-Location C:
È anche possibile usare il Alias provider da qualsiasi altra unità di PowerShell. Per fare riferimento a un oggetto alias da un'altra posizione, usare il nome dell'unità Alias:
nel percorso.
Nota
PowerShell usa gli alias per consentire un modo familiare per usare i percorsi del provider. I comandi come dir
e sono ora alias in Windows e dir
in Linux e macOS per Get-ChildItem, cd
è un per alias Set-Locationls
. ed pwd
è un oggetto alias per Get-Location.
Visualizzazione del contenuto dell'unità Alias:
Questo comando ottiene l'elenco di tutti gli alias quando la posizione corrente è l'unità Alias:
. Usa un carattere *
jolly per indicare tutto il contenuto della posizione corrente.
PS Alias:\> Get-Item -Path *
Nell'unità Alias:
, un punto .
, che rappresenta la posizione corrente e un carattere *
jolly , che rappresenta tutti gli elementi nella posizione corrente, hanno lo stesso effetto. Ad esempio, Get-Item -Path .
o Get-Item \*
produrre lo stesso risultato.
Il Alias provider non ha contenitori, quindi il comando precedente ha lo stesso effetto quando viene usato con Get-ChildItem
.
Get-ChildItem -Path Alias:
Ottiene un'opzione selezionata alias
Questo comando ottiene l'oggetto ls
alias.
Poiché include il percorso, è possibile usarlo in qualsiasi unità di PowerShell.
Get-Item -Path Alias:ls
Se ci si trova nell'unità Alias:
, è possibile omettere il nome dell'unità dal percorso.
È anche possibile recuperare per definition un oggetto alias anteponendo il percorso del provider con il segno di dollaro ($
).
$Alias:ls
Ottenere tutti gli alias per un cmdlet specifico
Questo comando ottiene un elenco degli alias associati al Get-ChildItem
cmdlet . Usa la Definition proprietà , che archivia il nome del cmdlet.
Get-Item -Path Alias:* | Where-Object {$_.Definition -eq "Get-ChildItem"}
Creazione di alias
Creare un oggetto alias dall'unità Alias:
Questo comando crea l'oggetto serv
alias per il Get-Service
cmdlet . Poiché la posizione corrente si trova nell'unità Alias:
, il -Path
parametro non è necessario.
Questo comando usa anche il -Options
parametro dinamico per impostare su AllScopeoption alias. Il -Options
parametro è disponibile nel New-Item
cmdlet solo quando si è nell'unità Alias:
. Il punto (.
) indica la directory corrente, ovvero l'unità alias .
PS Alias:\> New-Item -Path . -Name serv -Value Get-Service -Options "AllScope"
Creare un oggetto alias con un percorso assoluto
È possibile creare un oggetto alias per qualsiasi elemento che richiama un comando.
Questo comando crea l'oggetto np
alias per Notepad.exe
.
New-Item -Path Alias:np -Value c:\windows\notepad.exe
Creare un oggetto alias in una nuova funzione
È possibile creare un oggetto alias per qualsiasi funzione. È possibile usare questa funzionalità per creare un oggetto alias che includa sia un cmdlet che i relativi parametri.
Il primo comando crea la CD32
funzione , che modifica la directory corrente nella System32
directory . Il secondo comando crea l'oggetto go
alias per la CD32
funzione.
Al termine del comando, è possibile usare CD32
o go
per richiamare la funzione.
function CD32 {Set-Location -Path c:\windows\system32}
Set-Item -Path Alias:go -Value CD32
Modifica degli alias
Modificare le opzioni di un oggetto alias
È possibile usare il Set-Item
cmdlet con il -Options
parametro dinamico per modificare il valore della -Options
proprietà di un oggetto alias.
Questo comando imposta le AllScope opzioni e ReadOnly per .dir
alias Il comando usa il -Options
parametro dinamico del Set-Item
cmdlet . Il -Options
parametro è disponibile in Set-Item
quando viene usato con il Alias provider di funzioni o .
Set-Item -Path Alias:dir -Options "AllScope,ReadOnly"
Modificare un comando a cui si fa riferimento a un alias
Questo comando usa il Set-Item
cmdlet per modificare inalias gp
modo che rappresenti il Get-Process
cmdlet anziché il Get-ItemProperty
cmdlet .
Il -Force
parametro è obbligatorio perché il valore della proprietà Options di gp
alias è impostato su ReadOnly
. Poiché il comando viene inviato dall'interno dell'unità Alias:
, l'unità non viene specificata nel percorso.
Set-Item -Path gp -Value Get-Process -Force
La modifica influisce sulle quattro proprietà che definiscono l'associazione tra alias e il comando . Per visualizzare l'effetto della modifica, digitare il comando seguente:
Get-Item -Path gp | Format-List -Property *
Rinominare un oggetto alias
Questo comando usa il Rename-Item
cmdlet per modificare inalias popd
pop
.
Rename-Item -Path Alias:popd -NewName pop
Copia di un oggetto alias
Questo comando copia in pushd
alias modo che venga creato un nuovo push
alias oggetto per il Push-Location
cmdlet .
Quando viene creato il nuovo alias oggetto, la relativa proprietà Description ha un valore Null.
E la relativa Option proprietà ha un valore pari a None
. Se il comando viene eseguito dall'interno dell'unità Alias:
, è possibile omettere il nome dell'unità dal valore del -Path
parametro .
Copy-Item -Path Alias:pushd -Destination Alias:push
Eliminazione di un oggetto alias
Questo comando elimina l'oggetto serv
alias dalla sessione corrente.
È possibile usare questo comando in qualsiasi unità di PowerShell.
Remove-Item -Path Alias:serv
Questo comando elimina gli alias che iniziano per "s". Non elimina gli alias di sola lettura.
Clear-Item -Path Alias:s*
Eliminare alias di sola lettura
Questo comando elimina tutti gli alias dalla sessione corrente, ad eccezione di quelli con un valore per Constant
la proprietà Options . Il -Force
parametro consente al comando di eliminare alias la cui proprietà Options ha il valore ReadOnly
.
Remove-Item Alias:* -Force
Parametri dinamici
I parametri dinamici sono parametri cmdlet aggiunti da un provider di PowerShell e sono disponibili solo quando il cmdlet viene usato nell'unità abilitata per il provider.
Opzioni [System.Management.Automation.ScopedItemOptions]
Determina il valore della proprietà Options di un oggetto alias.
- None: nessuna opzione. Si tratta del valore predefinito.
- Constant:non alias è possibile eliminare e le relative proprietà non possono essere modificate. Constant è disponibile solo quando si crea un oggetto alias. Non è possibile modificare l'oggetto option di un oggetto esistente alias in Constant.
- Private:l'oggetto alias è visibile solo nell'ambito corrente, non negli ambiti figlio.
- ReadOnly:Le proprietà di alias non possono essere modificate ad eccezione del
-Force
parametro . È possibile usareRemove-Item
per eliminare .alias - AllScope:l'oggetto alias viene copiato in tutti i nuovi ambiti creati.
Cmdlet supportati
Uso della pipeline
I cmdlet del provider accettano l'input della pipeline. È possibile usare la pipeline per semplificare l'attività inviando i dati del provider da un cmdlet a un altro cmdlet del provider. Per altre informazioni su come usare la pipeline con i cmdlet del provider, vedere i riferimenti ai cmdlet forniti in questo articolo.
Visualizzazione delle informazioni della Guida
A partire da Windows PowerShell 3.0, è possibile ottenere argomenti della Guida personalizzati per i cmdlet del provider che ne illustrano il comportamento in un'unità di file system.
Per ottenere gli argomenti della Guida personalizzati per l'unità del file system, eseguire un comando Get-Help in un'unità file system o usare il -Path
parametro Get-Help per specificare un'unità del file system.
Get-Help Get-ChildItem
Get-Help Get-ChildItem -Path alias: