Get-Help

語法

Get-Help
   [[-Name] <String>]
   [-Path <String>]
   [-Category <String[]>]
   [-Component <String[]>]
   [-Functionality <String[]>]
   [-Role <String[]>]
   [-Full]
   [<CommonParameters>]

Get-Help
   [[-Name] <String>]
   [-Path <String>]
   [-Category <String[]>]
   [-Component <String[]>]
   [-Functionality <String[]>]
   [-Role <String[]>]
   -Detailed
   [<CommonParameters>]

Get-Help
   [[-Name] <String>]
   [-Path <String>]
   [-Category <String[]>]
   [-Component <String[]>]
   [-Functionality <String[]>]
   [-Role <String[]>]
   -Examples
   [<CommonParameters>]

Get-Help
   [[-Name] <String>]
   [-Path <String>]
   [-Category <String[]>]
   [-Component <String[]>]
   [-Functionality <String[]>]
   [-Role <String[]>]
   -Parameter <String>
   [<CommonParameters>]

Get-Help
   [[-Name] <String>]
   [-Path <String>]
   [-Category <String[]>]
   [-Component <String[]>]
   [-Functionality <String[]>]
   [-Role <String[]>]
   -Online
   [<CommonParameters>]

Get-Help
   [[-Name] <String>]
   [-Path <String>]
   [-Category <String[]>]
   [-Component <String[]>]
   [-Functionality <String[]>]
   [-Role <String[]>]
   -ShowWindow
   [<CommonParameters>]

Description

Cmdlet Get-Help 會顯示 PowerShell 概念和命令的相關信息，包括 Cmdlet、函式、Common Information Model （CIM） 命令、工作流程、提供者、別名和腳本。

若要取得PowerShell Cmdlet 的說明，請輸入 Get-Help ，後面接著 Cmdlet 名稱，例如： Get-Help Get-Process。

PowerShell 中的概念說明文章從 about_開始，例如 about_Comparison_Operators。 若要檢視所有 about_ 文章，請輸入 Get-Help about_*。 若要檢視特定文章，請輸入 Get-Help about_<article-name>，例如 Get-Help about_Comparison_Operators。

若要取得 PowerShell 提供者的說明，請輸入 Get-Help 後面接著提供者名稱。 例如，若要取得憑證提供者的說明，請輸入 Get-Help Certificate。

您也可以輸入 help 或 man，一次顯示一個文字畫面。 或者，這與 Get-Help相同，<cmdlet-name> -?但只適用於 Cmdlet。

Get-Help 會從電腦上的說明檔取得其顯示的說明內容。 如果沒有說明檔， Get-Help 則只會顯示 Cmdlet 的基本資訊。 某些 PowerShell 模組包含說明檔。 從 PowerShell 3.0 開始，Windows 作業系統隨附的模組不包含說明檔。 若要在PowerShell 3.0 中下載或更新模組的說明檔，請使用 Update-Help Cmdlet。

您也可以線上檢視 PowerShell 說明檔。 若要取得說明檔的在線版本，請使用 Online 參數，例如： Get-Help Get-Process -Online。

如果您輸入 Get-Help 後面接著說明文章的確切名稱，或說明文章唯一的字組， Get-Help 則會顯示文章的內容。 如果您指定命令別名的確切名稱， Get-Help 則會顯示原始命令的說明。 如果您輸入出現在數個說明文章標題中的單字或單字模式， Get-Help 則會顯示相符標題的清單。 如果您輸入任何未出現在任何說明文章標題中的文字， Get-Help 則會顯示包含其內容中該文字的文章清單。

Get-Help 可取得所有支援語言和地區設定的說明文章。 Get-Help先尋找 Windows 地區設定中的說明檔，然後在父地區設定中尋找 pt-BR，然後在後援地區設定中尋找 pt。 從 PowerShell 3.0 開始，如果在 Get-Help 後援地區設定中找不到說明，則會先尋找英文、 en-US 的說明文章，再傳回錯誤訊息或顯示自動產生的說明。

如需命令語法圖表中顯示的符號 Get-Help 相關信息，請參閱 about_Command_Syntax。 如需參數屬性的相關信息，例如 必要 和 位置，請參閱 about_Parameters。

從 PSReadLine v2.2.2 開始，模組隨附兩個函式，可讓您在命令行上輸入命令時快速存取協助。 說明會顯示在具有分頁的替代畫面緩衝區的終端機中。

當您叫用 F1 鍵時，PSReadLine ShowCommandHelp 函式會叫用Get-Help -Full最接近游標左邊的 Cmdlet 名稱。 當游標緊接在參數左邊時，函式會跳至完整說明主題中的該參數描述。 當您按 Q 結束說明檢視時，您會回到相同游標位置的命令行，以便繼續輸入命令。

