This is the built-in help made by Microsoft for the command 'Export-Console', in PowerShell version 2 - as retrieved from
Windows version 'Microsoft® Windows Vista™ Ultimate ' PowerShell help files on 2016-06-23.
For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.
Exports the names of snap-ins in the current session to a console file.
Export-Console [[-Path] <string>] [-Force] [-NoClobber] [-Confirm] [-WhatIf] [<CommonParameters>]
The Export-Console cmdlet exports the names of the Windows PowerShell snap-ins in the current session to a Windows PowerShell console file (.psc1
). You can use this cmdlet to save the snap-ins for use in future sessions.
To add the snap-ins in the .psc1 console file to a session, start Windows PowerShell (Powershell.exe) at the command line by using Cmd.exe or ano
ther Windows PowerShell session, and then use the PSConsoleFile parameter of Powershell.exe to specify the console file.
For more information about Windows PowerShell snap-ins, see about_PSSnapins.
<
Online version: http://go.microsoft.com/fwlink/?LinkID=113298
Add-PSSnapin
Get-PSSnapin
Remove-PSSnapin
<
-------------------------- EXAMPLE 1 --------------------------
C:\PS>export-console -path $pshome\Consoles\ConsoleS1.psc1
Description
-----------
This command exports the names of Windows PowerShell snap-ins in the current session to the ConsoleS1.psc1 file in the Consoles subdirectory of t
he Windows PowerShell installation directory, $pshome.
-------------------------- EXAMPLE 2 --------------------------
C:\PS>export-console
Description
-----------
This command exports the names of Windows PowerShell snap-ins from current session to the Windows PowerShell console file that was most recently
used in the current session. It overwrites the previous file contents.
If you have not exported a console file during the current session, you are prompted for permission to continue and then prompted for a file name
.
-------------------------- EXAMPLE 3 --------------------------
C:\PS>add-pssnapin NewPSSnapin
C:\PS> export-console -path NewPSSnapinConsole.psc1
C:\PS> powershell.exe -PsConsoleFile NewPsSnapinConsole.psc1
Description
-----------
These commands add the NewPSSnapin Windows PowerShell snap-in to the current session, export the names of Windows PowerShell snap-ins in the curr
ent session to a console file, and then start a Windows PowerShell session with the console file.
The first command uses the Add-PSSnapin cmdlet to add the NewPSSnapin snap-in to the current session. You can only add Windows PowerShell snap-in
s that are registered on your system.
The second command exports the Windows PowerShell snap-in names to the NewPSSnapinConsole.psc1 file.
The third command starts Windows PowerShell with the NewPSSnapinConsole.psc1 file. Because the console file includes the Windows PowerShell snap-
in name, the cmdlets and providers in the snap-in are available in the current session.
-------------------------- EXAMPLE 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>
Description
-----------
This command exports the names of the Windows PowerShell snap-ins in the current session to the Console01.psc1 file in the current directory.
The second command displays the contents of the Console01.psc1 file in Notepad.
-------------------------- EXAMPLE 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
Description
-----------
This example shows how to use the $ConsoleFileName automatic variable to determine the console file that will be updated if you use Export-Consol
e without a Path parameter value.
The first command uses the PSConsoleFile parameter of PowerShell.exe to open Windows PowerShell with the Console01.psc1 file.
The second command uses the Add-PSSnapin cmdlet to add the MySnapin Windows PowerShell snap-in to the current session.
The third command uses the Export-Console cmdlet to export the names of all the Windows PowerShell snap-ins in the session to the NewConsole.psc1
file.
The fourth command uses the $ConsoleFileName parameter to display the most recently used console file. The sample output shows that NewConsole.ps
1 is the most recently used file.
The fifth command adds SnapIn03 to the current console.
The sixth command uses the ExportConsole cmdlet without a Path parameter. This command exports the names of all the Windows PowerShell snap-ins i
n the current session to the most recently used file, NewConsole.psc1.