Crea un nuovo alias.
Sintassi
New-Alias [-Name] <string> [-Value] <string> [-Description <string>] [-Force] [-Option {<None> | <ReadOnly> | <Constant> | <Private> | <AllScope>}] [-PassThru] [-Scope <string>] [-Confirm] [-WhatIf] [<CommonParameters>]
Descrizione
Il cmdlet New-Alias crea un nuovo alias nella sessione corrente di Windows PowerShell. Gli alias creati tramite New-Alias non verranno salvati dopo l'uscita dalla sessione o la chiusura di Windows PowerShell. È possibile utilizzare il cmdlet Export-Alias per salvare in un file le informazioni sugli alias. È possibile utilizzare Import-Alias in un secondo momento per recuperare le informazioni salvate sugli alias.
Parametri
-Description <string>
Specifica una descrizione dell'alias. È possibile digitare qualsiasi stringa. Se la descrizione include spazi, racchiuderla tra virgolette.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Force
Se impostato, è simile a Set-Alias se l'alias denominato esiste già.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Name <string>
Specifica il nuovo alias. In un alias è possibile utilizzare qualsiasi carattere alfanumerico, tuttavia il primo carattere non può essere un numero.
|
Obbligatorio? |
true |
|
Posizione? |
1 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-Option <ScopedItemOptions>
Imposta una o più proprietà facoltative dell'alias. I valori validi sono:
-- None: non imposta alcuna opzione. (valore predefinito)
-- ReadOnly: gli alias non sono modificabili a meno che non si utilizzi il parametro Force.
-- Constant: l'alias non è modificabile anche se si utilizza il parametro Force.
-- Private: l'alias è disponibile solo nell'ambito specificato dal parametro Scope ed è invisibile in tutti gli altri ambiti.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-PassThru
Restituisce un oggetto che rappresenta il nuovo alias. Per impostazione predefinita, il cmdlet non genera alcun output.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Scope <string>
Specifica l'ambito del nuovo alias. 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, vedere about_Scopes.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Value <string>
Specifica il nome dell'elemento del cmdlet o del comando che viene convertito in forma di alias.
|
Obbligatorio? |
true |
|
Posizione? |
2 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-Confirm
Chiede una conferma prima di eseguire il comando.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-WhatIf
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
<CommonParameters>
Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.
Input e output
Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.
|
Input |
Nessuno Non è possibile reindirizzare l'input a questo cmdlet. |
|
Output |
Nessuno o System.Management.Automation.AliasInfo Quando si utilizza il parametro PassThru, New-Alias genera un oggetto System.Management.Automation.AliasInfo che rappresenta il nuovo alias. Negli altri casi, il 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.
Esempio 1
C:\PS>new-alias list get-childitem Descrizione ----------- Questo comando crea un alias denominato "list" per rappresentare il cmdlet Get-ChildItem.
Esempio 2
C:\PS>new-alias -name w -value get-wmiobject -description "quick wmi alias" -option ReadOnly C:\PS> get-alias -name w | format-list * Descrizione ----------- Questo comando crea un alias denominato "w" per rappresentare il cmdlet Get-WMIObject. Per l'alias verrà creata una descrizione "quick wmi alias" che verrà impostata come di sola lettura. Nell'ultima riga del comando viene utilizzato Get-Alias per ottenere il nuovo alias che verrà reindirizzato a Format-List per visualizzare tutte le informazioni relative.
Vedere anche