Delen via

Richtlijnen voor productterminologie en huisstijl

Wanneer u over een product schrijft, is het belangrijk dat u de juiste productnamen en terminologie gebruikt. In deze handleiding worden productnamen en terminologie gedefinieerd die betrekking hebben op PowerShell. Let op het hoofdlettergebruik van specifieke woorden of gebruiksvoorbeelden.

PowerShell (collectieve naam)

Gebruik PowerShell om de scripttaal en een interactieve shell te beschrijven.

PowerShell (productnaam)

De platformoverschrijdende versie van PowerShell die is gebouwd op .NET (core), in plaats van het .NET Framework. PowerShell kan worden geïnstalleerd in Windows, Linux en macOS.

PowerShell Core (product niet langer aanbevolen)

De naam die wordt gebruikt voor PowerShell v6, gebouwd op .NET Core. Deze naam mag niet worden gebruikt.

Windows PowerShell (productnaam)

De versie van PowerShell die wordt geleverd in Windows, waarvoor het volledige .NET Framework is vereist.

Richtlijnen

  • Eerste vermelding- gebruik 'Windows PowerShell'

  • Volgende vermeldingen: gebruik 'PowerShell', tenzij de use-case vereist dat 'Windows PowerShell' specifieker is.

    In PowerShell retourneert deze Invoke-WebRequest cmdlet BasicHtmlWebResponseObject

    In Windows PowerShell retourneert de Invoke-WebRequest cmdlet HtmlWebResponseObject

PowerShell-modulen

PowerShell-modules zijn invoegtoepassingen die PowerShell-cmdlets bevatten voor het beheren van specifieke producten of services.

Voorbeeld:

  • Azure PowerShell
  • module Az.Accounts
  • Windows-beheermodule
  • Hyper-V module
  • Microsoft Graph PowerShell SDK
  • Exchange PowerShell

Richtlijnen

  • Gebruik altijd de collectieve naam of de specifiekere modulenaam wanneer u naar een PowerShell-module verwijst
  • Verwijs nooit naar een module als 'PowerShell'

Azure PowerShell (collectieve naam)

De merkgroep producten met PowerShell-modules die worden gebruikt voor het beheren van Azure.

Er zijn verschillende versies van Azure PowerShell-producten beschikbaar. Elk product bevat meerdere benoemde modules.

Richtlijnen

  • Azure PowerShell gebruiken als collectieve naam voor het product
  • Gebruik altijd de collectieve naam, nooit alleen 'PowerShell'
  • Gebruik de specifiekere productnaam wanneer u naar een specifieke versie verwijst

Az PowerShell (productnaam)

De momenteel ondersteunde verzameling modules voor het beheren van Azure-resources met PowerShell.

AzureRM PowerShell (productnaam)

De vorige generatie modules die gebruikmaken van het ARM-model (Azure Resource Manager) voor het beheren van Azure-resources. Dit product is afgeschaft, wordt niet meer onderhouden of ondersteund en wordt niet aanbevolen.

Azure Service Management PowerShell (productnaam)

De vroegste verzameling modules voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling.

Deze producten worden gebruikt voor het beheren van Azure-resources, maar maken geen deel uit van het collectieve Azure PowerShell-product. Ze mogen nooit worden beschreven met behulp van de collectieve naam van Azure PowerShell.

  • Azure Information Protection PowerShell
  • Azure Deployment Manager PowerShell
  • PowerShell voor Azure Elastic Database-opdrachten
  • Azure Service Fabric PowerShell
  • Azure Stack PowerShell
  • Microsoft Graph PowerShell SDK
  • Microsoft Entra PowerShell

Richtlijnen

  • Gebruik altijd de volledige juiste naam van het product of de specifieke Naam van de PowerShell-module

Visual Studio Code (VS Code)

Dit is de gratis opensource-editor van Microsoft.

Richtlijnen

  • Bij eerste vermelding - gebruik de volledige naam
  • Volgende vermeldingen : u kunt VS Code gebruiken
  • Gebruik nooit 'VSCode'

PowerShell-extensie voor Visual Studio Code

Met de extensie wordt VS Code omgezet in de voorkeurs-IDE voor PowerShell.

Richtlijnen

  • Bij eerste vermelding - gebruik de volledige naam
  • Volgende vermeldingen: u kunt de PowerShell-extensie gebruiken