Dela via

Riktlinjer för produktterminologi och varumärkesanpassning

När du skriver om en produkt är det viktigt att använda rätt produktnamn och terminologi. Den här guiden definierar produktnamn och terminologi som är relaterade till PowerShell. Observera versaler för vissa ord eller användningsfall.

PowerShell (samlingsnamn)

Använd PowerShell för att beskriva skriptspråket och ett interaktivt gränssnitt.

PowerShell (produktnamn)

Plattformsoberoende versionen av PowerShell bygger på .NET (core) i stället för .NET Framework. PowerShell kan installeras i Windows, Linux och macOS.

PowerShell Core (produkten är inaktuell)

Namnet som används för PowerShell v6, som bygger på .NET Core. Det här namnet ska inte användas.

Windows PowerShell (produktnamn)

Den version av PowerShell som levereras i Windows, vilket kräver hela .NET Framework.

Riktlinjer

  • Första omnämnandet – använd "Windows PowerShell"

  • Efterföljande omnämnanden – Använd "PowerShell" om inte användningsfallet kräver att "Windows PowerShell" är mer specifikt:

    Cmdleten Invoke-WebRequest returnerar BasicHtmlWebResponseObject i PowerShell.

    I Windows PowerShell returnerar cmdleten Invoke-WebRequestHtmlWebResponseObject

PowerShell-moduler

PowerShell-moduler är tillägg som innehåller PowerShell-cmdletar för att hantera specifika produkter eller tjänster.

Till exempel:

  • Azure PowerShell
  • Modulen Az.Accounts
  • Windows-hanteringsmodul
  • Hyper-V modul
  • Microsoft Graph PowerShell SDK
  • Exchange PowerShell

Riktlinjer

  • Använd alltid samlingsnamnet eller det mer specifika modulnamnet när du refererar till en PowerShell-modul
  • Referera aldrig till en modul som "PowerShell"

Azure PowerShell (samlingsnamn)

Den märkesgrupp med produkter som innehåller PowerShell-moduler som används för att hantera Azure.

Det finns flera versioner av Azure PowerShell-produkter tillgängliga. Varje produkt innehåller flera namngivna moduler.

Riktlinjer

  • Använd "Azure PowerShell" som samlingsnamn för produkten
  • Använd alltid samlingsnamnet, aldrig bara "PowerShell"
  • Använd det mer specifika produktnamnet när du refererar till en viss version

Az PowerShell (produktnamn)

Den samling moduler som stöds för att hantera Azure-resurser med PowerShell.

AzureRM PowerShell (produktnamn)

Den tidigare generationen av moduler som använder Azure Resource Manager-modellen (ARM) för att hantera Azure-resurser. Den här produkten är inaktuell, underhålls inte längre eller stöds och rekommenderas inte.

Azure Service Management PowerShell (produktnamn)

Den tidigaste samlingen av moduler för hantering av äldre Azure-resurser som använder API:er för Azure Service Manager (ASM). Den här äldre PowerShell-modulen rekommenderas inte när du skapar nya resurser eftersom ASM är schemalagt för tillbakadragning.

Dessa produkter används för att hantera Azure-resurser men ingår inte i den samlade Azure PowerShell-produkten. De bör aldrig beskrivas med samlingsnamnet "Azure PowerShell".

  • Azure Information Protection PowerShell
  • Azure Deployment Manager PowerShell
  • PowerShell för Azure Elastic Database-jobb
  • Azure Service Fabric PowerShell
  • Azure Stack PowerShell
  • Microsoft Graph PowerShell SDK
  • Microsoft Entra PowerShell

Riktlinjer

  • Använd alltid produktens fullständiga namn eller det specifika PowerShell-modulnamnet

Visual Studio Code (VS Code)

Det här är Microsofts kostnadsfria redigeringsprogram med öppen källkod.

Riktlinjer

  • Första omnämnandet – använd det fullständiga namnet
  • Efterföljande omnämnanden – du kan använda "VS Code"
  • Använd aldrig "VSCode"

PowerShell-tillägg för Visual Studio Code

Tillägget omvandlar VS Code till önskad IDE för PowerShell.

Riktlinjer

  • Första omnämnandet – använd det fullständiga namnet
  • Efterföljande omnämnanden – du kan använda "PowerShell-tillägget"