Export-Console
Esporta i nomi degli snap-in presenti nella sessione corrente in un file di console.
Sintassi
Export-Console
[[-Path] <String>]
[-Force]
[-NoClobber]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Descrizione
Il Export-Console cmdlet esporta i nomi degli snap-in di Windows PowerShell nella sessione corrente in un file della console di Windows PowerShell (con estensione psc1). È possibile usare questo cmdlet per salvare gli snap-in per l'uso in sessioni future.
Per aggiungere gli snap-in nel file della console psc1 a una sessione, avviare Windows PowerShell (PowerShell.exe) dalla riga di comando usando Cmd.exe o un'altra sessione di Windows PowerShell e quindi usare il parametro PSConsoleFile di PowerShell.exe per specificare il file della console.
Per altre informazioni sugli snap-in di Windows PowerShell, vedere about_PSSnapins.
Esempio
Esempio 1: Esportare i nomi degli snap-in nella sessione corrente
PS C:\> Export-Console -Path $pshome\Consoles\ConsoleS1.psc1Questo comando esporta i nomi degli snap-in di Windows PowerShell nella sessione corrente nel ConsoleS1.psc1 file nella cartella Console della cartella di installazione di Windows PowerShell, $pshome.
Esempio 2: Esportare i nomi degli snap-in nel file della console più recente
Export-ConsoleQuesto comando esporta i nomi degli snap-in di Windows PowerShell dalla sessione corrente nel file della console di Windows PowerShell usato più recentemente nella sessione corrente. Sovrascrive il contenuto del file precedente.
Se non è stato esportato un file di console durante la sessione corrente, viene richiesto se continuare, quindi viene richiesto un nome file.
Esempio 3: Aggiungere uno snap-in ed esportare i nomi degli snap-in
Add-PSSnapin NewPSSnapin
Export-Console -path NewPSSnapinConsole.psc1
powershell.exe -PsConsoleFile NewPsSnapinConsole.psc1Questi comandi aggiungono lo snap-in NewPSSnapin di Windows PowerShell alla sessione corrente, esportano i nomi degli snap-in di Windows PowerShell nella sessione corrente in un file della console e quindi avviano una sessione di Windows PowerShell con il file della console.
Il primo comando usa il Add-PSSnapin cmdlet per aggiungere lo snap-in NewPSSnapin alla sessione corrente. È possibile aggiungere solo snap-in di Windows PowerShell che sono registrati nel sistema.
Il secondo comando esporta i nomi degli snap-in di Windows PowerShell nel NewPSSnapinConsole.psc1 file.
Il terzo comando avvia Windows PowerShell con il NewPSSnapinConsole.psc1 file . Poiché il file di console include il nome dello snap-in di Windows PowerShell, i cmdlet e i provider nello snap-in sono disponibili nella sessione corrente.
Esempio 4: Esportare i nomi degli snap-in in in una posizione specificata
PS C:\> export-console -path Console01
PS C:\> notepad console01.psc1
<?xml version="1.0" encoding="utf-8"?>
<PSConsoleFile ConsoleSchemaVersion="1.0">
<PSVersion>2.0</PSVersion>
<PSSnapIns>
<PSSnapIn Name="NewPSSnapin" />
</PSSnapIns>
</PSConsoleFile>Questo comando esporta i nomi degli snap-in di Windows PowerShell nella sessione corrente nel Console01.psc1 file nella directory corrente.
Il secondo comando visualizza il contenuto del Console01.psc1 file nel Blocco note.
Esempio 5: Determinare il file della console da aggiornare
powershell.exe -PSConsoleFile Console01.psc1
Add-PSSnapin MySnapin
Export-Console NewConsole.psc1
$ConsoleFileName
Add-PSSnapin SnapIn03
Export-ConsoleIn questo esempio viene illustrato come usare la $ConsoleFileName variabile automatica per determinare il file della console che verrà aggiornato se si usa Export-Console senza un valore di parametro Path .
Il primo comando usa il parametro PSConsoleFile di PowerShell.exe per aprire Windows PowerShell con il Console01.psc1 file.
Il secondo comando usa il Add-PSSnapin cmdlet per aggiungere lo snap-in MySnapin di Windows PowerShell alla sessione corrente.
Il terzo comando usa il Export-Console cmdlet per esportare i nomi di tutti gli snap-in di Windows PowerShell nella sessione nel NewConsole.psc1 file.
Il quarto comando visualizza la $ConsoleFileName variabile. Contiene il file della console usato più di recente. L'output di esempio mostra che NewConsole.ps1 è il file usato più di recente.
Il quinto comando aggiunge SnapIn03 alla console corrente.
Il sesto comando usa il Export-Console cmdlet senza un parametro Path . Questo comando esporta i nomi di tutti gli snap-in di Windows PowerShell nella sessione corrente nel file usato più di recente, NewConsole.psc1.
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
Indica che questo cmdlet sovrascrive i dati in un file della console senza avvisi, anche se il file ha l'attributo di sola lettura. L'attributo di sola lettura viene modificato e non viene reimpostato al termine del comando.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-NoClobber
Indica che questo cmdlet non sovrascrive un file della console esistente. Per impostazione predefinita, se si verifica un file nel percorso specificato, Export-Console sovrascrive il file senza avviso.
| Tipo: | SwitchParameter |
| Alias: | NoOverwrite |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Path
Specifica un percorso e un nome di file per il file della console (*.psc1). Immettere un percorso e un nome facoltativi.
I caratteri jolly non sono consentiti.
Se si specifica solo un nome di file, Export-Console crea un file con tale nome e l'estensione di file psc1 nella directory corrente.
Questo parametro è obbligatorio, a meno che non sia stato aperto Windows PowerShell con il parametro PSConsoleFile o esportato un file della console durante la sessione corrente. È inoltre necessario quando si usa il parametro NoClobber per impedire che il file della console corrente venga sovrascritto.
Se si omette questo parametro, Export-Console sovrascrive il file della console usato più di recente in questa sessione. Il percorso del file della console usato più di recente viene archiviato nel valore della variabile automatica $ConsoleFileName. Per altre informazioni, vedere about_Automatic_Variables.
| Tipo: | String |
| Alias: | PSPath |
| Posizione: | 0 |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | True |
| 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
È possibile inviare tramite pipe una stringa di percorso a questo cmdlet.
Output
Questo cmdlet crea un file contenente gli alias esportati.
Note
Quando si usa un file della console (
.psc1) per avviare la sessione, il nome del file della console viene archiviato automaticamente nella$ConsoleFileNamevariabile automatica. Il valore di$ConsoleFileNameviene aggiornato quando si usa il parametro Path diExport-Consoleper specificare un nuovo file della console. Quando non viene usato alcun file della console, $ConsoleFileName non ha alcun valore ($null).Per usare un file di console di Windows PowerShell in una nuova sessione, usare la sintassi seguente per avviare Windows PowerShell:
powershell.exe -PsConsoleFile \<ConsoleFile\>.psc1È anche possibile salvare gli snap-in di Windows PowerShell per sessioni future mediante l'aggiunta di un comando Add-PSSnapin al profilo di Windows PowerShell. Per altre informazioni, vedere about_Profiles.
