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 New-Alias cmdlet 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 Export-Alias cmdlet per salvare le informazioni sull'alias in un file. In un secondo momento è 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 Get-ChildItem cmdlet . 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 Get-Alias comando 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 Set-ParentDirectory funzione. 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 .. consente di modificare 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 funziona 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à 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, ad eccezione dell'uso del 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à Options 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 in uso. Per impostazione predefinita, il 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 validi per questo parametro sono:

  • Global
  • Local
  • Script
  • Numero relativo all'ambito corrente (da 0 al numero di ambiti, dove 0 è l'ambito corrente ed 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 a cui si associa un alias.

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

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. 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 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 o New-Alias. Per modificare un alias, usare Set-Alias. Per eliminare un alias, usare Remove-Alias.