Get-Help
顯示 PowerShell 命令和概念的相關信息。
語法
Get-Help
[[-Name] <String>]
[-Path <String>]
[-Category <String[]>]
[-Component <String[]>]
[-Functionality <String[]>]
[-Role <String[]>]
[-Full]
[<CommonParameters>]Get-Help
[[-Name] <String>]
-Detailed
[-Path <String>]
[-Category <String[]>]
[-Component <String[]>]
[-Functionality <String[]>]
[-Role <String[]>]
[<CommonParameters>]Get-Help
[[-Name] <String>]
-Examples
[-Path <String>]
[-Category <String[]>]
[-Component <String[]>]
[-Functionality <String[]>]
[-Role <String[]>]
[<CommonParameters>]Get-Help
[[-Name] <String>]
-Parameter <String>
[-Path <String>]
[-Category <String[]>]
[-Component <String[]>]
[-Functionality <String[]>]
[-Role <String[]>]
[<CommonParameters>]Get-Help
[[-Name] <String>]
-Online
[-Path <String>]
[-Category <String[]>]
[-Component <String[]>]
[-Functionality <String[]>]
[-Role <String[]>]
[<CommonParameters>]Get-Help
[[-Name] <String>]
-ShowWindow
[-Path <String>]
[-Category <String[]>]
[-Component <String[]>]
[-Functionality <String[]>]
[-Role <String[]>]
[<CommonParameters>]Description
Get-Help Cmdlet 會顯示 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，一次顯示一個文字畫面。 或者，<cmdlet-name> -?，與 Get-Help相同，但只適用於 Cmdlet。
Get-Help 從您電腦上的說明檔取得說明內容。 如果沒有說明檔，Get-Help 只會顯示 Cmdlet 的基本資訊。 某些 PowerShell 模組包含說明檔。 從 PowerShell 3.0 開始，Windows 作業系統隨附的模組不包含說明檔。 若要在PowerShell 3.0 中下載或更新模組的說明檔，請使用 Update-Help Cmdlet。
您也可以在 Microsoft Docs 在線檢視 PowerShell 說明檔。若要取得說明檔的線上版本，請使用 Online 參數，例如：Get-Help Get-Process -Online。 若要閱讀所有 PowerShell 檔，請參閱 Microsoft Docs PowerShell 檔案。
如果您輸入 Get-Help 後面接著說明文章的確切名稱，或是說明文章特有的單字，Get-Help 會顯示文章的內容。 如果您輸入出現在數個說明文章標題中的單字或單字模式，Get-Help 會顯示相符標題的清單。 如果您輸入未出現在任何說明文章標題中的單字，Get-Help 會顯示文章清單，其中包含該單字的內容。
Get-Help 可取得所有支援語言和地區設定的說明文章。
Get-Help 先在 Windows 的地區設定中尋找說明檔，然後在父地區設定中尋找說明檔，例如 ptpt-BR，然後在後援地區設定中。 從 PowerShell 3.0 開始，如果 Get-Help 在後援地區設定中找不到說明，它會在傳回錯誤訊息或顯示自動產生的說明之前，先尋找英文說明文章，en-US。
如需命令語法圖表中 Get-Help 顯示符號的相關信息，請參閱 about_Command_Syntax。
如需參數屬性的相關信息，例如 必要 和 Position，請參閱 about_Parameters。
注意
在 PowerShell 3.0 和 PowerShell 4.0 中，除非模組匯入目前的會話，否則 Get-Help 在模組中找不到 關於 文章。 這是已知問題。 若要在模組中取得 關於 文章，請使用 Import-Module Cmdlet 或執行模組中包含的 Cmdlet 來匯入模組。
範例
範例 1：顯示 Cmdlet 的基本說明資訊
這些範例會顯示 Format-Table Cmdlet 的基本說明資訊。
Get-Help Format-Table
Get-Help -Name Format-Table
Format-Table -?
Get-Help <cmdlet-name> 是 Get-Help Cmdlet 的最簡單和預設語法。 您可以省略 Name 參數。
語法 <cmdlet-name> -? 僅適用於 Cmdlet。
範例 2：一次顯示一頁的基本資訊
這些範例會顯示一次一頁 Format-Table Cmdlet 的基本說明資訊。
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 的詳細資訊
這些範例會顯示 Format-Table Cmdlet 的詳細說明資訊。
Get-Help Format-Table -Detailed
Get-Help Format-Table -Full詳細 參數會顯示說明文章的詳細檢視，其中包含參數描述和範例。
Full 參數會顯示說明文章的完整檢視，其中包含參數描述、範例、輸入和輸出物件類型，以及其他附注。
詳細 和 完整 參數僅適用於電腦上已安裝說明檔的命令。 這些參數對概念性（about_）說明文章無效。
範例 4：使用參數顯示 Cmdlet 的選取部分
這些範例會顯示 Format-Table Cmdlet 說明的選取部分。
Get-Help Format-Table -Examples
Get-Help Format-Table -Parameter *
Get-Help Format-Table -Parameter GroupByExamples 參數會顯示說明檔 NAME 和 SYNOPSIS 區段，以及所有範例。 您無法指定範例編號，因為 Examples 參數是 switch 參數。
Parameter 參數只會顯示指定參數的描述。 如果您只指定星號 （*） 通配符，則會顯示所有參數的描述。
當 Parameter 指定參數名稱，例如 GroupBy時，會顯示該參數的相關信息。
這些參數對概念性（about_）說明文章無效。
範例 5：顯示在線版本的說明
本範例會顯示預設網頁瀏覽器中 Format-Table Cmdlet 之說明文章的在線版本。
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提供者的 Get-Item 節點中使用 Cmdlet。
第一個範例會使用 Get-HelpPath 參數來指定 SQL Server 提供者的路徑。
因為指定了提供者的路徑，因此您可以從任何路徑位置執行命令。
第二個範例會使用 Set-Location 流覽至 SQL Server 提供者的路徑。 從該位置， 不需要 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
僅針對指定類別及其別名中的項目顯示說明。 概念性文章位於 HelpFile 類別中。
此參數可接受的值如下：
- 別名
- Cmdlet
- 供應商
- 常規
- 常見問題
- 詞彙表
- HelpFile
- ScriptCommand
- 功能
- 濾波器
- ExternalScript
- 都
- DefaultHelp
- 工作流程
- DscResource
- 類
- 配置
| 類型: | String[] |
| 接受的值: | Alias, Cmdlet, Provider, General, FAQ, Glossary, HelpFile, ScriptCommand, Function, Filter, ExternalScript, All, DefaultHelp, Workflow, DscResource, Class, Configuration |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Component
顯示具有指定元件值的命令，例如 Exchange。 輸入元件名稱。 允許通配符。 此參數對概念性 （About_） 說明的顯示沒有任何影響。
| 類型: | String[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | True |
-Detailed
將參數描述和範例新增至基本說明顯示。 只有在計算機上安裝說明檔時，此參數才有效。 它不會影響概念性（About_）幫助的顯示。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | False |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Examples
只顯示名稱、摘要和範例。 若要只顯示範例，請輸入 (Get-Help \<cmdlet-name\>).Examples。
只有在計算機上安裝說明檔時，此參數才有效。 它不會影響概念性（About_）幫助的顯示。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | False |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Full
顯示 Cmdlet 的整個說明文章。 完整 包含參數描述和屬性、範例、輸入和輸出物件類型，以及其他附註。
只有在計算機上安裝說明檔時，此參數才有效。 它不會影響概念性（About_）幫助的顯示。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Functionality
顯示具有指定功能的項目說明。 輸入功能。 允許通配符。 此參數對概念性 （About_） 說明的顯示沒有任何影響。
| 類型: | String[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | True |
-Name
取得指定命令或概念的說明。 輸入 Cmdlet、函式、提供者、腳稿或工作流程的名稱，例如 Get-Member、概念性發行項名稱，例如 about_Objects或別名，例如 ls。 Cmdlet 和提供者名稱中允許通配符，但您無法使用通配符來尋找函式說明和腳本說明文章的名稱。
若要取得未位於 $env:Path 環境變數中所列路徑之腳本的說明，請輸入腳本的路徑和檔名。
如果您輸入說明文章的確切名稱，Get-Help 會顯示文章內容。
如果您輸入出現在數個說明文章標題中的單字或單字模式，Get-Help 會顯示相符標題的清單。
如果您輸入的字詞不符合任何說明文章標題，Get-Help 會顯示文章清單，其中包含該單字的內容。
概念性文章的名稱，例如 about_Objects，必須以英文輸入，即使在非英文版本的PowerShell中也一樣。
| 類型: | String |
| Position: | 0 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | True |
-Online
在預設瀏覽器中顯示說明文章的在線版本。 此參數僅適用於 Cmdlet、函式、工作流程和腳本說明文章。 您無法在遠端會話中搭配 使用 Get-Help 參數。
如需在您所撰寫的說明文章中支援此功能的相關信息，請參閱 about_Comment_Based_Help和 支援在線說明，以及 PowerShell Cmdlet 撰寫說明。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | False |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Parameter
只顯示指定參數的詳細描述。 允許通配符。 此參數對概念性 （About_） 說明的顯示沒有任何影響。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | True |
-Path
取得說明說明 Cmdlet 如何在指定的提供者路徑中運作。 輸入 PowerShell 提供者路徑。
此參數會取得自定義版本的 Cmdlet 說明文章，說明 Cmdlet 如何在指定的 PowerShell 提供者路徑中運作。 此參數僅適用於提供者 Cmdlet 的說明，而且只有在提供者在其說明檔中包含提供者 Cmdlet 說明文章的自定義版本時才有效。 若要使用此參數，請安裝包含提供者之模組的說明檔。
若要查看提供者路徑的自定義 Cmdlet 說明，請移至提供者路徑位置，然後輸入 Get-Help 命令，或從任何路徑位置，使用 的 Get-Help 參數來指定提供者路徑。 您也可以在說明文章的提供者說明一節中找到在線自定義 Cmdlet 說明。
如需 PowerShell 提供者的詳細資訊，請參閱 about_Providers。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | True |
-Role
顯示針對指定使用者角色自定義的說明。 輸入角色。 允許通配符。
輸入使用者在組織中扮演的角色。 有些 Cmdlet 會根據此參數的值，在其說明檔中顯示不同的文字。 此參數對核心 Cmdlet 的說明沒有任何作用。
| 類型: | String[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | True |
-ShowWindow
在視窗中顯示說明主題，方便閱讀。 視窗包含 [尋找 搜尋功能] 和 [設定] 方塊，可讓您設定顯示的選項，包括僅顯示幫助主題選取區段的選項。
ShowWindow 參數支援命令的說明主題（Cmdlet、函式、CIM 命令、工作流程、腳本）和概念 關於 文章。 它不支援提供者說明。
此參數是在 PowerShell 3.0 中引進的。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | False |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
None
您無法將物件從管線向下傳送至 Get-Help。
輸出
ExtendedCmdletHelpInfo
如果您在沒有說明檔的命令上執行 Get-Help，Get-Help 會傳回代表自動產生說明的 ExtendedCmdletHelpInfo 物件。
如果您收到概念性說明文章，Get-Help 以字串的形式傳回它。
MamlCommandHelpInfo
如果您取得具有說明檔的命令，Get-Help 會傳回 MamlCommandHelpInfo 物件。
備註
PowerShell 3.0 不包含說明檔。 若要下載並安裝 Get-Help 讀取的說明檔，請使用 Update-Help Cmdlet。 您可以使用 Update-Help Cmdlet 來下載並安裝 PowerShell 隨附之核心命令的說明檔，以及您安裝的任何模組。 您也可以使用它來更新說明檔，讓計算機上的說明永遠不會過期。
您也可以閱讀 PowerShell 在線啟動 開始使用 Windows PowerShell的命令相關說明文章。
Get-Help 在 Windows 作業系統的地區設定或該地區設定的後援語言中顯示說明。 如果您沒有主要或後援地區設定的說明檔，Get-Help 行為就像計算機上沒有說明檔案一樣。 若要取得不同地區設定的說明，請使用控制面板中的 Region 和 Language 來變更設定。 在 Windows 10 上，設定、時間 & 語言。
說明的完整檢視包含參數相關信息的數據表。 資料表包含下列欄位：
必要。 指出參數是必要參數 （true） 還是選擇性的 （false）。
Position。 指出參數是否為具名或位置 （numeric）。 位置參數必須出現在命令中指定的位置。
具名 指出參數名稱是必要的，但參數可以在命令中的任何位置出現。
Numeric 表示參數名稱是選擇性的，但省略名稱時，參數必須位於數位所指定的位置。 例如，
2指出，當省略參數名稱時，參數必須是命令中的第二個或只有未命名的參數。 使用參數名稱時，參數可以出現在命令中的任何位置。預設值。 如果您未在命令中包含 參數，PowerShell 所使用的參數值或預設行為。
接受管線輸入。 指出您是否可以 （true） 或無法 （false） 透過管線將物件傳送至參數。 By Property Name 表示管線對象必須具有與參數名稱相同的屬性。
接受通配符。 指出參數的值是否可以包含通配符，例如星號 （
*） 或問號 （?）。