當您使用按鍵組合 Alt+h 時， PSReadLine ShowParameterHelp 函式會立即在游標左邊顯示參數的說明資訊。 說明文字會顯示在命令行下方。 這可讓您查看 參數的描述，並繼續輸入命令。

如需詳細資訊，請參閱 使用動態說明。

範例

範例 1：顯示 Cmdlet 的基本說明資訊

這些範例會顯示 Cmdlet Format-Table 的基本說明資訊。

Get-Help Format-Table
Get-Help -Name Format-Table
Format-Table -?

Get-Help <cmdlet-name> 是 Cmdlet 最簡單的預設語法 Get-Help 。 您可以省略 Name 參數。

語法 <cmdlet-name> -? 僅適用於 Cmdlet。

範例 2：一次顯示一頁的基本資訊

這些範例一次顯示一頁 Cmdlet 的基本說明資訊 Format-Table 。

help Format-Table
man Format-Table
Get-Help Format-Table | Out-Host -Paging

help 是內部執行 Get-Help Cmdlet 並一次顯示結果一頁的函式。

man 是函式的 help 別名。

Get-Help Format-Table 會將物件向下傳送至管線。 Out-Host -Paging 接收管線的輸出，並一次顯示一頁。 如需詳細資訊，請參閱 Out-Host。

範例 3：顯示 Cmdlet 的詳細資訊

這些範例會顯示 Cmdlet 的 Format-Table 更詳細說明資訊。

Get-Help Format-Table -Detailed
Get-Help Format-Table -Full

Detailed 參數會顯示說明文章的詳細檢視，其中包含參數描述和範例。

Full 參數會顯示說明文章的完整檢視，其中包含參數描述、範例、輸入和輸出物件類型，以及其他附註。

[詳細] 和 [完整] 參數僅適用於計算機上已安裝說明檔的命令。 參數對概念性（about_）說明文章無效。

範例 4：使用參數顯示 Cmdlet 的選取部分

這些範例會顯示 Cmdlet 說明的 Format-Table 選取部分。

Get-Help Format-Table -Examples
Get-Help Format-Table -Parameter *
Get-Help Format-Table -Parameter GroupBy

Examples 參數會顯示說明檔的 NAME 和 SYNOPSIS 區段，以及所有範例。 您無法指定 Example 編號，因為 Examples 參數是 switch 參數。

Parameter 參數只會顯示指定參數的描述。 如果您只指定星號 （*） 通配符，則會顯示所有參數的描述。 當 Parameter 指定如 GroupBy 的參數名稱時，會顯示該參數的相關信息。

這些參數對概念性（about_）說明文章無效。

範例 5：顯示在線版本的說明

本範例會顯示預設網頁瀏覽器中 Cmdlet 說明文章 Format-Table 的在線版本。

Get-Help Format-Table -Online

範例 6：顯示說明系統的說明

不含參數的 Get-Help Cmdlet 會顯示 PowerShell 說明系統的相關信息。

Get-Help

範例 7：顯示可用的說明文章

此範例會顯示計算機上所有可用的說明文章清單。

Get-Help *

範例 8：顯示概念性文章的清單

此範例會顯示 PowerShell 說明中包含的概念性文章清單。 所有這些文章都是以字元 about_開頭。 若要顯示特定的說明檔，請輸入 Get-Help \<about_article-name\>， Get-Help about_Signing 例如 。

只會顯示電腦上已安裝說明檔的概念性文章。 如需在PowerShell 3.0 中下載及安裝說明檔的相關信息，請參閱 Update-Help。

Get-Help about_*

範例 9：在 Cmdlet 說明中搜尋單字

此範例示範如何在 Cmdlet 說明文章中搜尋單字。

Get-Help Add-Member -Full | Out-String -Stream | Select-String -Pattern Clixml

the Export-Clixml cmdlet to save the instance of the object, including the additional members...
can use the Import-Clixml cmdlet to re-create the instance of the object from the information...
Export-Clixml
Import-Clixml

Get-Help 會 使用 Full 參數來取得 的說明 Add-Member資訊。 MamlCommandHelpInfo 物件會在管線下傳送。 Out-String會使用 Stream 參數將對象轉換成字串。 Select-String會使用 Pattern 參數來搜尋 Clixml 的字串。

範例 10：顯示包含單字的文章清單

此範例會顯示包含遠端一詞的文章清單。

當您輸入未出現在任何文章標題中的單字時， Get-Help 會顯示包含該單字的文章清單。

Get-Help -Name remoting

