Terminologia do produto e diretrizes de marca

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

PowerShell (nome coletivo)

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

PowerShell (nome do produto)

A versão de plataforma cruzada do PowerShell baseada 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. Este nome não deve ser usado.

Windows PowerShell (nome do produto)

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

Orientações

• Primeira menção - use "Windows PowerShell"

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

  No PowerShell, o Invoke-WebRequest cmdlet retorna BasicHtmlWebResponseObject

  No Windows PowerShell, o Invoke-WebRequest cmdlet retorna 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
• Hyper-V módulo
• SDK do PowerShell nos Microsoft Graph
• PowerShell do Exchange

Orientações

• Sempre use o nome coletivo ou o nome do módulo mais específico ao se referir a um módulo do PowerShell
• Nunca se refira a um módulo como "PowerShell"

Azure PowerShell (nome coletivo)

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

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

Orientações

• Use "Azure PowerShell" como o nome coletivo para o produto
• Use sempre 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 atualmente suportada de módulos para gerenciar recursos do Azure com o PowerShell.

AzureRM PowerShell (nome do produto)

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

Azure Service Management PowerShell (nome do produto)

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

Módulos do PowerShell relacionados ao Azure

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".

• Azure Information Protection PowerShell
• Azure Deployment Manager PowerShell
• Azure Elastic Database Jobs PowerShell
• Azure Service Fabric PowerShell
• Azure Stack PowerShell
• SDK do PowerShell nos Microsoft Graph
• Microsoft Entra PowerShell

Orientações

• Use sempre o nome completo do produto ou o nome específico do módulo do PowerShell

Outros produtos relacionados ao PowerShell

Código do Visual Studio (VS Code)

Este é o editor gratuito e de código aberto da Microsoft.

Orientações

• 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 preferido para PowerShell.

Orientações

• Primeira menção - use o nome completo
• Menções subsequentes - você pode usar "extensão do PowerShell"