Esporta in un file informazioni sugli alias attualmente definiti.
Sintassi
Export-Alias [-Path] <string> [[-Name] <string[]>] [-Append] [-As {<Csv> | <Script>}] [-Description <string>] [-Force] [-NoClobber] [-PassThru] [-Scope <string>] [-Confirm] [-WhatIf] [<CommonParameters>]
Descrizione
Il cmdlet Export-Alias consente di esportare gli alias nella sessione corrente in un file. Se il file di output non esiste, viene creato automaticamente.
Export-Alias può esportare gli alias in un determinato ambito o in tutti gli ambiti, può generare i dati in formato CSV o come serie di comandi Set-Alias che è possibile aggiungere a una sessione o a un profilo di Windows PowerShell.
Parametri
-Append
Accoda l'output al file specificato, anziché sovrascrivere il contenuto esistente del file.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-As <ExportAliasFormat>
Determina il formato dell'output. Il formato predefinito è CSV.
I valori validi sono:
-- CSV: formato con valori separati da virgole.
-- Script: crea un comando Set-Alias per ogni alias esportato. Se si assegna un nome al file di output con estensione ps1, è possibile eseguirlo come script per aggiungere gli alias a qualsiasi sessione.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Description <string>
Aggiunge una descrizione al file esportato. La descrizione viene visualizzata come commento nella parte iniziale del file dopo le informazioni dell'intestazione.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Force
Sovrascrive il file di output, anche se per il file è impostato l'attributo di sola lettura.
Per impostazione predefinita, Export-Alias sovrascrive i file senza alcun messaggio di avviso, a meno che non sia impostato l'attributo nascosto o di sola lettura o non si utilizzi il parametro NoClobber nel comando. Tale parametro ha la precedenza sul parametro Force quando entrambi vengono utilizzati in un comando.
Il parametro Force non può forzare la sovrascrittura tramite Export-Alias di file con l'attributo nascosto.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
Does not overwrite read-only files. |
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Name <string[]>
Specifica i nomi degli alias da esportare. È consentito l'utilizzo di caratteri jolly.
Per impostazione predefinita, Export-Alias esporta tutti gli alias nella sessione o nell'ambito.
|
Obbligatorio? |
false |
|
Posizione? |
2 |
|
Valore predefinito |
Export all aliases |
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-NoClobber
Impedisce la sovrascrittura di file mediante Export-Alias, anche se nel comando viene utilizzato il parametro Force.
Se viene omesso il parametro NoClobber, Export-Alias sovrascrive un file esistente senza alcun messaggio di avviso, a meno che per il file non sia stato impostato l'attributo di sola lettura. NoClobber ha la precedenza sul parametro Force, pertanto Export-Alias è in grado di sovrascrivere un file con l'attributo di sola lettura.
NoClobber non impedisce l'aggiunta di contenuto a un file esistente tramite il parametro Append.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
Overwrites read-write files. |
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-PassThru
Restituisce oggetti che rappresentano gli alias esportati. Per impostazione predefinita, il cmdlet non genera alcun output.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
No output |
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Path <string>
Specifica il percorso del file di output. È consentito l'utilizzo di caratteri jolly, ma il percorso risultante deve essere risolto in un singolo nome file. Questo parametro è obbligatorio.
|
Obbligatorio? |
true |
|
Posizione? |
1 |
|
Valore predefinito |
nessuno |
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Scope <string>
Specifica l'ambito da cui esportare gli alias.
I valori validi sono "Global", "Local", "Script" oppure un numero relativo all'ambito corrente, ovvero da 0 al numero di ambiti, dove 0 corrisponde all'ambito corrente e 1 al relativo padre. Il valore predefinito è "Local". Per ulteriori informazioni, vedere about_Scopes.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
Local |
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Confirm
Chiede una conferma prima di eseguire il comando.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-WhatIf
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
<CommonParameters>
Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.
Input e output
Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.
|
Input |
Nessuno. Non è possibile reindirizzare oggetti a questo cmdlet. |
|
Output |
Nessuno o System.Management.Automation.AliasInfo Quando si utilizza il parametro PassThru, Export-Alias restituisce un oggetto System.Management.Automation.AliasInfo che rappresenta l'alias. Negli altri casi, il cmdlet non genera alcun output. |
Note
È possibile esportare alias tramite Export-Alias solo in un file.
Esempio 1
C:\PS>export-alias -path alias.csv Descrizione ----------- Con questo comando le informazioni correnti sull'alias verranno esportate in un file denominato Alias.csv nella directory corrente.
Esempio 2
C:\PS>export-alias -path alias.csv -noclobber Descrizione ----------- Con questo comando gli alias nella sessione corrente vengono esportati nel file Alias.csv. Poiché non viene specificato alcun parametro NoClobber, il comando non viene eseguito se nella directory corrente è già presente un file denominato Alias.csv.
Esempio 3
C:\PS>export-alias -path alias.csv -append -description "Appended Aliases" -force Descrizione ----------- Con questo comando gli alias nella sessione corrente vengono aggiunti al file Alias.csv. Viene utilizzato il parametro Description per aggiungere una descrizione ai commenti nella parte iniziale del file. Viene inoltre utilizzato il parametro Force per sovrascrivere qualsiasi file Alias.csv esistente, anche se dispone dell'attributo di sola lettura.
Esempio 4
C:\PS>export-alias -path alias.ps1 -as script C:\PS> add-content -path $profile -value (get-content alias.ps1) C:\PS> $s = new-pssession -computername Server01 C:\PS> invoke-command -session $s -filepath .\alias.ps1 Descrizione ----------- In questo esempio viene illustrato come utilizzare il formato file script generato da Export-Alias. Con il primo comando gli alias nella sessione vengono esportati nel file Alias.ps1. Viene utilizzato il parametro As con il valore Script per generare un file che contiene un comando Set-Alias per ciascun alias. Con il secondo comando gli alias nel file Alias.ps1 vengono aggiunti al profilo CurrentUser-CurrentHost. Il percorso del profilo viene salvato nella variabile $profile. Vengono utilizzati il cmdlet Get-Content per ottenere gli alias dal file Alias.ps1 e il cmdlet Add-Content per aggiungerli al profilo. Per ulteriori informazioni, vedere about_Profiles. Con il terzo e il quarto comando gli alias nel file Alias.ps1 vengono aggiunti a una sessione remota del computer Server01. Nel terzo comando viene utilizzato il cmdlet New-PSSession per creare la sessione, nel quarto comando viene utilizzato il parametro FilePath del cmdlet Invoke-Command per eseguire il file Alias.ps1 nella nuova sessione.
Vedere anche