Condividi tramite


Linee guida per la terminologia e la personalizzazione dei prodotti

Quando si scrive su qualsiasi prodotto, è importante usare i nomi e la terminologia appropriati dei prodotti. Questa guida definisce i nomi dei prodotti e la terminologia correlati a PowerShell. Prendere nota della maiuscola di parole o casi d'uso specifici.

PowerShell (nome collettivo)

Usare PowerShell per descrivere il linguaggio di scripting e una shell interattiva.

PowerShell (nome prodotto)

La versione multipiattaforma di PowerShell basata su .NET (core) anziché su .NET Framework. PowerShell può essere installato in Windows, Linux e macOS.

PowerShell Core (prodotto deprecato)

Nome usato per PowerShell v6, basato su .NET Core. Questo nome non deve essere usato.

Windows PowerShell (nome prodotto)

Versione di PowerShell fornita in Windows, che richiede .NET Framework completo.

Istruzioni

  • Prima menzione: usare "Windows PowerShell"

  • Menzioni successive: usare "PowerShell", a meno che il caso d'uso non richieda che "Windows PowerShell" sia più specifico:

    In PowerShell il Invoke-WebRequest cmdlet restituisce BasicHtmlWebResponseObject

    In Windows PowerShell il Invoke-WebRequest cmdlet restituisce HtmlWebResponseObject

Moduli di PowerShell

I moduli di PowerShell sono componenti aggiuntivi che contengono cmdlet di PowerShell per gestire prodotti o servizi specifici.

Per esempio:

  • Azure PowerShell
  • Modulo Az.Accounts
  • Modulo di gestione di Windows
  • modulo Hyper-V
  • Microsoft Graph PowerShell SDK
  • PowerShell per Exchange

Istruzioni

  • Usare sempre il nome collettivo o il nome del modulo più specifico quando si fa riferimento a un modulo di PowerShell
  • Non fare mai riferimento a un modulo come "PowerShell"

Azure PowerShell (nome collettivo)

Gruppo di prodotti con marchio contenenti moduli di PowerShell usati per gestire Azure.

Sono disponibili diverse versioni dei prodotti Azure PowerShell. Ogni prodotto contiene più moduli denominati.

Istruzioni

  • Usare "Azure PowerShell" come nome collettivo per il prodotto
  • Usare sempre il nome collettivo, non solo "PowerShell"
  • Usare il nome del prodotto più specifico quando si fa riferimento a una versione specifica

Az PowerShell (nome prodotto)

Raccolta di moduli attualmente supportata per la gestione delle risorse di Azure con PowerShell.

AzureRM PowerShell (nome prodotto)

La generazione precedente di moduli che usano il modello di Azure Resource Manager (ARM) per la gestione delle risorse di Azure. Questo prodotto è deprecato, non più gestito o supportato e non consigliato.

PowerShell per la gestione dei servizi di Azure (nome del prodotto)

La prima raccolta di moduli per la gestione delle risorse di Azure legacy che usano le API di Azure Service Manager (ASM). Questo modulo di PowerShell legacy non è consigliato durante la creazione di nuove risorse perché ASM è pianificato per il ritiro.

Questi prodotti vengono usati per gestire le risorse di Azure, ma non fanno parte del prodotto collettivo di Azure PowerShell. Non devono mai essere descritti usando il nome collettivo "Azure PowerShell".

  • Azure Information Protection PowerShell
  • Azure Deployment Manager PowerShell
  • PowerShell per attività di database elastici di Azure
  • Azure Service Fabric PowerShell
  • Azure Stack PowerShell
  • Microsoft Graph PowerShell SDK
  • Microsoft Entra PowerShell

Istruzioni

  • Usare sempre il nome completo del prodotto o il nome del modulo di PowerShell specifico

Visual Studio Code (VS Code)

Questo è l'editor open source gratuito di Microsoft.

Istruzioni

  • Prima menzione: usare il nome completo
  • Menzioni successive: è possibile usare "VS Code"
  • Non usare mai "VSCode"

Estensione PowerShell per Visual Studio Code

L'estensione trasforma VS Code nell'IDE preferito per PowerShell.

Istruzioni

  • Prima menzione: usare il nome completo
  • Menzioni successive: è possibile usare "Estensione PowerShell"