Esporta i nomi degli snap-in della sessione corrente in un file della console.
Sintassi
Export-Console [[-Path] <string>] [-Force] [-NoClobber] [-Confirm] [-WhatIf] [<CommonParameters>]
Descrizione
Il cmdlet Export-Console esporta i nomi degli snap-in di Windows PowerShell della sessione corrente in un file della console di Windows PowerShell (estensione psc1). È possibile utilizzare questo cmdlet per salvare gli snap-in per l'utilizzo in sessioni future.
Per aggiungere gli snap-in del file della console psc1 a una sessione, avviare Windows PowerShell (Powershell.exe) nella riga di comando, ad esempio tramite Cmd.exe o un'altra sessione di Windows PowerShell, quindi utilizzare il parametro PSConsoleFile di Powershell.exe per specificare il file della console.
Per ulteriori informazioni sugli snap-in di Windows PowerShell, vedere about_Pssnapins.
Parametri
-Force
Sovrascrive i dati in un file della console senza che venga visualizzato alcun avviso, anche se il file è di sola lettura. L'attributo di sola lettura viene modificato e non verrà reimpostato al termine dell'esecuzione del comando.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-NoClobber
Non sovrascrive, ovvero sostituisce, il contenuto di un file della console esistente. Per impostazione predefinita, se nel percorso specificato è presente un file, Export-Console lo sovrascrive senza visualizzare alcun avviso.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Path <string>
Specifica un percorso e un nome file per il file della console (*.psc1). Immettere un percorso (facoltativo) e un nome. Non è consentito l'utilizzo di caratteri jolly.
Se si digita solo un nome file, tramite Export-Console verrà creato un file con il nome specificato e l'estensione psc1 nella directory corrente.
Questo parametro è obbligatorio a meno che Windows PowerShell non sia stato aperto con il parametro PSConsoleFile o non sia stato esportato un file della console durante la sessione corrente. Il parametro è inoltre obbligatorio quando si utilizza il parametro NoClobber per impedire che il file della console corrente venga sovrascritto.
Se questo parametro viene omesso, Export-Console sovrascrive, ovvero sostituisce, il contenuto del file della console utilizzato più di recente nella sessione. Il percorso al file della console utilizzato più di recente viene archiviato nel valore della variabile automatica $ConsoleFileName. Per ulteriori informazioni, vedere about_Automatic_Variables.
|
Obbligatorio? |
false |
|
Posizione? |
1 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByValue, ByPropertyName) |
|
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 |
System.String È possibile reindirizzare una stringa di percorso a Export-Console. |
|
Output |
System.IO.FileInfo Export-Console crea un file che contiene gli alias esportati. |
Note
Quando un file della console (.psc1) viene utilizzato per avviare la sessione, il nome di questo file viene automaticamente archiviato nella variabile automatica $ConsoleFileName. Il valore di $ConsoleFileName viene aggiornato quando si utilizza il parametro Path di Export-Console per specificare un nuovo file della console. Quando non si utilizza alcun file della console, $ConsoleFileName non dispone di nessun valore ($null).
Per utilizzare un file della console di Windows PowerShell in una nuova sessione, immettere la sintassi seguente per avviare Windows PowerShell:
"powershell.exe -PsConsoleFile <FileConsole>.psc1".
È inoltre possibile salvare gli snap-in di Windows PowerShell per sessioni future aggiungendo un comando Add-PSSnapin al profilo di Windows PowerShell. Per ulteriori informazioni, vedere about_Profiles.
Esempio 1
C:\PS>export-console -path $pshome\Consoles\ConsoleS1.psc1 Descrizione ----------- Tramite questo comando vengono esportati i nomi degli snap-in di Windows PowerShell della sessione corrente nel file ConsoleS1.psc1 nella sottodirectory Consoles della directory di installazione di Windows PowerShell, $pshome.
Esempio 2
C:\PS>export-console Descrizione ----------- Tramite questo comando vengono esportati i nomi degli snap-in di Windows PowerShell dalla sessione corrente nel file della console di Windows PowerShell utilizzato più di recente nella sessione corrente. Il contenuto del file precedente viene sovrascritto. Se durante la sessione corrente non è stato esportato un file della console, viene richiesta l'autorizzazione per continuare, quindi viene chiesto di immettere un nome file.
Esempio 3
C:\PS>add-pssnapin NewPSSnapin C:\PS> export-console -path NewPSSnapinConsole.psc1 C:\PS> powershell.exe -PsConsoleFile NewPsSnapinConsole.psc1 Descrizione ----------- Tramite questi comandi viene aggiunto alla sessione corrente lo snap-in NewPSSnapin di Windows PowerShell, vengono esportati i nomi degli snap-in di Windows PowerShell della sessione corrente in un file della console, quindi viene avviata una sessione di Windows PowerShell con il file della console. Con il primo comando viene utilizzato il cmdlet Add-PSSnapin per aggiungere lo snap-in NewPSSnapin alla sessione corrente. È possibile aggiungere solo snap-in di Windows PowerShell registrati nel sistema. Con il secondo comando vengono esportati i nomi degli snap-in di Windows PowerShell nel file NewPSSnapinConsole.psc1. Con il terzo comando viene avviato Windows PowerShell con il file NewPSSnapinConsole.psc1. Poiché il file della console include il nome dello snap-in di Windows PowerShell, i cmdlet e i provider negli snap-in sono disponibili nella sessione corrente.
Esempio 4
C:\PS>export-console -path Console01
C:\PS> notepad console01.psc1
<?xml version="1.0" encoding="utf-8"?>
<PSConsoleFile ConsoleSchemaVersion="1.0">
<PSVersion>2.0</PSVersion>
<PSSnapIns>
<PSSnapIn Name="NewPSSnapin" />
</PSSnapIns>
</PSConsoleFile>
Descrizione
-----------
Tramite questo comando vengono esportati i nomi degli snap-in di Windows PowerShell della sessione corrente nel file Console01.psc1 della directory corrente.
Con il secondo comando viene visualizzato il contenuto del file Console01.psc1 in Blocco note.
Esempio 5
C:\PS>powershell.exe -PSConsoleFile Console01.psc1 C:\PS> add-pssnapin MySnapin C:\PS> export-console NewConsole.psc1 C:\PS> $consolefilename C:\PS> add-pssnapin SnapIn03 C:\PS> export-console Descrizione ----------- In questo esempio viene illustrato come utilizzare la variabile automatica $ConsoleFileName per determinare il file della console che verrà aggiornato se si utilizza Export-Console senza un valore del parametro Path. Nel primo comando viene utilizzato il parametro PSConsoleFile di PowerShell.exe per aprire Windows PowerShell con il file Console01.psc1. Nel secondo comando viene utilizzato il cmdlet Add-PSSnapin per aggiungere lo snap-in MySnapin di Windows PowerShell alla sessione corrente. Nel terzo comando viene utilizzato il cmdlet Export-Console per esportare i nomi di tutti gli snap-in di Windows PowerShell della sessione nel file NewConsole.psc1. Nel quarto comando viene utilizzato il parametro $ConsoleFileName per visualizzare il file della console utilizzato più recentemente. L'output di esempio indica che NewConsole.ps1 è il file utilizzato più recentemente. Con il quinto viene aggiunto SnapIn03 alla console corrente. Nel sesto comando viene utilizzato il cmdlet ExportConsole senza un parametro Path. Tramite questo comando vengono esportati i nomi di tutti gli snap-in di Windows PowerShell della sessione corrente nel file utilizzato più di recente, NewConsole01.psc1.
Vedere anche