about_PowerShell_Editions

Kısa açıklama

PowerShell'in farklı sürümleri farklı temel çalışma zamanlarında çalıştırılır.

Uzun açıklama

PowerShell 5.1'den, her biri farklı bir .NET çalışma zamanında çalışan birden çok PowerShell sürümü vardır. PowerShell 6.0 sürümünden itibaren PowerShell'in iki sürümü vardır:

• .NET Framework üzerinde çalışan masaüstü. PowerShell 4 ve altı sürümlerin yanı sıra PowerShell 5.1, Windows Masaüstü, Windows Server, Windows Server Core ve diğer Windows işletim sistemlerinin çoğu gibi tam özellikli Windows sürümlerinde kullanılabilir. Bu, özgün PowerShell sürümüdür ve işletim sisteminin varsayılan yüklemesine dahil edilir.
• .NET Core üzerinde çalışan Core. PowerShell 6.0 ve üzeri, tam özellikli Windows sürümlerinde, Windows Nano Server ve Windows IoT gibi bazı azaltılmış ayak izi Windows sürümlerinde veya Linux ve macOS gibi Windows dışı platformlarda önceki PowerShell sürümleriyle yan yana yüklenir.

PowerShell sürümü .NET çalışma zamanına karşılık geldiği için ,NET API ve PowerShell modülü uyumluluğunun birincil göstergesidir; bazı .NET API'leri, türleri veya yöntemleri hem .NET çalışma zamanlarında kullanılamaz hem de bu, bunlara bağlı PowerShell betiklerini ve modüllerini etkiler.

Otomatik $PSEdition değişken

PowerShell 5.1 ve üzeri sürümlerde otomatik değişkenle hangi sürümü çalıştırdığınızı $PSEdition öğrenebilirsiniz:

$PSEdition

Core

PowerShell 4 ve altında bu değişken yoktur. $PSEdition null değeri değeriyle aynı Desktopkabul edilmelidir.

Sürümündeki sürüm $PSVersionTable

Otomatik $PSVersionTable değişken, PowerShell 5.1 ve üzerinde PSEdition özelliğine de sahiptir:

$PSVersionTable

Name                           Value
----                           -----
PSVersion                      7.3.9
PSEdition                      Core
GitCommitId                    7.3.9
OS                             Microsoft Windows 10.0.22621
Platform                       Win32NT
PSCompatibleVersions           {1.0, 2.0, 3.0, 4.0…}
PSRemotingProtocolVersion      2.3
SerializationVersion           1.1.0.1
WSManStackVersion              3.0

PSEdition alanı, otomatik değişkenle aynı değere $PSEdition sahiptir.

Modül CompatiblePSEditions bildirim alanı

PowerShell modülleri, modül bildiriminin alanını kullanarak CompatiblePSEditions hangi PowerShell sürümleriyle uyumlu olduklarını bildirebilir.

Örneğin, PowerShell'in hem hem de DesktopCore sürümleriyle uyumluluğu belirten bir modül bildirimi:

@{
    ModuleVersion = '1.0'
    FunctionsToExport = @('Test-MyModule')
    CompatiblePSEditions = @('Desktop', 'Core')
}

Yalnızca Desktop uyumlulukla modül bildirimi örneği:

@{
    ModuleVersion = '1.0'
    FunctionsToExport = @('Test-MyModule')
    CompatiblePSEditions = @('Desktop')
}

Bu alan kullanılmadan önce oluşturulan modüller bu sürüm için örtülü olarak yazıldığı için, bir modül bildirimindeki alanın atlanması CompatiblePSEditions , alanı olarak ayarlamakla Desktopaynı etkiye sahip olacaktır.

Windows'un bir parçası olarak gönderilmeyen modüller (galeriden yazdığınız veya yüklediğiniz modüller) için bu alan yalnızca bilgilendirme amaçlıdır; PowerShell, alana göre CompatiblePSEditions davranışı değiştirmez, ancak kendi mantığınız için nesnede PSModuleInfo (tarafından Get-Moduledöndürülen) kullanıma sunar:

$newModuleManifestSplat = @{
    Path = '.\TestModuleWithEdition.psd1'
    CompatiblePSEditions = 'Desktop', 'Core'
    PowerShellVersion = '5.1'
}
New-ModuleManifest @newModuleManifestSplat
$ModuleInfo = Test-ModuleManifest -Path .\TestModuleWithEdition.psd1
$ModuleInfo.CompatiblePSEditions

Desktop
Core

Not

CompatiblePSEditions Modül alanı yalnızca PowerShell 5.1 ve üzeri ile uyumludur. Bu alanı dahil etmek, bir modülün PowerShell 4 ve altıyla uyumsuz olmasına neden olur. Alan tamamen bilgilendirme amaçlı olduğundan, sonraki PowerShell sürümlerinde güvenle atlanabilir.

PowerShell 6.1'de, Get-Module -ListAvailable her modülün sürüm uyumluluğunu görüntülemek için biçimlendirici güncelleştirildi:

Get-Module -ListAvailable

    Directory: C:\Users\me\Documents\PowerShell\Modules

