about_Alias_Provider

  • Articolo

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 .

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, dir ad esempio e ls sono ora alias per Get-ChildItem, cd è un oggetto alias per Set-Location. 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 lsalias. 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 servalias 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 npalias 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 goalias 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 .diralias 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 gpmodo che rappresenti il Get-Process cmdlet anziché il Get-ItemProperty cmdlet . Il -Force parametro è obbligatorio perché il valore della proprietà Options di gpalias è 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 popdpop.

Rename-Item -Path Alias:popd -NewName pop

Copia di un oggetto alias

Questo comando copia in pushdalias modo che venga creato un nuovo pushalias 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 servalias 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 usare Remove-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:

Vedi anche