Export-Console

  • Riferimento
Modulo:
Microsoft.PowerShell.Core

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.psc1

Questo 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-Console

Questo 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.psc1

Questi 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 in 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 $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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Aliases:NoOverwrite
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Aliases:PSPath
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Mostra gli effetti dell'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

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 $ConsoleFileName variabile automatica. 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 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.