Initial support for DSC v3 in WinGet-Create

[AmelBawa-msft]

⚙️ Settings DSC resource

📄 Get

PS C:\> wingetcreate dsc settings --get
{"settings":{"$schema":"https://aka.ms/wingetcreate-settings.schema.0.1.json","Telemetry":{"disable":true},"CleanUp":{"intervalInDays":7,"disable":false},"WindowsPackageManagerRepository":{"owner":"A","name":"B"},"Manifest":{"format":"yaml"},"Visual":{"anonymizePaths":true}}}

🖨️ Export

ℹ️ Settings resource Get and Export operation output states are identical.

PS C:\> wingetcreate dsc settings --export
{"settings":{"$schema":"https://aka.ms/wingetcreate-settings.schema.0.1.json","Telemetry":{"disable":true},"CleanUp":{"intervalInDays":7,"disable":false},"WindowsPackageManagerRepository":{"owner":"A","name":"B"},"Manifest":{"format":"yaml"},"Visual":{"anonymizePaths":true}}}

📝 Set

• Action Full: When action is set to Full, the specified settings will be update accordingly and the remaining settings will be set to their default values.
• Action Partial: When action is set to Partial, only the specified settings will be updated, and the remaining settings will remain unchanged.

🌕 Full

PS C:\> wingetcreate dsc settings --set '{"settings": { "Telemetry": { "disable": false }}, "action": "Full"}'
{"settings":{"$schema":"https://aka.ms/wingetcreate-settings.schema.0.1.json","Telemetry":{"disable":false},"CleanUp":{"intervalInDays":7,"disable":false},"WindowsPackageManagerRepository":{"owner":"microsoft","name":"winget-pkgs"},"Manifest":{"format":"yaml"},"Visual":{"anonymizePaths":true}},"action":"Full"}
["settings"]

🌗 Partial

PS C:\> wingetcreate dsc settings --set '{"settings": { "Telemetry": { "disable": true }}, "action": "Partial"}'
{"settings":{"$schema":"https://aka.ms/wingetcreate-settings.schema.0.1.json","Telemetry":{"disable":true},"CleanUp":{"intervalInDays":7,"disable":false},"WindowsPackageManagerRepository":{"owner":"microsoft","name":"winget-pkgs"},"Manifest":{"format":"yaml"},"Visual":{"anonymizePaths":true}},"action":"Partial"}
["settings"]

🧪 Test

• Action Full: When action is set to Full, the specified settings will be tested accordingly, and the remaining settings will be tested against their default values.
• Action Partial: When action is set to Partial, only the specified settings will be tested, and the remaining settings will be omitted from the test.

🌕 Full

PS C:\> wingetcreate dsc settings --test '{"settings": { "Telemetry": { "disable": false }}, "action": "Full"}'
{"settings":{"$schema":"https://aka.ms/wingetcreate-settings.schema.0.1.json","Telemetry":{"disable":true},"CleanUp":{"intervalInDays":7,"disable":false},"WindowsPackageManagerRepository":{"owner":"microsoft","name":"winget-pkgs"},"Manifest":{"format":"yaml"},"Visual":{"anonymizePaths":true}},"action":"Full","_inDesiredState":false}
["settings"]

🌗 Partial

PS C:\> wingetcreate dsc settings --test '{"settings": { "Telemetry": { "disable": false }}, "action": "Partial"}'
{"settings":{"$schema":"https://aka.ms/wingetcreate-settings.schema.0.1.json","Telemetry":{"disable":true},"CleanUp":{"intervalInDays":7,"disable":false},"WindowsPackageManagerRepository":{"owner":"microsoft","name":"winget-pkgs"},"Manifest":{"format":"yaml"},"Visual":{"anonymizePaths":true}},"action":"Partial","_inDesiredState":false}
["settings"]

[AmelBawa-msft]

/azp run

[azure-pipelines]

Azure Pipelines successfully started running 1 pipeline(s).

[AmelBawa-msft]

/azp run

[azure-pipelines]

Azure Pipelines successfully started running 1 pipeline(s).

[mdanish-kh]

This looks great!

(P.S. maybe you can modify the PR description for the new changes to command syntax to help others who will review this PR :D)

[AmelBawa-msft]

/azp run

[azure-pipelines]

Azure Pipelines successfully started running 1 pipeline(s).

[mdanish-kh]

We may also want to update the README and also the doc folder for the new dsc command

winget-create/README.md

Lines 43 to 57 in f26390d

	**WingetCreate** has the following commands:
	| Command | Description |
	| ------- | ----------- |
	| [New](doc/new.md) | Command for creating a new manifest from scratch |
	| [Update](doc/update.md) | Command for updating an existing manifest |
	| [New-Locale](doc/new-locale.md) | Command for creating a new locale for an existing manifest |
	| [Update-Locale](doc/update-locale.md) | Command for updating a locale for an existing manifest |
	| [Submit](doc/submit.md) | Command for submitting an existing PR |
	| [Show](doc/show.md) | Command for displaying existing manifests |
	| [Token](doc/token.md) | Command for managing cached GitHub personal access tokens |
	| [Settings](doc/settings.md) | Command for editing the settings file configurations |
	| [Cache](doc/cache.md) | Command for managing downloaded installers stored in cache
	| [Info](doc/info.md) | Displays information about the client |
	| [-?](doc/help.md) | Displays command line help |

[mdanish-kh]

thanks for the docs and bearing with me :D

[yao-msft]

/azp run

[azure-pipelines]

Azure Pipelines successfully started running 1 pipeline(s).

[AmelBawa-msft]

/azp run

[azure-pipelines]

Azure Pipelines successfully started running 1 pipeline(s).

[AmelBawa-msft]

/azp run

[azure-pipelines]

Azure Pipelines successfully started running 1 pipeline(s).