Aracılığıyla paylaş


Ürün terminolojisi ve markalama yönergeleri

Herhangi bir ürün hakkında yazarken, doğru ürün adlarını ve terminolojisini kullanmak önemlidir. Bu kılavuz, PowerShell ile ilgili ürün adlarını ve terminolojisini tanımlar. Belirli sözcüklerin veya kullanım örneklerinin büyük harf kullanımına dikkat edin.

PowerShell (kolektif isim)

Betik dili ve etkileşimli kabuk olarak PowerShell'i tanımlayın.

PowerShell (ürün adı)

.NET Framework yerine .NET (core) üzerinde oluşturulan PowerShell'in platformlar arası sürümü. PowerShell Windows, Linux ve macOS'a yüklenebilir.

PowerShell Core (ürün kullanım dışı)

.NET Core üzerinde oluşturulan PowerShell v6 için kullanılan ad. Bu ad kullanılmamalıdır.

Windows PowerShell (ürün adı)

Windows'ta gelen ve tam .NET Framework gerektiren PowerShell sürümü.

Yönergeler

  • İlk bahsetme - "Windows PowerShell" kullanın

  • Sonraki bahsetmeler - Kullanım örneğinin "Windows PowerShell"in daha belirgin olmasını gerektirmediği sürece "PowerShell" kullanın:

    PowerShell'de cmdlet Invoke-WebRequest döndürür

    Windows PowerShell'de Invoke-WebRequest cmdlet HtmlWebResponseObject döndürür

PowerShell modülleri

PowerShell modülleri, belirli ürün veya hizmetleri yönetmek için PowerShell cmdlet'leri içeren eklentilerdir.

Örneğin:

  • Azure PowerShell
  • Az.Accounts modülü
  • Windows yönetim modülü
  • Hyper-V modülü
  • Microsoft Graph PowerShell SDK'sı
  • Exchange PowerShell

Yönergeler

  • PowerShell modülüne başvururken her zaman kolektif adı veya daha özel modül adını kullanın
  • Bir modüle hiçbir zaman "PowerShell" olarak başvurma

Azure PowerShell (toplu ad)

Azure'ı yönetmek için kullanılan PowerShell modüllerini içeren markalı ürün grubu.

Azure PowerShell ürünlerinin çeşitli sürümleri mevcuttur. Her ürün birden çok adlandırılmış modül içerir.

Yönergeler

  • Ürünün ortak adı olarak "Azure PowerShell" kullanın
  • Her zaman kolektif adı kullanın, yalnızca "PowerShell" kullanmayın
  • Belirli bir sürüme başvururken daha belirli bir ürün adını kullanın

Az PowerShell (ürün adı)

PowerShell ile Azure kaynaklarını yönetmek için şu anda desteklenen modül koleksiyonu.

AzureRM PowerShell (ürün adı)

Azure kaynaklarını yönetmek için Azure Resource Manager (ARM) modelini kullanan önceki nesil modüller. Bu ürün kullanım dışı bırakıldı, artık korunmuyor veya desteklenmiyor ve önerilmez.

Azure Hizmet Yönetimi PowerShell (ürün adı)

Azure Service Manager (ASM) API'lerini kullanan eski Azure kaynaklarını yönetmeye yönelik en eski modül koleksiyonu. Yeni kaynaklar oluştururken bu eski PowerShell modülünün kullanılması önerilmez, çünkü ASM'nin kaldırılması planlanmaktadır.

Bu ürünler Azure kaynaklarını yönetmek için kullanılır ancak Azure PowerShell toplu ürününün bir parçası değildir. Bunlar hiçbir zaman "Azure PowerShell" toplu adı kullanılarak açıklanmamalıdır.

  • Azure Information Protection PowerShell
  • Azure Dağıtım Yöneticisi PowerShell
  • Azure Esnek Veritabanı Görevleri PowerShell
  • Azure Service Fabric PowerShell
  • Azure Stack PowerShell
  • Microsoft Graph PowerShell SDK'sı
  • Microsoft Entra PowerShell

Yönergeler

  • Her zaman ürünün tam adını veya belirli Bir PowerShell modülü adını kullanın

Visual Studio Code (VS Code)

Bu, Microsoft'un ücretsiz, açık kaynak düzenleyicisidir.

Yönergeler

  • İlk bahsetme - tam adı kullanın
  • Sonraki bahsetmeler - "VS Code" kullanabilirsiniz
  • Hiçbir zaman "VSCode" kullanmayın

Visual Studio Code için PowerShell Uzantısı

Uzantı, VS Code'un PowerShell için tercih edilen IDE'ye dönüştürülmesidir.

Yönergeler

  • İlk bahsetme - tam adı kullanın
  • Sonraki bahsetmeler - "PowerShell uzantısını" kullanabilirsiniz