New-Alias
Crea un nuovo alias.
Sintassi
New-Alias
[-Name] <String>
[-Value] <String>
[-Description <String>]
[-Option <ScopedItemOptions>]
[-PassThru]
[-Scope <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Il New-Alias
cmdlet crea un nuovo alias nella sessione di PowerShell corrente. Gli alias creati tramite New-Alias
non vengono salvati dopo aver chiuso la sessione o chiudere PowerShell.
È possibile usare il cmdlet per salvare le informazioni sull'alias Export-Alias
in un file. È possibile usare in seguito per recuperare le informazioni sull'alias Import-Alias
salvato.
Esempio
Esempio 1: Create un alias per un cmdlet
New-Alias -Name "List" Get-ChildItem
Questo comando crea un alias denominato List per rappresentare il cmdlet di Get-ChildItem.
Esempio 2: Create un alias di sola lettura per un cmdlet
New-Alias -Name "C" -Value Get-ChildItem -Description "quick gci alias" -Option ReadOnly
Get-Alias -Name "C" | Format-List *
Questo comando crea un alias denominato C
per rappresentare il Get-ChildItem
cmdlet. Crea una descrizione, , quick gci alias
per l'alias e lo rende di sola lettura. L'ultima riga del comando usa Get-Alias
per ottenere il nuovo alias e pipe per Format-List per visualizzare tutte le informazioni su di esso.
Parametri
-Confirm
Richiede la conferma dell'utente prima di eseguire il cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Specifica una descrizione dell'alias. È possibile digitare qualsiasi stringa. Se la descrizione include spazi, racchiuderla tra virgolette.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Indica che il cmdlet agisce come Set-Alias
se l'alias denominato esiste già.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Specifica il nuovo alias. È possibile usare qualsiasi carattere alfanumerico in un alias, ma il primo carattere non può essere un numero.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Option
Specifica il valore della proprietà Options dell'alias. I valori validi sono:
None
: l'alias non ha vincoli (valore predefinito)ReadOnly
: l'alias può essere eliminato ma non può essere modificato usando il parametro ForceConstant
: l'alias non può essere eliminato o modificatoPrivate
: l'alias è disponibile solo nell'ambito correnteAllScope
: l'alias viene copiato in tutti i nuovi ambiti creatiUnspecified
: l'opzione non è specificata
Questi valori sono definiti come enumerazione basata su flag. È possibile combinare più valori per impostare più flag usando questo parametro. I valori possono essere passati al parametro Option come matrice di valori o come stringa delimitata da virgole di tali valori. Il cmdlet combina i valori usando un'operazione binary-OR. Il passaggio di valori come matrice è l'opzione più semplice e consente anche di usare il completamento della scheda sui valori.
Per visualizzare la proprietà Options di tutti gli alias nella sessione, digitare Get-Alias | Format-Table -Property Name, Options -AutoSize
.
Type: | ScopedItemOptions |
Accepted values: | None, ReadOnly, Constant, Private, AllScope, Unspecified |
Position: | Named |
Default value: | [System.Management.Automation.ScopedItemOptions]::None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Restituisce un oggetto che rappresenta l'elemento in uso. Per impostazione predefinita, il cmdlet non genera alcun output.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scope
Specifica l'ambito del nuovo alias. I valori validi per questo parametro sono:
Global
Local
Script
- Numero relativo all'ambito corrente (0 fino al numero di ambiti, dove
0
è l'ambito corrente ed1
è il relativo elemento padre).
Local
è l'impostazione predefinita. Per altre informazioni, vedere about_Scopes.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Value
Specifica il nome del cmdlet o dell'elemento di comando a cui si associa un alias.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
None
Non è possibile eseguire la pipe degli oggetti a questo cmdlet.
Output
None
Per impostazione predefinita, questo cmdlet non restituisce alcun output.
Quando si usa il parametro PassThru , questo cmdlet restituisce un oggetto AliasInfo che rappresenta il nuovo alias.
Note
PowerShell include gli alias seguenti per New-Alias
:
Tutte le piattaforme:
nal
Per creare un nuovo alias, usare
Set-Alias
oNew-Alias
. Per modificare un alias, usareSet-Alias
. Per eliminare un alias, usareRemove-Alias
.