Name                              Category  Module                    Synopsis
----                              --------  ------                    --------
Install-PowerShellRemoting.ps1    External                            Install-PowerShellRemoting.ps1
Disable-PSRemoting                Cmdlet    Microsoft.PowerShell.Core Prevents remote users...
Enable-PSRemoting                 Cmdlet    Microsoft.PowerShell.Core Configures the computer...

範例 11：顯示提供者特定說明

此範例示範取得 提供者特定說明的 Get-Item兩種方式。 這些命令會取得說明如何在PowerShell SQL Server提供者的DataCollection節點中使用 Get-Item Cmdlet。

第一個範例會Get-Help使用Path參數來指定SQL Server提供者的路徑。 因為指定了提供者的路徑，因此您可以從任何路徑位置執行命令。

第二個範例會使用 Set-Location 巡覽至 SQL Server 提供者的路徑。 從該位置， 不需要Path 參數 Get-Help ，即可取得提供者特定的說明。

Get-Help Get-Item -Path SQLSERVER:\DataCollection

NAME

    Get-Item

SYNOPSIS

    Gets a collection of Server objects for the local computer and any computers

    to which you have made a SQL Server PowerShell connection.
    ...

Set-Location SQLSERVER:\DataCollection
SQLSERVER:\DataCollection> Get-Help Get-Item

NAME

    Get-Item

SYNOPSIS

    Gets a collection of Server objects for the local computer and any computers

    to which you have made a SQL Server PowerShell connection.
    ...

範例 12：顯示腳本的說明

此範例會取得的說明 MyScript.ps1 script。 如需如何為您的函式和腳本撰寫說明的資訊，請參閱 about_Comment_Based_Help。

Get-Help -Name C:\PS-Test\MyScript.ps1

參數

-Category

-Component

-Detailed

-Examples

-Full

-Functionality

-Name

-Online

-Parameter

-Path

-Role

-ShowWindow

輸入

None

您無法使用管線將物件傳送至此 Cmdlet。

輸出

ExtendedCmdletHelpInfo

如果您在沒有說明檔的命令上執行 Get-Help ， Get-Help 會 傳回代表自動產生說明的 ExtendedCmdletHelpInfo 物件。

String

如果您收到概念性說明文章，請 Get-Help 以字串的形式傳回它。

MamlCommandHelpInfo

如果您取得具有說明檔的命令， Get-Help 會 傳回 MamlCommandHelpInfo 物件。

備註

PowerShell 3.0 不包含說明檔。 若要下載並安裝讀取的說明檔 Get-Help ，請使用 Update-Help Cmdlet。 您可以使用 Update-Help Cmdlet 來下載並安裝 PowerShell 隨附之核心命令的說明檔，以及您安裝的任何模組。 您也可以使用它來更新說明檔，讓計算機上的說明永遠不會過期。

您也可以從開始使用 Windows PowerShell 開始閱讀 PowerShell 在線隨附命令的說明文章。

Get-Help 會在 Windows 作業系統的地區設定或該地區設定的後援語言中顯示說明。 如果您沒有主要或後援地區設定的說明檔， Get-Help 則行為就像計算機上沒有說明檔案一樣。 若要取得不同地區設定的說明，請使用 控制台 中的區域和語言來變更設定。 在 Windows 10 或更高版本上， [設定]、[ 時間與語言]。

說明的完整檢視包含參數相關信息的數據表。 資料表包含下列欄位：

• 必要。 指出參數是必要參數 （true） 還是選擇性的 （false）。

• 置放。 指出參數是否為具名或位置 （numeric）。 位置參數必須出現在命令中指定的位置。

• 具名 表示參數名稱是必要的，但參數可以出現在命令中的任何位置。

• Numeric 表示參數名稱是選擇性的，但省略名稱時，參數必須位於數位所指定的位置。 例如， 2 表示省略參數名稱時，參數必須是命令中的第二個或只有未命名的參數。 使用參數名稱時，參數可以出現在命令中的任何位置。

• 預設值。 如果您未在命令中包含 參數，PowerShell 所使用的參數值或預設行為。

• 接受管線輸入。 指出您是否可以 （true） 或無法 （false） 透過管線將物件傳送至參數。 依 [屬性名稱 ] 表示管線對象必須具有與參數名稱相同的屬性。

• 接受通配符。 指出參數的值是否可以包含通配符，例如星號 （*） 或問號 （?）。

相關連結

• about_Command_Syntax
• about_Comment_Based_Help
• Get-Command
• 支援可更新的說明
• Update-Help
• 撰寫以批注為基礎的說明主題
• 撰寫 PowerShell Cmdlet 的說明