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 Windows PowerShell corrente. Gli alias creati con New-Alias non vengono salvati dopo aver chiuso la sessione o chiudere Windows PowerShell. È possibile usare il cmdlet Export-Alias per salvare in un file le informazioni sugli alias. In seguito è possibile usare Import-Alias per recuperare le informazioni sull'alias salvato.

Esempio

Esempio 1: Create un alias per un cmdlet

PS C:\> New-Alias -Name "List" Get-ChildItem

Questo comando crea un alias denominato List per rappresentare il cmdlet Get-ChildItem.

Esempio 2: Create un alias di sola lettura per un cmdlet

PS C:\> New-Alias -Name "W" -Value Get-WmiObject -Description "quick wmi alias" -Option ReadOnly
PS C:\> Get-Alias -Name "W" | Format-List *

Questo comando crea un alias denominato W per rappresentare il cmdlet Get-WmiObject. 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 visualizzarne tutte le informazioni.

Parametri

-Confirm

Richiede la conferma dell'utente 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 agisce 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:

  • Nessuno: l'alias non ha vincoli (valore predefinito)
  • ReadOnly: l'alias può essere eliminato ma non può essere modificato se non tramite il parametro Force
  • Costante: l'alias non può essere eliminato o modificato
  • Privato: l'alias è disponibile solo nell'ambito corrente
  • AllScope: l'alias viene copiato in tutti i nuovi ambiti creati
  • Non specificato: l'opzione non è specificata

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:

  • Globale
  • Locale
  • 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.

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 l'esito in caso di 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 input tramite pipe a questo cmdlet.

Output

None or System.Management.Automation.AliasInfo

Quando si usa il parametro Passthru , New-Alias genera un oggetto System.Management.Automation.AliasInfo che rappresenta il nuovo alias. In caso contrario, il cmdlet non genera alcun output.

Note

  • Per creare un nuovo alias, usare Set-Alias o New-Alias. Per modificare un alias, usare Set-Alias. Per eliminare un alias, usare Remove-Item.