Delen via

Script met compatibele PowerShell-edities

Vanaf versie 5.1 is PowerShell beschikbaar in verschillende edities die staan voor verschillende functies en platformcompatibiliteit.

  • Desktop Edition: gebouwd op .NET Framework en biedt compatibiliteit met scripts en modules die zijn gericht op versies van PowerShell die worden uitgevoerd op edities met volledige footprint van Windows, zoals Server Core en Windows Desktop.

  • Core Edition: gebouwd op .NET Core en biedt compatibiliteit met scripts en modules die zijn gericht op versies van PowerShell die worden uitgevoerd op edities met een verminderde footprint van Windows, zoals Nano Server en Windows IoT.

De actieve editie van PowerShell wordt weergegeven in de PSEdition-eigenschap van $PSVersionTable.

$PSVersionTable

Name                           Value
----                           -----
PSVersion                      5.1.14300.1000
PSEdition                      Desktop
PSCompatibleVersions           {1.0, 2.0, 3.0, 4.0...}
CLRVersion                     4.0.30319.42000
BuildVersion                   10.0.14300.1000
WSManStackVersion              3.0
PSRemotingProtocolVersion      2.3
SerializationVersion           1.1.0.1

Scriptauteurs kunnen voorkomen dat een script wordt uitgevoerd, tenzij het wordt uitgevoerd op een compatibele editie van PowerShell met behulp van de PSEdition-parameter op een #requires instructie.

Set-Content C:\script.ps1 -Value "#requires -PSEdition Core
Get-Process -Name PowerShell"
Get-Content C:\script.ps1
#requires -PSEdition Core
Get-Process -Name PowerShell

C:\script.ps1
C:\script.ps1 : The script 'script.ps1' cannot be run because it contained a "#requires" statement for PowerShell editions 'Core'. The edition of PowerShell that is required by the script does not match the currently running PowerShell Desktop edition.
At line:1 char:1
+ C:\script.ps1
+ ~~~~~~~~~~~~~
    + CategoryInfo          : NotSpecified: (script.ps1:String) [], RuntimeException
    + FullyQualifiedErrorId : ScriptRequiresUnmatchedPSEdition

Gebruikers van PowerShell Gallery kunnen de lijst met scripts vinden die worden ondersteund op een specifieke PowerShell-editie. Scripts zonder PSEdition_Desktop en PSEdition_Core-tags worden geacht goed te werken op de PowerShell Desktop-editie.

# Find scripts supported on PowerShell Desktop edition
Find-Script -Tag PSEdition_Desktop

# Find scripts supported on PowerShell Core edition
Find-Script -Tag PSEdition_Core

Meer informatie