將目前工作階段中嵌入式管理單元的名稱匯出至主控台檔案。

語法

Export-Console [[-路徑] <string>] [-Force] [-NoClobber] [-Confirm] [-WhatIf] [<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。

參數

-Force

覆寫主控台檔案的資料而不顯示警告,即使檔案具有唯讀屬性也一樣。唯讀屬性將被變更,且命令完成後不會重設。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-NoClobber

不會覆寫 (取代) 現有主控台檔案的內容。根據預設,如果有檔案現存於指定的路徑,Export-Console 將覆寫該檔案而不顯示警告。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-路徑 <string>

指定主控台檔案 (*.psc1) 的路徑和檔名。輸入路徑 (選擇性) 和名稱。不允許使用萬用字元。

如果只輸入檔名,Export-Console 會在目前目錄中建立具有該名稱和 ".psc1" 副檔名的檔案。

除非您在目前工作階段期間曾經以 PSConsoleFile 參數開啟 Windows PowerShell 或匯出主控台檔案,否則一定要指定此參數。若您使用 NoClobber 參數防止覆寫目前的主控台檔案,也必須指定此參數。

如果省略此參數,Export-Console 會覆寫目前工作階段中最近使用的主控台檔案 (取代檔案內容)。最近所使用之主控台檔案的路徑係儲存在 $ConsoleFileName 自動變數的值中。如需詳細資訊,請參閱 about_Automatic_Variables。

必要?

false

位置?

1

預設值

接受管線輸入?

true (ByValue, ByPropertyName)

接受萬用字元?

false

-Confirm

在執行命令前先提示確認。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

-WhatIf

說明執行命令時將會發生何種情況,但不會實際執行命令。

必要?

false

位置?

named

預設值

接受管線輸入?

false

接受萬用字元?

false

<CommonParameters>

這個 Cmdlet 支援一般參數:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊,請參閱 about_Commonparameters.

輸入和輸出

輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。

輸入

System.String

您可以經由管道將路徑字串輸出至 Export-Console。

輸出

System.IO.FileInfo

Export-Console 會建立包含匯出別名的檔案。

附註

使用主控台檔案 (.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。

範例 1

C:\PS>export-console -path $pshome\Consoles\ConsoleS1.psc1

描述
-----------
這個命令會將目前工作階段中 Windows PowerShell 嵌入式管理單元的名稱匯出至 Windows PowerShell 安裝目錄 $pshome 之 Consoles 子目錄中的 ConsoleS1.psc1 檔案。






範例 2

C:\PS>export-console

描述
-----------
這個命令會從目前的工作階段,將 Windows PowerShell 嵌入式管理單元的名稱匯出至目前工作階段中最近所使用的 Windows PowerShell 主控台檔案。它會覆寫先前的檔案內容。

如果您未在目前工作階段期間匯出主控台檔案,便會出現提示,要求您提供權限才能繼續執行,並接著提示您提供檔名。






範例 3

C:\PS>add-pssnapin NewPSSnapin

C:\PS> export-console -path NewPSSnapinConsole.psc1

C:\PS> 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

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>

描述
-----------
這個命令會將目前工作階段中 Windows PowerShell 嵌入式管理單元的名稱匯出至目前目錄中的 Console01.psc1 檔案。

第二個命令會在 [記事本] 中顯示 Console01.psc1 檔案的內容。






範例 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

描述
-----------
在這個範例中,會示範如何利用 $ConsoleFileName 自動變數,在您使用 Export-Console 但未指定 Path 參數值時,決定將會更新的主控台檔案。

第一個命令會使用 PowerShell.exe 的 PSConsoleFile 參數,開啟 Windows PowerShell 及 Console01.psc1 檔案。

第二個命令會使用 Add-PSSnapin Cmdlet 將 MySnapin Windows PowerShell 嵌入式管理單元新增至目前工作階段。

第三個命令會使用 Export-Console Cmdlet 將工作階段中所有 Windows PowerShell 嵌入式管理單元的名稱匯出至 NewConsole.psc1 檔案。

第四個命令會使用 $ConsoleFileName 參數,顯示最近使用的主控台檔案。範例輸出顯示 NewConsole.ps1 是最近使用的檔案。

第五個命令會將 SnapIn03 新增至目前主控台。

第六個命令會使用 ExportConsole Cmdlet 但不指定 Path 參數,將目前工作階段中所有 Windows PowerShell 嵌入式管理單元的名稱匯出至最近使用的檔案 NewConsole.psc1。






請參閱




目錄