Condividi tramite

Export-Console

  • Riferimento
Modulo:
Microsoft.PowerShell.Core

Esporta i nomi degli snap-in nella sessione corrente in un file della console.

Sintassi

Export-Console
      [[-Path] <String>]
      [-Force]
      [-NoClobber]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Il cmdlet Export-Console 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 da usare nelle 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.psc1

Questo comando esporta i nomi degli snap-in di Windows PowerShell nella sessione corrente nel file ConsoleS1.psc1 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-Console

Questo comando esporta i nomi degli snap-in di Windows PowerShell dalla sessione corrente al file della console di Windows PowerShell usato più di recente nella sessione corrente. Sovrascrive il contenuto del file precedente.

Se non è stato esportato un file della console durante la sessione corrente, viene richiesta l'autorizzazione per continuare e quindi viene richiesto di specificare 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.psc1

Questi comandi aggiungono il NewPSSnapin snap-in 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 cmdlet Add-PSSnapin per aggiungere lo snap-in NewPSSnapin alla sessione corrente. È possibile aggiungere solo snap-in di Windows PowerShell registrati nel sistema.

Il secondo comando esporta i nomi dello snap-in di Windows PowerShell nel file NewPSSnapinConsole.psc1.

Il terzo comando avvia 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 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 file Console01.psc1 nella directory corrente.

Il secondo comando visualizza il contenuto del file Console01.psc1 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-Console

In questo esempio viene illustrato come usare la variabile automatica $ConsoleFileName 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 file Console01.psc1.

Il secondo comando usa il cmdlet Add-PSSnapin per aggiungere lo snap-in MySnapin di Windows PowerShell alla sessione corrente.

Il terzo comando usa il cmdlet Export-Console per esportare i nomi di tutti gli snap-in di Windows PowerShell nella sessione nel file NewConsole.psc1.

Il quarto comando visualizza la variabile $ConsoleFileName. 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 cmdlet Export-Console 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 del nome 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 cosa accadrebbe se il cmdlet viene eseguito. 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

String

È possibile inviare tramite pipe una stringa di percorso a questo cmdlet.

Output

FileInfo

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 variabile automatica $ConsoleFileName. Il valore di $ConsoleFileName viene aggiornato quando si usa il parametro Path di Export-Console per specificare un nuovo file della console. Quando non viene usato alcun file della console, $ConsoleFileName non ha alcun valore ($null).

    Per usare un file della 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 le sessioni future aggiungendo un comando Add-PSSnapin al profilo di Windows PowerShell. Per altre informazioni, vedere about_Profiles.