powershellscripts.com

Tutorials  PowerShell Cmdlet Help for Export-Console



NAME
Export-Console

SYNOPSIS
Exports the names of snap-ins in the current session to a console file.

SYNTAX
Export-Console [[-Path] ] [-Force] [-NoClobber] [-Confirm] [-WhatIf] []


DESCRIPTION
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 comman
d line by using Cmd.exe or another Windows PowerShell session, and then use the PSConsoleFile parameter of Powershe
ll.exe to specify the console file.

For more information about Windows PowerShell snap-ins, see about_PSSnapins.


PARAMETERS
-Force []
Overwrites the data in a console file without warning, even if the file has the read-only attribute. The read-o
nly attribute is changed and is not reset when the command completes.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-NoClobber []
Will not overwrite (replace the contents of) an existing console file. By default, if a file exists in the spec
ified path, Export-Console overwrites the file without warning.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Path
Specifies a path and file name for the console file (*.psc1). Enter a path (optional) and name. Wildcards are n
ot permitted.

If you type only a file name, Export-Console creates a file with that name and the ".psc1" file name extension
in the current directory.

This parameter is required unless you have opened Windows PowerShell with the PSConsoleFile parameter or export
ed a console file during the current session. It is also required when you use the NoClobber parameter to preve
nt the current console file from being overwritten.

If you omit this parameter, Export-Console overwrites (replaces the content of) the console file that was used
most recently in this session. The path to the most recently used console file is stored in the value of the $C
onsoleFileName automatic variable. For more information, see about_Automatic_Variables.

Required? false
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false

-Confirm []
Prompts you for confirmation before executing the command.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-WhatIf []
Describes what would happen if you executed the command without actually executing the command.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false


This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

INPUTS
System.String
You can pipe a path string to Export-Console.


OUTPUTS
System.IO.FileInfo
Export-Console creates a file that contains the exported aliases.


NOTES


When a console file (.psc1) is used to start the session, the name of the console file is automatically stored
in the $ConsoleFileName automatic variable. The value of $ConsoleFileName is updated when you use the Path par
ameter of Export-Console to specify a new console file. When no console file is used, $ConsoleFileName has no v
alue ($null).

To use a Windows PowerShell console file in a new session, use the following syntax to start Windows PowerShell
:
"powershell.exe -PsConsoleFile .psc1".

You can also save Windows PowerShell snap-ins for future sessions by adding an Add-PSSnapin command to your Win
dows PowerShell profile. For more information, see about_Profiles.


-------------------------- 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 the 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 consol
e 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 P
owerShell snap-ins in the current session to a console file, and then start a Windows PowerShell session with the c
onsole 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-ins 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 include
s the Windows PowerShell snap-in name, the cmdlets and providers in the snap-in are available in the current sessio
n.





-------------------------- EXAMPLE 4 --------------------------

C:\PS>export-console -path Console01

C:\PS> notepad console01.psc1



2.0






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 up
dated if you use Export-Console 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 sessi
on.

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 o
utput shows that NewConsole.ps1 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 in the current session to the most recently used file, NewConsole.psc1.






RELATED LINKS
Online version: http://go.microsoft.com/fwlink/?LinkID=113298
Add-PSSnapin
Get-PSSnapin
Remove-PSSnapin