Condividi tramite

Set-Alias

Modulo:
Microsoft.PowerShell.Utility Module

Crea o modifica un alias per un cmdlet o un altro comando nella sessione di PowerShell corrente.

Sintassi

Default (Impostazione predefinita) 

Set-Alias
    [-Name] <string>
    [-Value] <string>
    [-Description <string>]
    [-Option <ScopedItemOptions>]
    [-PassThru]
    [-Scope <string>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrizione

Il cmdlet Set-Alias crea o modifica un alias per un cmdlet o un comando, ad esempio una funzione, uno script, un file o un altro eseguibile. Un alias è un nome alternativo che fa riferimento a un cmdlet o a un comando. Ad esempio, sal è l'alias del cmdlet Set-Alias. Per altre informazioni, vedere about_Aliases.

Un cmdlet può avere più alias, ma un alias può essere associato solo a un cmdlet. È possibile usare Set-Alias per riassegnare un alias esistente a un altro cmdlet o modificare le proprietà di un alias, ad esempio la descrizione.

Un alias creato o modificato da Set-Alias non è permanente ed è disponibile solo durante la sessione corrente di PowerShell. Quando la sessione di PowerShell viene chiusa, l'alias viene rimosso.

Esempio

Esempio 1: Creare un alias per un cmdlet

Questo comando crea un alias per un cmdlet nella sessione di PowerShell corrente.

PS> Set-Alias -Name list -Value Get-ChildItem

PS> Get-Alias -Name list

CommandType     Name
-----------     ----
Alias           list -> Get-ChildItem

Il cmdlet Set-Alias crea un alias nella sessione di PowerShell corrente. Il parametro Name specifica il nome dell'alias list. Il parametro Value specifica il cmdlet eseguito dall'alias.

Per eseguire l'alias, digitare list nella riga di comando di PowerShell.

Esempio 2: Riassegnare un alias esistente a un cmdlet diverso

Questo comando riassegna un alias esistente per eseguire un cmdlet diverso.

PS> Get-Alias -Name list

CommandType     Name
-----------     ----
Alias           list -> Get-ChildItem

PS> Set-Alias -Name list -Value Get-Location

PS> Get-Alias -Name list

CommandType     Name
-----------     ----
Alias           list -> Get-Location

Il cmdlet Get-Alias usa il parametro name per visualizzare l'alias list. L'alias list è associato al cmdlet Get-ChildItem. Quando viene eseguito l'alias list, vengono visualizzati gli elementi nella directory corrente.

Il cmdlet Set-Alias usa il parametro Name per specificare l'alias list. Il parametro Value associa l'alias al cmdlet Get-Location.

Il cmdlet Get-Alias usa il parametro name per visualizzare l'alias list. L'alias list è associato al cmdlet Get-Location. Quando viene eseguito l'alias list, viene visualizzato il percorso della directory corrente.

Esempio 3: Creare e modificare un alias di sola lettura

Questo comando crea un alias di sola lettura. L'opzione di sola lettura impedisce modifiche indesiderate a un alias. Per modificare o eliminare un alias di sola lettura, usare il parametro Force.

PS> Set-Alias -Name loc -Value Get-Location -Option ReadOnly -PassThru | Format-List -Property *

DisplayName         : loc -> Get-Location
Definition          : Get-Location
Options             : ReadOnly
Description         :
Name                : loc
CommandType         : Alias

PS> Set-Alias -Name loc -Value Get-Location -Option ReadOnly -Description 'Displays the current directory' -Force -PassThru | Format-List -Property *

DisplayName         : loc -> Get-Location
Definition          : Get-Location
Options             : ReadOnly
Description         : Displays the current directory
Name                : loc
CommandType         : Alias

Il cmdlet Set-Alias crea un alias nella sessione di PowerShell corrente. Il parametro Name specifica il nome dell'alias loc. Il parametro Value specifica il cmdlet Get-Location eseguito dall'alias. Il parametro Option consente di specificare il valore ReadOnly. Il parametro PassThru rappresenta l'oggetto alias e invia l'oggetto alla pipeline al cmdlet Format-List. Format-List utilizza il parametro Property con un asterisco (*) in modo che vengano visualizzate tutte le proprietà. L'output di esempio mostra un elenco parziale di tali proprietà.

L'alias loc viene modificato con l'aggiunta di due parametri. Descrizione aggiunge testo per spiegare lo scopo dell'alias. Il parametro Force è necessario perché l'alias loc è di sola lettura. Se il parametro Force non viene utilizzato, la modifica non riesce.

Esempio 4: Creare un alias in un file eseguibile

In questo esempio viene creato un alias in un file eseguibile nel computer locale.

PS> Set-Alias -Name np -Value C:\Windows\notepad.exe

PS> Get-Alias -Name np

CommandType     Name
-----------     ----
Alias           np -> notepad.exe

Il cmdlet Set-Alias crea un alias nella sessione di PowerShell corrente. Il parametro Name specifica il nome dell'alias np. Il parametro Value consente di specificare il percorso e il nome dell'applicazioneC:\Windows\notepad.exe. Il Get-Alias cmdlet utilizza il parametro Name per indicare che l'alias np è associato anotepad.exe.

Per eseguire l'alias, digitare np nella riga di comando di PowerShell per aprire notepad.exe.

Esempio 5: Creare un alias per un comando con parametri

In questo esempio viene illustrato come assegnare un alias a un comando con parametri.

È possibile creare un alias per un cmdlet, ad esempio Set-Location. Non è possibile creare un alias per un comando con parametri e valori, ad esempio Set-Location -Path C:\Windows\System32. Per creare un alias per un comando, creare una funzione che include il comando e quindi creare un alias per la funzione. Per altre informazioni, vedere about_Functions.

PS> Function CD32 {Set-Location -Path C:\Windows\System32}

PS> Set-Alias -Name Go -Value CD32

Viene creata una funzione denominata CD32. La funzione usa il Set-Location cmdlet con il parametro Path per specificare la directory, C:\Windows\System32.

Il cmdlet Set-Alias crea un alias per la funzione nella sessione di PowerShell corrente. Il parametro Name specifica il nome dell'alias Go. Il parametro Value specifica il nome della funzione, CD32.

Per eseguire l'alias, digitare Go nella riga di comando di PowerShell. La CD32 funzione viene eseguita e passa alla directory C:\Windows\System32.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Description

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Force

Usare il parametro Force per modificare o eliminare un alias con il parametro Option impostato su ReadOnly.

Il parametro Force non può modificare o eliminare un alias con il parametro Option impostato su Constant.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

Specifica il nome di un nuovo alias. Un nome alias può contenere caratteri alfanumerici. I nomi degli alias non possono essere numerici, ad esempio 123.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:0
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Option

Imposta il valore della proprietà option dell'alias. Valori come ReadOnly e Constant proteggono un alias da modifiche non intenzionali. Per visualizzare la proprietà option di tutti gli alias nella sessione, digitare Get-Alias | Format-Table -Property Name, Options -Autosize.

I valori accettabili per questo parametro sono i seguenti:

  • AllScope L'alias viene copiato in tutti i nuovi ambiti creati.
  • Costante Non può essere modificato o eliminato.
  • Nessuno Non imposta alcuna opzione ed è l'impostazione predefinita.
  • Privato L'alias è disponibile solo nell'ambito corrente.
  • Sola lettura Non può essere modificato o eliminato a meno che non venga utilizzato il parametro Forza .
  • non specificati

Proprietà dei parametri

Tipo:ScopedItemOptions
Valore predefinito:None
Valori accettati:AllScope, Constant, None, Private, ReadOnly, Unspecified
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PassThru

Restituisce un oggetto che rappresenta l'alias. Usare un cmdlet di formato, ad esempio Format-List per visualizzare l'oggetto. Per impostazione predefinita, Set-Alias non genera alcun output.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Scope

Specifica l'ambito in cui questo alias è valido. Il valore predefinito è local. Per altre informazioni, vedere about_Scopes.

I valori accettabili sono i seguenti:

  • Generale
  • Locale
  • Privato
  • Ambiti numerati
  • Sceneggiatura

Proprietà dei parametri

Tipo:String
Valore predefinito:Local
Valori accettati:Global, Local, Private, Numbered scopes, Script
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Value

Specifica il nome del cmdlet o del comando eseguito dall'alias. Il parametro Value è la proprietà definizione alias.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-WhatIf

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

None

Set-Alias Non accetta input dalla pipeline.

Output

None or System.Management.Automation.AliasInfo

Quando si utilizza il parametro PassThru , Set-Alias viene generato un oggetto System.Management.Automation.AliasInfo che rappresenta l'alias. In caso contrario, Set-Alias non genera alcun output.

Note

PowerShell include alias predefiniti disponibili in ogni sessione di PowerShell. Il cmdlet Get-Alias visualizza gli alias disponibili in una sessione di PowerShell.

Per creare un nuovo alias, usare Set-Alias o New-Alias. Per rimuovere un alias, usare il cmdlet Remove-Item. Ad esempio: Remove-Item -Path Alias:aliasname.

Per creare un alias disponibile in ogni sessione di PowerShell, aggiungerlo al profilo di PowerShell. Per altre informazioni, vedere about_Profiles.

Un alias può essere salvato e riutilizzato in un'altra sessione di PowerShell eseguendo un'esportazione e un'importazione. Per salvare un alias in un file, usare Export-Alias. Per aggiungere un alias salvato a una nuova sessione di PowerShell, usare Import-Alias.