Compartir a través de

Directrices de personalización de marca y terminología del producto

Al escribir sobre cualquier producto, es importante usar los nombres de producto y la terminología adecuados. En esta guía se definen los nombres de producto y la terminología relacionados con PowerShell. Tenga en cuenta la mayúscula de palabras específicas o casos de uso.

PowerShell (nombre colectivo)

Use PowerShell para describir el lenguaje de scripting y un shell interactivo.

PowerShell (nombre del producto)

La versión multiplataforma de PowerShell basada en .NET (core) en lugar de .NET Framework. PowerShell se puede instalar en Windows, Linux y macOS.

PowerShell Core (producto en desuso)

Nombre usado para PowerShell v6, basado en .NET Core. Este nombre no se debe usar.

Windows PowerShell (nombre del producto)

La versión de PowerShell que se incluye en Windows, que requiere la versión completa de .NET Framework.

Directrices

  • Primera mención: usar "Windows PowerShell"

  • Menciones posteriores: use "PowerShell" a menos que el caso de uso requiera que "Windows PowerShell" sea más específico:

    En PowerShell, el Invoke-WebRequest cmdlet devuelve BasicHtmlWebResponseObject.

    En Windows PowerShell, el Invoke-WebRequest cmdlet devuelve HtmlWebResponseObject.

Módulos de PowerShell

Los módulos de PowerShell son complementos que contienen cmdlets de PowerShell para administrar productos o servicios específicos.

Por ejemplo:

  • Azure PowerShell
  • Módulo Az.Accounts
  • Módulo de administración de Windows
  • módulo de Hyper-V
  • SDK de Microsoft Graph para PowerShell
  • Exchange PowerShell

Directrices

  • Use siempre el nombre colectivo o el nombre de módulo más específico al hacer referencia a un módulo de PowerShell.
  • Nunca haga referencia a un módulo como "PowerShell"

Azure PowerShell (nombre colectivo)

El grupo de productos con marca que contiene módulos de PowerShell que se usan para administrar Azure.

Hay varias versiones de los productos de Azure PowerShell disponibles. Cada producto contiene varios módulos con nombre.

Directrices

  • Use "Azure PowerShell" como nombre colectivo del producto.
  • Use siempre el nombre colectivo, nunca solo "PowerShell".
  • Usar el nombre de producto más específico al hacer referencia a una versión específica

Az PowerShell (nombre del producto)

La colección de módulos admitida actualmente para administrar recursos de Azure con PowerShell.

AzureRM PowerShell (nombre del producto)

La generación anterior de módulos que usan el modelo de Azure Resource Manager (ARM) para administrar recursos de Azure. Este producto está en desuso, ya no se actualiza ni se mantiene ni recibe soporte, y no es aconsejable.

PowerShell de administración de servicios de Azure (nombre del producto)

La primera colección de módulos para administrar recursos heredados de Azure que usan las API de Azure Service Manager (ASM). Este módulo heredado de PowerShell no se recomienda para la creación de nuevos recursos, ya que ASM está programado para su retiro.

Estos productos se usan para administrar recursos de Azure, pero no forman parte del producto colectivo de Azure PowerShell. Nunca se deben describir con el nombre colectivo de "Azure PowerShell".

  • Azure Information Protection PowerShell
  • Azure Deployment Manager PowerShell
  • PowerShell de trabajos de Base de datos elástica de Azure
  • Azure Service Fabric PowerShell
  • Azure Stack PowerShell
  • SDK de Microsoft Graph para PowerShell
  • Microsoft Entra PowerShell

Directrices

  • Use siempre el nombre correcto completo del producto o el nombre del módulo de PowerShell específico.

Visual Studio Code (VS Code)

Este es el editor de código abierto gratuito de Microsoft.

Directrices

  • Primera mención: use el nombre completo.
  • Menciones posteriores: puedes usar "VS Code"
  • Nunca use "VSCode"

Extensión de PowerShell para Visual Studio Code

La extensión convierte VS Code en el IDE preferido para PowerShell.

Directrices

  • Primera mención: use el nombre completo.
  • Menciones posteriores: puede usar "extensión de PowerShell"