Compartilhar via

Diretrizes de terminologia e identidade visual do produto

Quando você escreve sobre qualquer produto, é importante usar os nomes de produto e a terminologia adequados. Este guia define nomes de produtos e terminologia relacionados ao PowerShell. Observe a capitalização de palavras específicas ou casos de uso.

PowerShell (nome coletivo)

Use o PowerShell para descrever a linguagem de script e um shell interativo.

PowerShell (nome do produto)

A versão multiplataforma do PowerShell criada no .NET (core), em vez do .NET Framework. O PowerShell pode ser instalado no Windows, linux e macOS.

PowerShell Core (produto preterido)

O nome usado para o PowerShell v6, criado no .NET Core. Esse nome não deve ser usado.

Windows PowerShell (nome do produto)

A versão do PowerShell que é fornecida no Windows, que requer o .NET Framework completo.

Diretrizes

  • Primeira menção – usar "Windows PowerShell"

  • Menções subsequentes: use "PowerShell", a menos que o caso de uso exija que "Windows PowerShell" seja mais específico:

    No PowerShell, o cmdlet Invoke-WebRequest retorna um BasicHtmlWebResponseObject

    No Windows PowerShell, o cmdlet Invoke-WebRequest retorna o objeto HtmlWebResponseObject

Módulos do PowerShell

Os módulos do PowerShell são complementos que contêm cmdlets do PowerShell para gerenciar produtos ou serviços específicos.

Por exemplo:

  • Azure PowerShell
  • Módulo Az.Accounts
  • Módulo de gerenciamento do Windows
  • módulo Hyper-V
  • SDK do PowerShell do Microsoft Graph
  • Exchange PowerShell

Diretrizes

  • Sempre use o nome coletivo ou o nome do módulo mais específico ao fazer referência a um módulo do PowerShell
  • Nunca consulte um módulo como "PowerShell"

Azure PowerShell (nome coletivo)

O grupo de produtos de marca que contém módulos do PowerShell usados para gerenciar o Azure.

Há várias versões de produtos do Azure PowerShell disponíveis. Cada produto contém vários módulos nomeados.

Diretrizes

  • Usar "Azure PowerShell" como o nome coletivo do produto
  • Sempre use o nome coletivo, nunca apenas "PowerShell"
  • Use o nome do produto mais específico ao se referir a uma versão específica

Az PowerShell (nome do produto)

A coleção de módulos com suporte no momento para gerenciar recursos do Azure com o PowerShell.

PowerShell do AzureRM (nome do produto)

A geração anterior de módulos que usam o modelo do ARM (Azure Resource Manager) para gerenciar recursos do Azure. Este produto foi preterido, não é mais mantido ou tem suporte e não é recomendado.

PowerShell do Gerenciamento de Serviços do Azure (nome do produto)

A coleção mais antiga de módulos para gerenciar recursos herdados do Azure que usam APIs do ASM (Azure Service Manager). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, pois o ASM está programado para descontinuação.

Esses produtos são usados para gerenciar recursos do Azure, mas não fazem parte do produto coletivo do Azure PowerShell. Eles nunca devem ser descritos usando o nome coletivo "Azure PowerShell".

  • PowerShell da Proteção de Informações do Azure
  • PowerShell do Gerenciador de Implantação do Azure
  • PowerShell de trabalhos de Banco de Dados Elástico do Azure:
  • Azure Service Fabric PowerShell
  • Azure Stack PowerShell
  • SDK do PowerShell do Microsoft Graph
  • Microsoft Entra PowerShell

Diretrizes

  • Sempre use o nome completo apropriado do produto ou o nome do módulo específico do PowerShell

VS Code (Visual Studio Code)

Este é o editor gratuito e de software livre da Microsoft.

Diretrizes

  • Primeira menção : use o nome completo
  • Menções subsequentes: você pode usar "VS Code"
  • Nunca use "VSCode"

Extensão do PowerShell para Visual Studio Code

A extensão transforma o VS Code no IDE preferencial do PowerShell.

Diretrizes

  • Primeira menção : use o nome completo
  • Menções subsequentes – você pode usar a "extensão do PowerShell"
  • Last updated on