Tried to add JSON Schema to VS Code and I can't get it to work

[IlleNilsson]

Added DSC V3 JSON Schema Uri to VS Code settings.json like this:

"yaml.format.singleQuote": true,
"yaml.schemaStore.enable": true,
"yaml.schemaStore.url": "https://www.schemastore.org/api/json/catalog.json",
"yaml.schemas": {
    "https://aka.ms/dsc/schemas/v3/bundled/config/document.json": []
}

Problems loading reference 'https://aka.ms/PowerShell/DSC/main/schemas/v3/config/document.resource.json': Unable to parse content from 'https://aka.ms/PowerShell/DSC/main/schemas/v3/config/document.resource.json': Parse error at offset 0.

Is what I get editing a DSC V3 document with: $schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json

Any ideas?

[Gijsreyn]

Hi @IlleNilsson,

I went through the same exercise, but slightly altered the example grabbed from this link.

{
    "json.schemas": [
        {
            "fileMatch": [
                "**/*.dsc.json",
                "**/*.dsc.config.json"
            ],
            "url": "https://aka.ms/dsc/schemas/v3/bundled/config/document.vscode.json"
        }
    ],
    "yaml.schemas": {
        "https://aka.ms/dsc/schemas/v3/bundled/config/document.vscode.json": "**.dsc.{yaml,yml,config.yaml,config.yml}"
    }
}

When I'm creating a file now in VSCode, it gives me the IntelliSense I'm looking for.

[IlleNilsson]

Thanks, I’ll try that

…

________________________________ From: Gijs Reijn ***@***.***> Sent: Friday, May 16, 2025 7:48:40 AM To: PowerShell/DSC ***@***.***> Cc: Ilian Nilsson ***@***.***>; Mention ***@***.***> Subject: Re: [PowerShell/DSC] Tried to add JSON Schema to VS Code and I can't get it to work (Discussion #815) Hi @IlleNilsson<https://github.com/IlleNilsson>, I went through the same exercise, but slightly altered the example grabbed from this link<https://learn.microsoft.com/en-us/powershell/dsc/concepts/enhanced-authoring?view=dsc-3.0#using-the-enhanced-configuration-document-schema>. { "json.schemas": [ { "fileMatch": [ "**/*.dsc.json", "**/*.dsc.config.json" ], "url": "https://aka.ms/dsc/schemas/v3/bundled/config/document.vscode.json" } ], "yaml.schemas": { "https://aka.ms/dsc/schemas/v3/bundled/config/document.vscode.json": "**.dsc.{yaml,yml,config.yaml,config.yml}" } } When I'm creating a file now in VSCode, it gives me the IntelliSense I'm looking for. image.png (view on web)<https://github.com/user-attachments/assets/8509b828-a3fc-45f8-8427-ece47c33990b> — Reply to this email directly, view it on GitHub<#815 (comment)>, or unsubscribe<https://github.com/notifications/unsubscribe-auth/AID6F4FAU3HLD6RX3NWZPHT26V33RAVCNFSM6AAAAAB5GIEIFSVHI2DSMVQWIX3LMV43URDJONRXK43TNFXW4Q3PNVWWK3TUHMYTGMJWGY3DCNY>. You are receiving this because you were mentioned.Message ID: ***@***.***>

[IlleNilsson]

Tried it and worked some what, getting errors on parameters and metadata json schema files

…

________________________________ From: Ilian Nilsson ***@***.***> Sent: Friday, May 16, 2025 8:09:23 AM To: PowerShell/DSC ***@***.***>; PowerShell/DSC ***@***.***> Cc: Mention ***@***.***> Subject: Re: [PowerShell/DSC] Tried to add JSON Schema to VS Code and I can't get it to work (Discussion #815) Thanks, I’ll try that

________________________________ From: Gijs Reijn ***@***.***> Sent: Friday, May 16, 2025 7:48:40 AM To: PowerShell/DSC ***@***.***> Cc: Ilian Nilsson ***@***.***>; Mention ***@***.***> Subject: Re: [PowerShell/DSC] Tried to add JSON Schema to VS Code and I can't get it to work (Discussion #815) Hi @IlleNilsson<https://github.com/IlleNilsson>, I went through the same exercise, but slightly altered the example grabbed from this link<https://learn.microsoft.com/en-us/powershell/dsc/concepts/enhanced-authoring?view=dsc-3.0#using-the-enhanced-configuration-document-schema>. { "json.schemas": [ { "fileMatch": [ "**/*.dsc.json", "**/*.dsc.config.json" ], "url": "https://aka.ms/dsc/schemas/v3/bundled/config/document.vscode.json" } ], "yaml.schemas": { "https://aka.ms/dsc/schemas/v3/bundled/config/document.vscode.json": "**.dsc.{yaml,yml,config.yaml,config.yml}" } } When I'm creating a file now in VSCode, it gives me the IntelliSense I'm looking for. image.png (view on web)<https://github.com/user-attachments/assets/8509b828-a3fc-45f8-8427-ece47c33990b> — Reply to this email directly, view it on GitHub<#815 (comment)>, or unsubscribe<https://github.com/notifications/unsubscribe-auth/AID6F4FAU3HLD6RX3NWZPHT26V33RAVCNFSM6AAAAAB5GIEIFSVHI2DSMVQWIX3LMV43URDJONRXK43TNFXW4Q3PNVWWK3TUHMYTGMJWGY3DCNY>. You are receiving this because you were mentioned.Message ID: ***@***.***>

[IlleNilsson]

Then we have an URI problem, should we use https://aka.ms/dsc/schemas/v3/bundled/config/document.json or https://aka.ms/dsc/schemas/v3/bundled/config/document**_.vscode_**.json

[Gijsreyn]

Both should work. The vscode one should have more IntelliSense, but you can open an issue if that doesn't work. I can't see your full error. Perhaps it relates to this one, then you can thumbs it up.

[IlleNilsson]

I have no idea, I'm a newbie to DSC v3 but not to v1 and 2. This is all new and we need more support to get going

[Gijsreyn]

[michaeltlombardi]

Then we have an URI problem, should we use https://aka.ms/dsc/schemas/v3/bundled/config/document.json or https://aka.ms/dsc/schemas/v3/bundled/config/document**_.vscode_**.json

The schemas with the .vscode.json are our enhanced authoring schemas - the reason we publish separate schemas for this purpose is that VS Code recognizes some extended vocabulary keywords that aren't part of the JSON Schema standard (such as markdownDescription and errorMessage). The YAML and JSON language servers use those keywords to dramatically improve the experience for authoring files to a schema that uses them, but few other tools will recognize those keywords. VS Code also requires slightly different structure for the defintions, because it doesn't support canonical bundling yet.

The other schemas we publish adhere to the 2020-12 draft of the JSON Schema standard and the files in the bundled folder use canonical bundling to reduce the number of network operations needed to use the schemas. The enhanced authoring schemas include extended documentation (so you don't need to open the docs online) and default snippets to make authoring resource manifests and configuration documents easier.