Set-Alias
Crea o modifica un alias (nome alternativo) di un cmdlet o di un altro elemento di comando nella sessione corrente di Windows PowerShell.
Descrizione
Il cmdlet Set-Alias consente di creare o modificare un alias, ovvero un nome alternativo, per un cmdlet o un elemento di comando, ad esempio una funzione, uno script, un file o un altro file eseguibile. È inoltre possibile utilizzare Set-Alias per riassegnare un alias corrente a un nuovo comando oppure modificare una qualsiasi delle proprietà di un alias, ad esempio la descrizione. A meno che l'alias non venga aggiunto al profilo di Windows PowerShell, le modifiche apportate a un alias andranno perse quando si esce dalla sessione o si chiude Windows PowerShell.
Parametri
| Nome |
Descrizione e modalità d'uso |
| -name |
-name <string>
|
Specifica il nuovo alias. In un alias è possibile utilizzare qualsiasi carattere alfanumerico, tuttavia il primo carattere non può essere un numero.
|
| -value |
-value <string>
|
Specifica il nome dell'elemento del cmdlet o del comando che viene convertito in forma di alias.
|
| -description |
-description <string>
|
Specifica una descrizione dell'alias. È possibile digitare qualsiasi stringa. Se la descrizione include spazi, racchiuderla tra virgolette.
|
| -option |
-option <ScopedItemOptions>
|
Imposta il valore della proprietà Options dell'alias.
I valori validi sono:
- None: Non imposta nessuna opzione. (valore predefinito)
- ReadOnly: non è possibile modificare le proprietà dell'alias, a meno che non si utilizzi il parametro Force. È possibile utilizzare Remove-Item per eliminare l'alias.
- Constant: l'alias non può essere eliminato e non è possibile modificarne le proprietà. Il valore Constant è disponibile solo quando si crea un alias. Non è possibile modificare in Constant l'opzione di un alias esistente.
- Private: l'alias è disponibile solo nell'ambito specificato dal parametro Scope ed è invisibile in tutti gli altri ambiti.
- AllScope: l'alias viene copiato in qualsiasi nuovo ambito creato.
Per vedere la proprietà Options degli alias, digitare "get-alias | format-table -property Name, Definition, Options -autosize".
Di seguito sono elencati i valori consentiti per questo parametro:
- None
- ReadOnly
- Constant
- Private
- AllScope
|
| -passThru |
-passThru
|
Passa l'oggetto creato da questo cmdlet attraverso la pipeline. Per impostazione predefinita, tramite questo cmdlet non viene passato alcun oggetto attraverso la pipeline.
|
| -scope |
-scope <string>
|
Specifica l'ambito in cui l'alias è considerato valido. 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, digitare "get-help about_scope".
|
| -force |
-force
|
Ignora le restrizioni che impediscono la corretta esecuzione del comando, purché le modifiche non abbiano effetti negativi sulla protezione. Force, ad esempio, ignora l'attributo di sola lettura o crea directory per completare un percorso di file, ma non tenta di modificare le autorizzazioni per il file.
|
| -whatIf |
-whatIf
|
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.
|
| -confirm |
-confirm
|
Richiede una conferma prima di eseguire il comando.
|
Contenuti riprodotti su gentile concessione di Microsoft Corporation.
© 2007 Microsoft Corporation. All rights reserved.