ModuleType Version    Name                   PSEdition ExportedCommands
---------- -------    ----                   --------- ----------------
Script     1.4.0      Az                     Core,Desk
Script     1.3.1      Az.Accounts            Core,Desk {Disable-AzDataCollection, Disable-AzContextAutosave, E...
Script     1.0.1      Az.Aks                 Core,Desk {Get-AzAks, New-AzAks, Remove-AzAks, Import-AzAksCreden...

...

Script     4.4.0      Pester                 Desk      {Describe, Context, It, Should...}
Script     1.18.0     PSScriptAnalyzer       Desk      {Get-ScriptAnalyzerRule, Invoke-ScriptAnalyzer, Invoke-...
Script     1.0.0      WindowsCompatibility   Core      {Initialize-WinSession, Add-WinFunction, Invoke-WinComm...

Windows'un bir parçası olarak gelen modüller için sürüm uyumluluğu

Windows'un parçası olarak gelen (veya bir rol veya özelliğin parçası olarak yüklenen) modüller için PowerShell 6.1 ve üzeri, alanı farklı şekilde ele CompatiblePSEditions alır. Bu tür modüller Windows PowerShell sistem modülleri dizininde (%windir%\System\WindowsPowerShell\v1.0\Modules) bulunur.

Bu dizinden yüklenen veya bu dizinde bulunan modüller için PowerShell 6.1 ve üzeri, modülün CompatiblePSEditions geçerli oturumla uyumlu olup olmadığını belirlemek için alanını kullanır ve uygun şekilde davranır.

kullanıldığındaImport-Module, içinde Core olmayan CompatiblePSEditions bir modül içeri aktarılmaz ve bir hata görüntülenir:

Import-Module BitsTransfer

Import-Module : Module 'C:\WINDOWS\system32\WindowsPowerShell\v1.0\Modules\BitsTransfer\BitsTransfer.psd1'
 does not support current PowerShell edition 'Core'. Its supported editions are 'Desktop'. Use 'Import-Module
 -SkipEditionCheck' to ignore the compatibility of this module.
At line:1 char:1
+ Import-Module BitsTransfer
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo          : ResourceUnavailable: (C:\WINDOWS\system32\u2026r\BitsTransfer.psd1:String)
 [Import-Module], InvalidOperationException
+ FullyQualifiedErrorId : Modules_PSEditionNotSupported,Microsoft.PowerShell.Commands.ImportModuleCommand

kullanıldığındaGet-Module -ListAvailable, içinde Core olmayan CompatiblePSEditions modüller görüntülenmez:

Get-Module -ListAvailable BitsTransfer

# No output

Her iki durumda -SkipEditionCheck da switch parametresi bu davranışı geçersiz kılmak için kullanılabilir:

Get-Module -ListAvailable -SkipEditionCheck BitsTransfer

    Directory: C:\WINDOWS\system32\WindowsPowerShell\v1.0\Modules

ModuleType Version    Name           PSEdition ExportedCommands
---------- -------    ----           --------- ----------------
Manifest   2.0.0.0    BitsTransfer   Desk      {Add-BitsFile, Complete-BitsTransfer, Get-BitsTransfer,...

Uyarı

Import-Module -SkipEditionCheck bir modül için başarılı gibi görünebilir, ancak bu modülün kullanılması daha sonra bir uyumsuzlukla karşılaşma riskini çalıştırır; modülü yüklenirken başlangıçta başarılı olan bir komut daha sonra uyumsuz bir API çağırabilir ve kendiliğinden başarısız olabilir.

Sürümler arası uyumluluk için PowerShell modülleri yazma

PowerShell'in hem hem de DesktopCore sürümlerini hedeflemek için bir PowerShell modülü yazarken, sürümler arası uyumluluğu sağlamak için yapabileceğiniz şeyler vardır.

Ancak uyumluluğu onaylamanın ve sürekli doğrulamanın tek gerçek yolu, betiğiniz veya modülünüz için testler yazmak ve bunları uyumluluğa ihtiyacınız olan tüm PowerShell sürümlerinde çalıştırmaktır. Bunun için önerilen bir test çerçevesi Pester'dır.

PowerShell betiği

Dil olarak PowerShell, sürümler arasında aynı şekilde çalışır; kullandığınız cmdlet'ler, modüller ve sürüm uyumluluğundan etkilenen .NET API'leridir.

Genel olarak, PowerShell 6.1 ve üzerinde çalışan betikler Windows PowerShell 5.1 ile çalışır, ancak bazı özel durumlar vardır.

PSScriptAnalyzer sürüm 1.18+ powershell betiklerinde komutların ve .NET API'lerinin uyumsuz kullanımını algılayabilen PSUseCompatibleCommands ve PSUseCompatibleTypes gibi kurallara sahiptir.

.NET derlemeleri

Bir ikili modül veya kaynak koddan oluşturulan .NET derlemelerini (DLL' ler) içeren bir modül yazıyorsanız, .NET ve PowerShell API uyumluluğunun derleme zamanı uyumluluğu doğrulaması için .NET Standard ve PowerShell Standard'a göre derlemeniz gerekir.

Bu kitaplıklar derleme zamanında bazı uyumluluğu denetlese de, sürümler arasındaki olası davranış farklılıklarını yakalayamaz. Bunun için yine de testler yazmanız gerekir.

Ayrıca bakınız

• about_Automatic_Variables
• Get-Module
• İçeri Aktarma Modülü
• Uyumlu PowerShell Sürümlerine sahip modüller