PR Summary

This pull request introduces a new DSC v3 resource for managing PowerShell profiles across platforms, and integrates it as an experimental feature. The changes include adding resource and script files, updating build configurations to include these files, and modifying workflows to fetch the latest DSC package for CI. The most important changes are grouped below:

PowerShell Profile DSC Resource Implementation:

• Added new resource manifest (pwsh.profile.dsc.resource.json) and implementation script (pwsh.profile.resource.ps1) to enable management of PowerShell profiles via DSC v3. The resource supports operations to get, set, and export profile content for different profile types. [1] [2]

Experimental Feature Registration:

• Registered the new resource as an experimental feature PSProfileDSCResource in both configuration files (experimental-feature-linux.json, experimental-feature-windows.json) and in the engine code (ExperimentalFeature.cs). [1] [2] [3]

Build and Packaging Updates:

• Updated project files for both Unix (powershell-unix.csproj) and Windows (powershell-win-core.csproj) to include the new DSC resource files in the output and publish directories, ensuring they are shipped with builds. [1] [2]

CI Workflow Improvements:

• Enhanced GitHub Actions workflows for Linux and Windows to dynamically fetch and extract the latest DSC package version, ensuring up-to-date DSC binaries are used during CI runs. [1] [2]

(References: [1] [2] [3] [4] [5] [6] [7] [8] [9]

PR Context

Export all profiles:

 dsc resource export --resource Microsoft.PowerShell/Profile

  PS D:\PSGit\PowerShell> dsc resource export --resource Microsoft.PowerShell/Profile
  $schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
  contentVersion: 1.0.0
  resources:
  - type: Microsoft.PowerShell/Profile
    name: AllUsersCurrentHost
    properties:
      profileType: AllUsersCurrentHost
      content: "Write-Host 'Welcome to your PowerShell profile - AllUsersCurrentHost!'\r\n"
      _exist: true
  - type: Microsoft.PowerShell/Profile
    name: AllUsersAllHosts
    properties:
      profileType: AllUsersAllHosts
      content: "Write-Host 'Welcome to your PowerShell profile - AllUsersAllHosts!'\r\n"
      _exist: true
  - type: Microsoft.PowerShell/Profile
    name: CurrentUserAllHosts
    properties:
      profileType: CurrentUserAllHosts
      content: "# Test profile content currentuser allhosts\r\n"
      _exist: true
  - type: Microsoft.PowerShell/Profile
    name: CurrentUserCurrentHost
    properties:
      profileType: CurrentUserCurrentHost
      content: "Write-Host 'Welcome to your PowerShell profile - CurrentUserCurrentHost!'\r\n"
      _exist: true

Get current user all host

$i = @{ profileType = "CurrentUserAllHosts"} | ConvertTo-Json
dsc resource get --resource Microsoft.PowerShell/Profile -i $i
actualState:
  profileType: CurrentUserAllHosts
  content: '# Test profile content currentuser allhosts'

PR Checklist

• PR has a meaningful title
  • Use the present tense and imperative mood when describing your changes
• Summarized changes
• Make sure all .h, .cpp, .cs, .ps1 and .psm1 files have the correct copyright header
• This PR is ready to merge. If this PR is a work in progress, please open this as a Draft Pull Request and mark it as Ready to Review when it is ready to merge.
• Breaking changes
  • None
  • OR
  • Experimental feature(s) needed
    • Experimental feature name(s):
• User-facing changes
  • Not Applicable
  • OR
  • Documentation needed
    • Issue filed:
• Testing - New and feature
  • N/A or can only be tested interactively
  • OR
  • Make sure you've added a new test if existing tests do not effectively test the code changed