Change import type resource to a group type resource

[SteveL-MSFT]

PR Summary

The main problem with test and any import type resource is that the engine uses the user input/doc as the expected state. In this case, it's a pointer to a config file and an optional parameters file. So expected and desired would never match.

The change here is that an import kind of resource is no longer just a resource that the engine resolves, but is a type of group resource which is expected to resolve the configuration file to an actual configuration and execute the requested operation.

dsc here is used to implement the include resource which has a hidden as_include switch to tell itself it needs to resolve the configuration then act the same as a group resource. The validate operation now checks that the properties match an import configuration schema. Removed all the previous code where the engine perform the resolving import kind of resources and have test check if import kind, then just use the returned output (which is in the correct format already as a group resource) instead of trying to figure out expected/actual.

PR Context

Fixes incomplete functionality of include resource for test operation as the expected state was a redirection pointer than the resolved expected state.

Example output from test:

metadata:
  Microsoft.DSC:
    version: 3.0.0
    operation: Test
    executionType: Actual
    startDatetime: 2024-07-24T20:44:14.049535-07:00
    endDatetime: 2024-07-24T20:44:14.352636-07:00
    duration: PT0.303101S
    securityContext: Restricted
results:
- metadata:
    Microsoft.DSC:
      duration: PT0.181454S
  name: get os info
  type: Microsoft.DSC/Include
  result:
  - metadata:
      Microsoft.DSC:
        duration: PT0.069375S
    name: os
    type: Microsoft/OSInfo
    result:
      desiredState:
        family: macOS
      actualState:
        $id: https://developer.microsoft.com/json-schemas/dsc/os_info/20230303/Microsoft.Dsc.OS_Info.schema.json
        family: macOS
        version: 14.5.0
        bitness: '64'
        architecture: arm64
      inDesiredState: true
      differingProperties: []
  - metadata:
      Microsoft.DSC:
        duration: PT0.018143S
    name: another os instance
    type: Microsoft/OSInfo
    result:
      desiredState:
        family: macOS
      actualState:
        $id: https://developer.microsoft.com/json-schemas/dsc/os_info/20230303/Microsoft.Dsc.OS_Info.schema.json
        family: macOS
        version: 14.5.0
        bitness: '64'
        architecture: arm64
      inDesiredState: true
      differingProperties: []
  - metadata:
      Microsoft.DSC:
        duration: PT0.032894S
    name: path
    type: Test/Echo
    result:
      desiredState:
        output: /Users/steve/repos/DSC/bin/debug:/usr/local/microsoft/powershell/7-preview:/opt/homebrew/bin:/opt/homebrew/sbin:/Users/steve/.cargo/bin:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/local/bin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/bin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/appleinternal/bin:/Library/Apple/usr/bin:/usr/local/share/dotnet:~/.dotnet/tools:/Applications/iTerm.app/Contents/Resources/utilities:/Users/steve/.dotnet/tools
      actualState:
        output: /Users/steve/repos/DSC/bin/debug:/usr/local/microsoft/powershell/7-preview:/opt/homebrew/bin:/opt/homebrew/sbin:/Users/steve/.cargo/bin:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/local/bin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/bin:/var/run/com.apple.security.cryptexd/codex.system/bootstrap/usr/appleinternal/bin:/Library/Apple/usr/bin:/usr/local/share/dotnet:~/.dotnet/tools:/Applications/iTerm.app/Contents/Resources/utilities:/Users/steve/.dotnet/tools
      inDesiredState: true
      differingProperties: []
messages: []
hadErrors: false

[anmenaga]

It seems there is no value in using Join-Path when one of its arguments already contains the forward slash separators.

[SteveL-MSFT]

You're right that Join-Path isn't required here