Condividi tramite

New-Alias

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Crea un nuovo alias.

Sintassi

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 di PowerShell corrente. Gli alias creati tramite New-Alias non vengono salvati dopo l'uscita dalla sessione o la chiusura di PowerShell. È possibile usare il cmdlet Export-Alias per salvare le informazioni sull'alias in un file. In seguito è possibile usare Import-Alias per recuperare le informazioni sull'alias salvato.

Esempio

Esempio 1: Creare un alias per un cmdlet

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

Questo comando crea un alias denominato C per rappresentare il cmdlet Get-ChildItem. Crea una descrizione di "Alias gci rapido" per l'alias e lo rende di sola lettura.

New-Alias -Name "C" -Value Get-ChildItem -Description "Quick gci alias" -Option ReadOnly
Get-Alias -Name "C" | Format-List *

HelpUri             : https://go.microsoft.com/fwlink/?LinkID=2096492
ResolvedCommandName : Get-ChildItem
DisplayName         : C -> Get-ChildItem
ReferencedCommand   : Get-ChildItem
ResolvedCommand     : Get-ChildItem
Definition          : Get-ChildItem
Options             : ReadOnly
Description         : Quick gci alias
OutputType          : {System.IO.FileInfo, System.IO.DirectoryInfo}
Name                : C
CommandType         : Alias
Source              :
Version             :
Visibility          : Public
ModuleName          :
Module              :
RemotingCapability  : PowerShell
Parameters          : {[Path, System.Management.Automation.ParameterMetadata], [LiteralPath,
                      System.Management.Automation.ParameterMetadata], [Filter,
                      System.Management.Automation.ParameterMetadata], [Include,
                      System.Management.Automation.ParameterMetadata]…}

Il comando Get-Alias inviato tramite pipe a Format-List mostra tutte le informazioni sul nuovo alias.

Esempio 3: Creare un alias per un comando con parametri

function Set-ParentDirectory {Set-Location -Path ..}
New-Alias -Name .. -Value Set-ParentDirectory

Il primo comando crea la funzione Set-ParentDirectory, che usa Set-Location per impostare il percorso di lavoro sulla directory padre. Il secondo comando usa New-Alias per creare un alias di .. per chiamare la funzione Set-ParentDirectory. Poiché il parametro Value richiede un cmdlet, una funzione o un valore eseguibile, è necessario creare una funzione personalizzata per creare un alias che usa parametri. L'esecuzione dell'alias .. modifica il percorso corrente nella directory padre.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Description

Specifica una descrizione dell'alias. È possibile digitare qualsiasi stringa. Se la descrizione include spazi, racchiuderla tra virgolette.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

Indica che il cmdlet agisce come Set-Alias se l'alias denominato esiste già.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specifica il nuovo alias. È possibile usare qualsiasi carattere alfanumerico in un alias, ma il primo carattere non può essere un numero.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Option

Specifica il valore della proprietà opzioni 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 Force
  • Constant: l'alias non può essere eliminato o modificato
  • Private: l'alias è disponibile solo nell'ambito corrente
  • AllScope: l'alias viene copiato in tutti i nuovi ambiti creati
  • Unspecified: 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 tramite tabulazione sui valori.

Per visualizzare la proprietà opzioni di di tutti gli alias nella sessione, digitare Get-Alias | Format-Table -Property Name, Options -AutoSize.

Tipo:ScopedItemOptions
Valori accettati:None, ReadOnly, Constant, Private, AllScope, Unspecified
Posizione:Named
Valore predefinito:[System.Management.Automation.ScopedItemOptions]::None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PassThru

Restituisce un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet non genera alcun output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Scope

Specifica l'ambito del nuovo alias. I valori accettabili per questo parametro sono:

  • Global
  • Local
  • Script
  • 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 altre informazioni, vedere about_Scopes.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Value

Specifica il nome del cmdlet o dell'elemento di comando che viene eseguito l'aliasing.

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Non è possibile inviare tramite pipe oggetti a questo cmdlet.

Output

None

Per impostazione predefinita, questo cmdlet non restituisce alcun output.

AliasInfo

Quando si utilizza 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 o New-Alias. Per modificare un alias, usare Set-Alias. Per eliminare un alias, usare Remove-Alias.