Terminologi produk dan pedoman branding

Ketika Anda menulis tentang produk apa pun, penting untuk menggunakan nama produk dan terminologi yang tepat. Panduan ini mendefinisikan nama produk dan terminologi yang terkait dengan PowerShell. Perhatikan kapitalisasi kata atau kasus penggunaan tertentu.

PowerShell (nama kolektif)

Gunakan PowerShell untuk menjelaskan bahasa pembuatan skrip dan shell interaktif.

PowerShell (nama produk)

Versi lintas platform PowerShell yang dibangun di .NET (core), bukan .NET Framework. PowerShell dapat diinstal di Windows, Linux, dan macOS.

PowerShell Core (produk tidak digunakan lagi)

PowerShell v6 yang dibangun pada .NET Core menggunakan nama ini. Nama ini tidak boleh digunakan.

Windows PowerShell (nama produk)

Versi PowerShell yang disertakan dalam Windows, yang membutuhkan .NET Framework lengkap.

Panduan

  • Penyebutan pertama - gunakan "Windows PowerShell"

  • Penyebutan berikutnya - Gunakan "PowerShell" kecuali kasus penggunaan mengharuskan "Windows PowerShell" lebih spesifik:

    Di PowerShell, Invoke-WebRequest cmdlet mengembalikan BasicHtmlWebResponseObject

    Di Windows PowerShell, Invoke-WebRequest cmdlet mengembalikan HtmlWebResponseObject

Modul PowerShell

Modul PowerShell adalah add-on yang berisi cmdlet PowerShell untuk mengelola produk atau layanan tertentu.

Contohnya:

  • Azure PowerShell
  • Modul Az.Accounts
  • Modul manajemen Windows
  • modul Hyper-V
  • SDK PowerShell Microsoft Graph
  • Exchange PowerShell

Panduan

  • Selalu gunakan nama kolektif atau nama modul yang lebih spesifik saat merujuk ke modul PowerShell
  • Jangan pernah menyebut modul sebagai "PowerShell"

Azure PowerShell (nama kolektif)

Grup produk bermerk yang berisi modul PowerShell yang digunakan untuk mengelola Azure.

Ada beberapa versi produk Azure PowerShell yang tersedia. Setiap produk berisi beberapa modul bernama.

Panduan

  • Gunakan "Azure PowerShell" sebagai nama kolektif untuk produk
  • Selalu gunakan nama kolektif, jangan pernah hanya "PowerShell"
  • Gunakan nama produk yang lebih spesifik saat merujuk ke versi tertentu

Az PowerShell (nama produk)

Kumpulan modul yang saat ini didukung untuk mengelola sumber daya Azure dengan PowerShell.

AzureRM PowerShell (nama produk)

Modul generasi sebelumnya yang menggunakan model Azure Resource Manager (ARM) untuk mengelola sumber daya Azure. Produk ini tidak digunakan lagi, tidak lagi dipertahankan atau didukung, dan tidak disarankan.

Azure Service Management PowerShell (nama produk)

Kumpulan modul paling awal untuk mengelola sumber daya Azure warisan yang menggunakan API Azure Service Manager (ASM). Modul PowerShell warisan ini tidak disarankan saat membuat sumber daya baru karena ASM dijadwalkan untuk dihentikan.

Produk-produk ini digunakan untuk mengelola sumber daya Azure tetapi bukan bagian dari produk kolektif Azure PowerShell. Mereka seharusnya tidak disebutkan menggunakan nama kolektif "Azure PowerShell".

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

Panduan

  • Selalu gunakan nama lengkap produk yang tepat atau nama modul PowerShell tertentu

Visual Studio Code (Visual Studio Code)

Ini adalah editor sumber terbuka gratis Microsoft.

Panduan

  • Penyebutan pertama - gunakan nama lengkap
  • Penyebutan berikutnya - Anda dapat menggunakan "Visual Studio Code"
  • Jangan pernah menggunakan "VSCode"

Ekstensi PowerShell untuk Visual Studio Code

Ekstensi mengubah VISUAL Code menjadi IDE pilihan untuk PowerShell.

Panduan

  • Penyebutan pertama - gunakan nama lengkap
  • Dalam penyebutan berikut, Anda dapat menggunakan "ekstensi PowerShell"
  • Terakhir diperbarui pada