Import-Alias
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 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 essersi assicurati che il contenuto del file di alias è 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 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 |
-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 com'è digitato. 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 i caratteri 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:
- Globale
- Locale
- Script
- Numero relativo all'ambito corrente (0 al numero di ambiti, dove 0 è l'ambito corrente e 1 è il relativo 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 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
È possibile inviare una pipe a una stringa contenente un percorso per questo cmdlet.
Output
None
Per impostazione predefinita, questo cmdlet non restituisce alcun output.
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