Experimental WinPowerShell DSC import extension

build.ps1

@@ -73,6 +73,7 @@ $filesForWindowsPackage = @(
     'sshdconfig.exe',
     'sshd-windows.dsc.resource.json',
     'sshd_config.dsc.resource.json',
+    'windowspowershell.dsc.extension.json',
     'windowspowershell.dsc.resource.json',
     'wmi.dsc.resource.json',
     'wmi.resource.ps1',
@@ -86,7 +87,7 @@ $filesForLinuxPackage = @(
     'bicep.dsc.extension.json',
     'dsc',
     'dsc_default.settings.json',
-    'dsc.settings.json'
+    'dsc.settings.json',
     'dscecho',
     'echo.dsc.resource.json',
     'assertion.dsc.resource.json',
@@ -111,7 +112,7 @@ $filesForMacPackage = @(
     'bicep.dsc.extension.json',
     'dsc',
     'dsc_default.settings.json',
-    'dsc.settings.json'
+    'dsc.settings.json',
     'dscecho',
     'echo.dsc.resource.json',
     'assertion.dsc.resource.json',
@@ -316,6 +317,7 @@ if (!$SkipBuild) {
         "dsc",
         "dscecho",
         "extensions/bicep",
+        "extensions/powershell"
         "osinfo",
         "powershell-adapter",
         'resources/PSScript',

dsc/examples/variable.dsc.ps1

@@ -0,0 +1,13 @@
+configuration VariableConfiguration {
+    Import-DscResource -ModuleName PSDesiredStateConfiguration
+    Node localhost
+    {
+        Environment PathEnvironmentVariable {
+            Name   = 'TestPathEnvironmentVariable'
+            Value  = 'TestValue'
+            Ensure = 'Present'
+            Path   = $true
+            Target = @('Process')
+        }
+    }
+}

dsc/tests/dsc_extension_discover.tests.ps1

@@ -23,30 +23,28 @@ Describe 'Discover extension tests' {
     It 'Discover extensions' {
         $out = dsc extension list | ConvertFrom-Json
         $LASTEXITCODE | Should -Be 0
-        if ($IsWindows) {
-            $out.Count | Should -Be 3 -Because ($out | Out-String)
-            $out[0].type | Should -Be 'Microsoft.DSC.Extension/Bicep'
-            $out[0].version | Should -Be '0.1.0'
-            $out[0].capabilities | Should -BeExactly @('import')
-            $out[0].manifest | Should -Not -BeNullOrEmpty
-            $out[1].type | Should -Be 'Microsoft.Windows.Appx/Discover'
-            $out[1].version | Should -Be '0.1.0'
-            $out[1].capabilities | Should -BeExactly @('discover')
-            $out[1].manifest | Should -Not -BeNullOrEmpty
-            $out[2].type | Should -BeExactly 'Test/Discover'
-            $out[2].version | Should -BeExactly '0.1.0'
-            $out[2].capabilities | Should -BeExactly @('discover')
-            $out[2].manifest | Should -Not -BeNullOrEmpty
+        $expectedExtensions = if ($IsWindows) {
+            @(
+            @{ type = 'Microsoft.DSC.Extension/Bicep'; version = '0.1.0'; capabilities = @('import') }
+            @{ type = 'Microsoft.DSC.Transitional/PSDesiredStateConfiguration'; version = '0.1.0'; capabilities = @('import') }
+            @{ type = 'Microsoft.Windows.Appx/Discover'; version = '0.1.0'; capabilities = @('discover') }
+            @{ type = 'Test/Discover'; version = '0.1.0'; capabilities = @('discover') }
+            )
         } else {
-            $out.Count | Should -Be 2 -Because ($out | Out-String)
-            $out[0].type | Should -Be 'Microsoft.DSC.Extension/Bicep'
-            $out[0].version | Should -Be '0.1.0'
-            $out[0].capabilities | Should -BeExactly @('import')
-            $out[0].manifest | Should -Not -BeNullOrEmpty
-            $out[1].type | Should -BeExactly 'Test/Discover'
-            $out[1].version | Should -BeExactly '0.1.0'
-            $out[1].capabilities | Should -BeExactly @('discover')
-            $out[1].manifest | Should -Not -BeNullOrEmpty
+            @(
+            @{ type = 'Microsoft.DSC.Extension/Bicep'; version = '0.1.0'; capabilities = @('import') }
+            @{ type = 'Test/Discover'; version = '0.1.0'; capabilities = @('discover') }
+            )
+        }
+
+        $out.Count | Should -Be $expectedExtensions.Count -Because ($out | Out-String)
+
+        foreach ($expected in $expectedExtensions) {
+            $extension = $out | Where-Object { $_.type -eq $expected.type }
+            $extension | Should -Not -BeNullOrEmpty -Because "Extension $($expected.type) should exist"
+            $extension.version | Should -BeExactly $expected.version
+            $extension.capabilities | Should -BeExactly $expected.capabilities
+            $extension.manifest | Should -Not -BeNullOrEmpty
         }
     }
 

extensions/powershell/convert-resource.ps1

@@ -0,0 +1,40 @@
+[CmdletBinding()]
+param (
+    [Parameter(ValueFromPipeline = $true)]
+    [string[]]$stringInput
+)
+
+begin {
+    $lines = [System.Collections.Generic.List[string]]::new()
+
+    if ($PSVersionTable.PSEdition -ne 'Core') {
+        # Remove all PowerShell paths
+        $env:PSModulePath = ($env:PSModulePath -split ';' | Where-Object { 
+            $_ -notmatch 'PowerShell[\\/]7' -and 
+            $_ -notmatch 'Program Files[\\/]PowerShell[\\/]' -and
+            $_ -notmatch 'Documents[\\/]PowerShell[\\/]'
+        }) -join ';'
+
+        # Make sure the default path is Windows PowerShell is included
+        $winPsPath = "$env:windir\System32\WindowsPowerShell\v1.0\Modules"
+        if ($env:PSModulePath -notmatch [regex]::Escape($winPsPath)) {
+            $env:PSModulePath = $env:PSModulePath + [System.IO.Path]::PathSeparator + $winPsPath
+        }
+    }
+
+    $scriptModule = Import-Module "$PSScriptRoot/convertDscResource.psd1" -Force -PassThru -WarningAction SilentlyContinue -ErrorAction Stop
+}
+
+process {
+    foreach ($line in $stringInput) {
+        $lines.Add($line)  
+    }
+}
+
+end {
+    if ($lines.Count -ne 0) {
+        $result = $scriptModule.invoke( { param($lines) Build-DscConfigDocument -Content $lines }, ($lines | Out-String) )
+
+        return ($result | ConvertTo-Json -Depth 10 -Compress)
+    }
+}

extensions/powershell/convertDscResource.psd1

@@ -0,0 +1,47 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+
+@{
+
+    # Script module or binary module file associated with this manifest.
+    RootModule        = 'convertDscResource.psm1'
+
+    # Version number of this module.
+    moduleVersion     = '0.0.1'
+
+    # ID used to uniquely identify this module
+    GUID              = '95f93fd3-34ff-417e-80e4-f0112918a0bd'
+
+    # Author of this module
+    Author            = 'Microsoft Corporation'
+
+    # Company or vendor of this module
+    CompanyName       = 'Microsoft Corporation'
+
+    # Copyright statement for this module
+    Copyright         = '(c) Microsoft Corporation. All rights reserved.'
+
+    # Description of the functionality provided by this module
+    Description       = 'PowerShell Desired State Configuration Module for converting DSC Resources to JSON format'
+
+    # Functions to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no functions to export.
+    FunctionsToExport = @(
+        'Write-DscTrace'
+        'Build-DscConfigDocument'
+    )
+
+    # Cmdlets to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no cmdlets to export.
+    CmdletsToExport   = @()
+
+    # Variables to export from this module
+    VariablesToExport = @()
+
+    # Aliases to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no aliases to export.
+    AliasesToExport   = @()
+
+    PrivateData       = @{
+        PSData = @{
+            ProjectUri = 'https://github.com/PowerShell/DSC'
+        }
+    }
+}