File tree Expand file tree Collapse file tree 5 files changed +84
-0
lines changed Expand file tree Collapse file tree 5 files changed +84
-0
lines changed Original file line number Diff line number Diff line change
1
+ # yaml-language-server: $schema=https://json-schema.org/draft/2020-12/schema
2
+ $schema : https://json-schema.org/draft/2020-12/schema
3
+ $id : <HOST>/<PREFIX>/<VERSION>/definitions/extensionCapabilities.yaml
4
+
5
+ title : Resource capabilities
6
+ description : >-
7
+ Define the operations DSC can invoke for an extension and how the extension behaves when invoked.
8
+
9
+ markdownDescription : |-
10
+ ***
11
+ [_Online Documentation_][00]
12
+ ***
13
+
14
+ DSC extensions always have at least one capability. Extension capabilities define the operations
15
+ DSC can invoke for an extension and how the extension behaves when invoked.
16
+
17
+ <!-- Link reference definitions -->
18
+ [00]: <DOCS_BASE_URL>/reference/schemas/definitions/extensionCapabilities?<DOCS_VERSION_PIN>
19
+
20
+ type : array
21
+ items :
22
+ type : string
23
+ enum :
24
+ - discover
25
+ markdownEnumDescriptions :
26
+ - |- # discover
27
+ ***
28
+ [_Online Documentation_][00]
29
+ ***
30
+
31
+ An extension with the `discover` capability supports retrieving the path to DSC resource
32
+ manifests that aren't included in the `PATH` or `DSC_RESOURCE_PATH`, like manifests for
33
+ software installed as AppX packages.
34
+
35
+ An extension has this capability when its manifest defines the [discover][02]
36
+ property.
37
+
38
+ <!-- Link reference definitions -->
39
+ [00]: <DOCS_BASE_URL>/reference/schemas/definitions/extensionCapabilities?<DOCS_VERSION_PIN>#discover
40
+ [02]: <DOCS_BASE_URL>/reference/schemas/extension/manifest/discover?<DOCS_VERSION_PIN>
File renamed without changes.
File renamed without changes.
File renamed without changes.
Original file line number Diff line number Diff line change
1
+ # yaml-language-server: $schema=https://json-schema.org/draft/2020-12/schema
2
+ $schema : https://json-schema.org/draft/2020-12/schema
3
+ $id : <HOST>/<PREFIX>/<VERSION>/outputs/extension/list.yaml
4
+
5
+ title : dsc extension list result
6
+ description : >-
7
+ Describes the return data for a DSC extension instance from the
8
+ `dsc extension list` command.
9
+
10
+ type : object
11
+ properties :
12
+ type :
13
+ $ref : /<PREFIX>/<VERSION>/definitions/extensionType.yaml
14
+ version :
15
+ $ref : /<PREFIX>/<VERSION>/definitions/semver.yaml
16
+ capabilities :
17
+ $ref : /<PREFIX>/<VERSION>/definitions/extensionCapabilities.yaml
18
+ description :
19
+ title : Extension description
20
+ description : >-
21
+ A short synopsis of the DSC extension's purpose.
22
+ # Should this include a maximum length or a pattern that forbids newlines?
23
+ type : string
24
+ path :
25
+ title : Path
26
+ description : >-
27
+ Indicates the path to the DSC extension on the file system.
28
+ type : string
29
+ directory :
30
+ title : Directory
31
+ description : >-
32
+ Indicates the path to the folder containing the DSC extension on the file
33
+ system.
34
+ type : string
35
+ author :
36
+ title : Author
37
+ description : >-
38
+ Indicates the name of the person or organization that developed and
39
+ maintains the DSC extension.
40
+ type :
41
+ - string
42
+ - ' null'
43
+ manifest :
44
+ $ref : /<PREFIX>/<VERSION>/extension/manifest.yaml
You can’t perform that action at this time.
0 commit comments