New-Alias
Crea un nuovo alias.
Sintassi
Default (Impostazione predefinita)
New-Alias
[-Name] <String>
[-Value] <String>
[-Description <String>]
[-Option <ScopedItemOptions>]
[-PassThru]
[-Scope <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Il cmdlet New-Alias crea un nuovo alias nella sessione corrente di Windows PowerShell. Gli alias creati utilizzando New-Alias non vengono salvati dopo l'uscita dalla sessione o la chiusura di Windows PowerShell. È possibile utilizzare il cmdlet Export-Alias per salvare le informazioni sull'alias in un file. In seguito è possibile utilizzare Import-Alias per recuperare le informazioni sull'alias salvate.
Esempio
Esempio 1: Creare un alias per un cmdlet
PS C:\> New-Alias -Name "List" Get-ChildItem
Questo comando crea un alias denominato List per rappresentare il cmdlet Get-ChildItem.
Esempio 2: Creare un alias di sola lettura per un cmdlet
PS C:\> New-Alias -Name "W" -Value Get-WmiObject -Description "quick wmi alias" -Option ReadOnly
PS C:\> Get-Alias -Name "W" | Format-List *
Questo comando crea un alias denominato W per rappresentare il cmdlet Get-WmiObject. Crea una descrizione, alias wmi rapido, per l'alias e lo rende di sola lettura. L'ultima riga del comando utilizza Get-Alias per ottenere il nuovo alias e lo invia a Format-List per visualizzare tutte le informazioni su di esso.
Parametri
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Description
Specifica una descrizione dell'alias. È possibile digitare qualsiasi stringa. Se la descrizione include spazi, racchiuderla tra virgolette.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Force
Indica che il cmdlet si comporta come Set-Alias se l'alias denominato esiste già.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Name
Specifica il nuovo alias. È possibile usare qualsiasi carattere alfanumerico in un alias, ma il primo carattere non può essere un numero.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Option
Specifica il valore della proprietà opzioni dell'alias. I valori validi sono:
- Nessuno: l'alias non ha vincoli (valore predefinito)
- ReadOnly: l'alias può essere eliminato ma non può essere modificato se non utilizzando il parametro Force
- Costante: l'alias non può essere eliminato o modificato
- Privato: l'alias è disponibile solo nell'ambito corrente
- AllScope: l'alias viene copiato in tutti i nuovi ambiti creati
- Non specificato: l'opzione non è specificata
Per visualizzare la proprietà opzioni di di tutti gli alias nella sessione, digitare Get-Alias | Format-Table -Property Name, Options -AutoSize.
Proprietà dei parametri
| Tipo: | ScopedItemOptions |
| Valore predefinito: | [System.Management.Automation.ScopedItemOptions]::None |
| Valori accettati: | None, ReadOnly, Constant, Private, AllScope, Unspecified |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-PassThru
Restituisce un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet non genera alcun output.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Scope
Specifica l'ambito del nuovo alias. I valori accettabili per questo parametro sono:
- Generale
- Locale
- Sceneggiatura
- Numero relativo all'ambito corrente (da 0 al numero di ambiti, dove 0 è l'ambito corrente e 1 è il relativo elemento padre).
Local è l'impostazione predefinita. Per ulteriori informazioni, vedere about_Scopes.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Value
Specifica il nome del cmdlet o dell'elemento di comando che viene eseguito l'aliasing.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 1 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Input
None
Non è possibile inviare tramite pipe l'input a questo cmdlet.
Output
None or System.Management.Automation.AliasInfo
Quando si utilizza il parametro Passthru , New-Alias genera un oggetto System.Management.Automation.AliasInfo che rappresenta il nuovo alias. In caso contrario, questo cmdlet non genera alcun output.
Note
Per creare un nuovo alias, utilizzare Set-Alias o New-Alias. Per modificare un alias, utilizzare Set-Alias. Per eliminare un alias, utilizzare Remove-Item.