當您撰寫任何產品時,請務必使用適當的產品名稱和術語。 本指南定義與 PowerShell 相關的產品名稱和術語。 請注意特定單字或使用案例的大寫。
PowerShell (集體名稱)
使用 PowerShell 指腳本語言和互動式命令列介面。
PowerShell (產品名稱)
建置在 .NET (core) 而非 .NET Framework 上的 PowerShell 跨平臺版本。 PowerShell 可以安裝在 Windows、Linux 和 macOS 上。
PowerShell Core (產品已被取代)
建置在 .NET Core 上之 PowerShell v6 的名稱。 不應該使用此名稱。
Windows PowerShell (產品名稱)
Windows 隨附的 PowerShell 版本,需要完整的 .NET Framework。
指導方針
首次提及 - 使用“Windows PowerShell”
後續提到 - 除非使用案例需要更具體地使用「Windows PowerShell」,否則請使用「PowerShell」:
在 PowerShell 中,Cmdlet 會
Invoke-WebRequest傳回 BasicHtmlWebResponseObject在 Windows PowerShell 中
Invoke-WebRequestcmdlet 會傳回HtmlWebResponseObject
PowerShell 模組
PowerShell 模組是包含 PowerShell Cmdlet 來管理特定產品或服務的附加元件。
例如:
- Azure PowerShell
- Az.Accounts 模組
- Windows 管理模組
- Hyper-V 模組
- Microsoft Graph PowerShell SDK
- Exchange PowerShell
指導方針
- 在參考 PowerShell 模組時,一律使用集體名稱或更特定的模組名稱
- 永遠不要將模組稱為“PowerShell”
Azure PowerShell(集體名稱)
包含用來管理 Azure 之 PowerShell 模組的品牌產品群組。
有數個可用的 Azure PowerShell 產品版本。 每個產品都包含多個具名模組。
指導方針
- 使用 「Azure PowerShell」 作為產品的集體名稱
- 一律使用集體名稱,絕不只使用 “PowerShell”
- 參考特定版本時,請使用更特定的產品名稱
Az PowerShell (產品名稱)
目前支援使用 PowerShell 管理 Azure 資源的模組集合。
AzureRM PowerShell (產品名稱)
前一代使用 Azure Resource Manager (ARM) 模型來管理 Azure 資源的模組。 此產品已被取代、不再維護或支援,不建議使用。
Azure 服務管理 PowerShell (產品名稱)
最早用來管理使用 Azure Service Manager (ASM) API 之舊版 Azure 資源的模組集合。 建立新的資源時,不建議使用此舊版 PowerShell 模組,因為 ASM 已排定淘汰。
Azure 相關 PowerShell 模組
這些產品是用來管理 Azure 資源,但不屬於 Azure PowerShell 集體產品的一部分。 不應該使用 「Azure PowerShell」 集體名稱來描述它們。
- Azure 資訊保護 PowerShell
- Azure 部署管理員 PowerShell
- Azure 彈性資料庫作業「PowerShell」
- Azure Service Fabric PowerShell
- Azure Stack PowerShell
- Microsoft Graph PowerShell SDK
- Microsoft Entra PowerShell(微軟 Entra PowerShell)
指導方針
- 一律使用產品的完整適當名稱或特定的PowerShell模組名稱
其他 PowerShell 相關產品
Visual Studio Code (VS Code)
這是Microsoft免費的開放原始碼編輯器。
指導方針
- 第一次提及 - 使用完整名稱
- 後續提及 - 您可以使用 “VS Code”
- 請勿使用 “VSCode”
適用於 Visual Studio Code 的 PowerShell 擴充功能
延伸模組會將 VS Code 轉換成 PowerShell 的慣用 IDE。
指導方針
- 第一次提及 - 使用完整名稱
- 後續提及 - 您可以使用 “PowerShell 擴充功能”