Import-Alias

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Importa un elenco di alias da un file.

Sintassi

Import-Alias
      [-Path] <String>
      [-Scope <String>]
      [-PassThru]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Import-Alias
      -LiteralPath <String>
      [-Scope <String>]
      [-PassThru]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Il Import-Alias cmdlet importa un elenco di alias da un file.

A partire da Windows PowerShell 3.0, come funzionalità di sicurezza, Import-Alias non sovrascrive gli alias esistenti per impostazione predefinita. Per sovrascrivere un alias esistente, dopo aver assicurato che il contenuto del file alias sia sicuro, usare il parametro Force .

Esempio

Esempio 1: Importare alias da un file

Import-Alias test.txt

Questo comando importa informazioni sull'alias da un file denominato test.txt.

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

-Force

Consente al cmdlet di importare un alias già definito o di sola lettura. È possibile usare il comando seguente per visualizzare informazioni sugli alias attualmente definiti:

Get-Alias | Select-Object Name, Options

Se l'alias corrispondente è di sola lettura, verrà visualizzato nel valore della proprietà Options .

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

-LiteralPath

Specifica il percorso di un file che include informazioni sugli alias esportati. A differenza del parametro Path , il valore del parametro LiteralPath viene usato esattamente come viene tipizzato. Nessun carattere viene interpretato come carattere jolly. Se il percorso include caratteri di escape, racchiuderlo tra virgolette singole. Le virgolette singole indicano a PowerShell di non interpretare alcun carattere come sequenze di escape.

Tipo:String
Alias:PSPath
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
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

-Path

Specifica il percorso di un file che include informazioni sugli alias esportati. I caratteri jolly sono consentiti, ma devono essere risolti in un singolo nome.

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

-Scope

Specifica l'ambito in cui vengono importati gli alias. I valori validi per questo parametro sono:

  • Generale
  • Locale
  • Script
  • Numero relativo all'ambito corrente (da 0 al numero di ambiti, dove 0 è l'ambito corrente e 1 è il relativo elemento padre)

Il valore predefinito è Local. 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

-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

String

È possibile inviare tramite pipe una stringa contenente un percorso 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 l'alias.

Note

Windows PowerShell include gli alias seguenti per Import-Alias:

  • ipal