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

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

Questo comando crea un alias denominato C per rappresentare il Get-ChildItem cmdlet . Crea una descrizione, un alias wmi rapido, per l'alias e lo rende di sola lettura. L'ultima riga del comando usa Get-Alias per ottenere il nuovo alias e lo invia tramite pipe a Format-List per visualizzare tutte le informazioni su di esso.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:ScopedItemOptions
Accepted values:None, ReadOnly, Constant, Private, AllScope, Unspecified
Position:Named
Default value:[System.Management.Automation.ScopedItemOptions]::None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Restituisce un oggetto che rappresenta l'elemento in uso. Per impostazione predefinita, il cmdlet non genera alcun output.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Value

Specifica il nome del cmdlet o dell'elemento di comando a cui si associa un alias.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.