Export-Console
將目前工作階段中的嵌入式管理單元名稱匯出到主控台檔案。
Syntax
Export-Console
[[-Path] <String>]
[-Force]
[-NoClobber]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
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自動變數來判斷如果您使用 Export-Console 而不使用 Path 參數值，將會更新的控制台檔案。
第一個命令會使用 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。