New-Alias

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

Concetti

Set-Alias
Get-Alias
Export-Alias
Import-Alias