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.

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

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

Type:String
Aliases:PSPath, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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

-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.

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

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

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

PowerShell include gli alias seguenti per Import-Alias:

  • Tutte le piattaforme:
    • ipal