通过

产品术语和品牌准则

当你写任何产品时，请务必使用正确的产品名称和术语。 本指南定义与 PowerShell 相关的产品名称和术语。 请注意特定字词或用例的大写。

PowerShell （集体名称）

使用 PowerShell 描述脚本语言和交互式 shell。

PowerShell （产品名称）

基于 .NET（核心）而不是 .NET Framework 构建的 PowerShell 的跨平台版本。 PowerShell 可以安装在 Windows、Linux 和 macOS 上。

PowerShell Core （产品已弃用）

用于基于 .NET Core 构建的 PowerShell v6 的名称。 不应使用此名称。

Windows PowerShell （产品名称）

Windows 中附带的 PowerShell 版本，需要完整的 .NET Framework。

准则

  • 第一次提及 - 使用“Windows PowerShell”

  • 后续提及 - 使用“PowerShell”，除非用例要求“Windows PowerShell”更具体：

    在 PowerShell 中，Invoke-WebRequest cmdlet 返回 BasicHtmlWebResponseObject

    在 Windows PowerShell 中 Invoke-WebRequest cmdlet 返回 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 资源管理器（ARM）模型管理 Azure 资源的上一代模块。 此产品已弃用，不再维护或受支持，不建议这样做。

Azure 服务管理 PowerShell （产品名称）

用于管理使用 Azure Service Manager （ASM） API 的旧 Azure 资源的最早模块集合。 创建新资源时，建议不要使用旧的 PowerShell 模块，因为计划将停用 ASM。

这些产品用于管理 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

准则

  • 始终使用产品的完整正确名称或特定的 PowerShell 模块名称

Visual Studio Code （VS Code）

这是Microsoft的免费开源编辑器。

准则

  • 第一次提及 - 使用全名
  • 后续提到，可以使用“VS Code”
  • 切勿使用“VSCode”

适用于 Visual Studio Code 的 PowerShell 扩展

该扩展将 VS Code 转换为 PowerShell 的首选 IDE。

准则

  • 第一次提及 - 使用全名
  • 后续提及 - 可以使用“PowerShell 扩展”