Export-Console
将当前会话中的管理单元的名称导出到控制台文件。
语法
Export-Console
[[-Path] <String>]
[-Force]
[-NoClobber]
[-WhatIf]
[-Confirm]
[<CommonParameters>]说明
Export-Console cmdlet 将当前会话中Windows PowerShell管理单元的名称导出到Windows PowerShell控制台文件 (.psc1) 。 可以使用此 cmdlet 来保存管理单元，以供在以后的会话中使用。
若要将 .psc1 控制台文件中的管理单元添加到会话，请使用 Cmd.exe 或其他Windows PowerShell会话在命令行中启动Windows PowerShell (Powershell.exe) ，然后使用 Powershell.exe 的 PSConsoleFile 参数指定控制台文件。
有关 Windows PowerShell 管理单元的详细信息，请参阅 about_PSSnapins。
示例
示例 1：导出当前会话中管理单元的名称
PS C:\> Export-Console -Path $pshome\Consoles\ConsoleS1.psc1此命令将当前会话中Windows PowerShell管理单元的名称导出到 Windows PowerShell 安装文件夹的 Consoles 文件夹中的 ConsoleS1.psc1 文件，$pshome。
示例 2：将管理单元的名称导出到最新的控制台文件
PS C:\> Export-Console此命令将当前会话中的 Windows PowerShell 管理单元的名称导出到最近在当前会话中使用的 Windows PowerShell 控制台文件中。 它会覆盖以前的文件内容。
如果你尚未在当前会话期间导出控制台文件，则系统将提示你需要相应权限才能继续操作，然后提示你输入文件名。
示例 3：添加管理单元并导出管理单元的名称
PS C:\> Add-PSSnapin NewPSSnapin
PS C:\> Export-Console -path NewPSSnapinConsole.psc1
PS C:\> powershell.exe -PsConsoleFile NewPsSnapinConsole.psc1这些命令将 NewPSSnapin Windows PowerShell 管理单元添加到当前会话中、将当前会话中的 Windows PowerShell 管理单元的名称导出到控制台文件中，然后使用该控制台文件启动 Windows PowerShell 会话。
第一个命令使用 Add-PSSnapin cmdlet 将 NewPSSnapin 管理单元添加到当前会话。 你可以仅添加已在你的系统上注册的 Windows PowerShell 管理单元。
第二个命令将 Windows PowerShell 管理单元名称导出到 NewPSSnapinConsole.psc1 文件中。
第三个命令使用 NewPSSnapinConsole.psc1 文件启动 Windows PowerShell。 因为该控制台文件包含 Windows PowerShell 管理单元名称，所以该管理单元中的 cmdlet 和提供程序在当前会话中可用。
示例 4：将管理单元的名称导出到指定位置
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>此命令会将当前会话中的 Windows PowerShell 管理单元的名称导出到当前目录下的 Console01.psc1 文件中。
第二个命令将在记事本中显示 Console01.psc1 文件的内容。
示例 5：确定要更新的控制台文件
PS C:\> powershell.exe -PSConsoleFile Console01.psc1
PS C:\> Add-PSSnapin MySnapin
PS C:\> Export-Console NewConsole.psc1
PS C:\> $ConsoleFileName
PS C:\> Add-PSSnapin SnapIn03
PS C:\> Export-Console此示例演示如何使用 $ConsoleFileName 自动变量来确定在不使用 Path 参数值的情况下使用 Export-Console 时将更新的控制台文件。
第一个命令使用 PowerShell.exe 的 PSConsoleFile 参数打开包含 Console01.psc1 文件的Windows PowerShell。
第二个命令使用 Add-PSSnapin cmdlet 将 MySnapin Windows PowerShell管理单元添加到当前会话。
第三个命令使用 Export-Console cmdlet 将会话中所有Windows PowerShell管理单元的名称导出到 NewConsole.psc1 文件。
第四个命令显示$ConsoleFileName变量。 它包含最近使用的控制台文件。 示例输出显示 NewConsole.ps1 是最近使用的文件。
第五个命令将 SnapIn03 添加到当前控制台中。
第六个命令使用不带 Path 参数的 Export-Console cmdlet。 此命令会将当前会话中的所有 Windows PowerShell 管理单元的名称导出到最近使用的文件 NewConsole.psc1 中。
参数
-Confirm
提示你在运行 cmdlet 之前进行确认。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
指示此 cmdlet 在不发出警告的情况下覆盖控制台文件中的数据，即使该文件具有只读属性也是如此。 只读属性将更改，且在命令完成后不会重置。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NoClobber
指示此 cmdlet 不会覆盖现有的控制台文件。 默认情况下，如果文件出现在指定路径中， 则 Export-Console 将覆盖该文件而不发出警告。
| Type: | SwitchParameter |
| Aliases: | NoOverwrite |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
指定控制台文件 (*.psc1） 的路径和文件名。 输入可选的路径和名称。 不允许使用通配符。
如果仅指定文件名， Export-Console 将在当前目录中创建具有该名称和 .psc1 文件扩展名的文件。
除非已使用 PSConsoleFile 参数打开Windows PowerShell或在当前会话期间导出了控制台文件，否则此参数是必需的。 使用 NoClobber 参数防止当前控制台文件被覆盖时，也需要它。
如果省略此参数， Export-Console 将覆盖此会话中最近使用的控制台文件。 最近使用的控制台文件的路径存储在 $ConsoleFileName 自动变量的值中。 有关详细信息，请参阅 about_Automatic_Variables。
| Type: | String |
| Aliases: | PSPath |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
显示运行该 cmdlet 时会发生什么情况。 此 cmdlet 未运行。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
输入
可以通过管道将路径字符串传递给此 cmdlet。
输出
此 cmdlet 创建一个包含导出别名的文件。
备注
当控制台文件 (.psc1) 用于启动会话时，该控制台文件的名称会自动存储在 $ConsoleFileName 自动变量中。 使用 Export-Console 的 Path 参数指定新的控制台文件时，将更新 $ConsoleFileName 的值。 如果未使用控制台文件时，$ConsoleFileName没有值 ($Null) 。
若要在新会话中使用 Windows PowerShell 控制台文件，请使用以下语法来启动 Windows PowerShell：
powershell.exe -PsConsoleFile \<ConsoleFile\>.psc1还可以通过将 Add-PSSnapin 命令添加到你的 Windows PowerShell 配置文件中，来保存 Windows PowerShell 管理单元，以供以后的会话使用。 有关详细信息，请参阅 about_Profiles。