Fix input parameters

Author: Gijsreyn

.vscode/docs.code-snippets

@@ -51,7 +51,7 @@
 			"```",
 			"",
 			"```bash",
-			"dsc config get --document ${1:name}.example.1.dsc.config.yaml",
+			"dsc config get --file ${1:name}.example.1.dsc.config.yaml",
 			"```",
 			"",
 			"```yaml",
@@ -110,7 +110,7 @@
 			"```",
 			"",
 			"```bash",
-			"dsc config get --document ${TM_FILENAME_BASE}.example.$1.dsc.config.yaml",
+			"dsc config get --file ${TM_FILENAME_BASE}.example.$1.dsc.config.yaml",
 			"```",
 			"",
 			"```yaml",

docs/reference/cli/config/set.md

@@ -80,22 +80,22 @@ cat ./example.dsc.config.yaml | dsc config set --file -
 
 <a id="example-2"></a>
 
-The command uses the **path** option to enforce the configuration defined in the
+The command uses the **file** option to enforce the configuration defined in the
 `example.dsc.config.yaml` file.
 
 ```sh
-dsc config set --path ./example.dsc.config.yaml
+dsc config set --file ./example.dsc.config.yaml
 ```
 
 ### Example 3 - Passing a configuration document as a variable
 
 <a id="example-3"></a>
 
-The command uses the **document** option to enforce the configuration stored in the `$desired`
+The command uses the **input** option to enforce the configuration stored in the `$desired`
 variable.
 
 ```sh
-dsc config set --document $desired
+dsc config set --input $desired
 ```
 
 ## Options

docs/reference/cli/config/test.md

@@ -22,7 +22,7 @@ dsc config test [Options] --file <FILE>
 ### Configuration document from option string
 
 ```sh
-dsc config test [Options] --document <INPUT>
+dsc config test [Options] --input <INPUT>
 ```
 
 ### Configuration document from stdin

docs/reference/schemas/config/functions/add.md

@@ -39,7 +39,7 @@ resources:
 ```
 
 ```bash
-dsc config get --document add.example.1.dsc.config.yaml 
+dsc config get --file add.example.1.dsc.config.yaml 
 ```
 
 ```yaml
@@ -69,7 +69,7 @@ resources:
 ```
 
 ```bash
-dsc config get --document add.example.2.dsc.config.yaml
+dsc config get --file add.example.2.dsc.config.yaml
 ```
 
 ```yaml

docs/reference/schemas/config/functions/base64.md

@@ -40,7 +40,7 @@ resources:
 ```
 
 ```bash
-dsc --input-file base64.example.1.dsc.config.yaml config get
+dsc --file base64.example.1.dsc.config.yaml config get
 ```
 
 ```yaml
@@ -70,7 +70,7 @@ resources:
 ```
 
 ```bash
-dsc --input-file base64.example.2.dsc.config.yaml config get
+dsc --file base64.example.2.dsc.config.yaml config get
 ```
 
 ```yaml

docs/reference/schemas/config/functions/concat.md

@@ -44,7 +44,7 @@ resources:
 ```
 
 ```bash
-dsc --input-file concat.example.1.dsc.config.yaml config get
+dsc config get --file concat.example.1.dsc.config.yaml
 ```
 
 ```yaml
@@ -77,7 +77,7 @@ resources:
 ```
 
 ```bash
-dsc config get --document concat.example.2.dsc.config.yaml
+dsc config get --file concat.example.2.dsc.config.yaml
 ```
 
 ```yaml

docs/reference/schemas/config/functions/createArray.md

@@ -42,7 +42,7 @@ resources:
 ```
 
 ```bash
-dsc config get --document createArray.example.1.dsc.config.yaml config get
+dsc config get --file createArray.example.1.dsc.config.yaml config get
 ```
 
 ```yaml
@@ -75,7 +75,7 @@ resources:
 ```
 
 ```bash
-dsc config get --document createArray.example.2.dsc.config.yaml
+dsc config get --file createArray.example.2.dsc.config.yaml
 ```
 
 ```yaml
@@ -115,7 +115,7 @@ resources:
 ```
 
 ```bash
-dsc config get --document createArray.example.3.dsc.config.yaml
+dsc config get --file createArray.example.3.dsc.config.yaml
 ```
 
 ```yaml

docs/reference/schemas/config/functions/div.md

@@ -41,7 +41,7 @@ resources:
 ```
 
 ```bash
-dsc config get --document div.example.1.dsc.config.yaml config get
+dsc config get --file div.example.1.dsc.config.yaml config get
 ```
 
 ```yaml
@@ -72,7 +72,7 @@ resources:
 ```
 
 ```bash
-dsc config get --document div.example.2.dsc.config.yaml
+dsc config get --file div.example.2.dsc.config.yaml
 ```
 
 ```yaml

docs/reference/schemas/config/functions/format.md

@@ -0,0 +1,131 @@
+---
+description: Reference for the 'format' DSC configuration document function
+ms.date:     02/28/2025
+ms.topic:    reference
+title:       format
+---
+
+# format
+
+## Synopsis
+
+Returns a formatted string that uses placeholders to insert values.
+
+## Syntax
+
+```Syntax
+format(<formatString>, <arg1>, <arg2>, ...)
+```
+
+## Description
+
+The `format()` function returns a string that includes formatted values using a template and
+placeholders. Each placeholder in the template string is replaced with the corresponding argument
+value. Placeholders are specified with curly braces around the zero-based index of the argument.
+
+## Examples
+
+### Example 1 - Format a simple string
+
+The configuration formats a string with two placeholders.
+
+```yaml
+# format.example.1.dsc.config.yaml
+$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
+resources:
+  - name: Echo formatted string
+    type: Microsoft.DSC.Debug/Echo
+    properties:
+        output: "[format('Hello, {0}! Today is {1}.', 'World', 'Monday')]"
+```
+
+```bash
+dsc config get --file format.example.1.dsc.config.yaml
+```
+
+```yaml
+results:
+- name: Echo formatted string
+    type: Microsoft.DSC.Debug/Echo
+    result:
+        actualState:
+            output: Hello, World! Today is Monday.
+messages: []
+hadErrors: false
+```
+
+### Example 2 - Format a string with parameters
+
+The configuration uses other functions within the `format()` function to build a dynamic message.
+
+```yaml
+# format.example.2.dsc.config.yaml
+$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
+parameters:
+  username:
+    type: string
+    defaultValue: Mikey
+  hour:
+    type: string
+    defaultValue: "09"
+  minute:
+    type: string
+    defaultValue: "30"
+resources:
+  - name: Echo dynamic formatted string
+    type: Microsoft.DSC.Debug/Echo
+    properties:
+      output: "[format('Hello, {0}! The time is {1}:{2}.', parameters('username'), parameters('hour'), parameters('minute'))]"
+```
+
+```bash
+dsc --file format.example.2.dsc.config.yaml config get
+```
+
+```yaml
+results:
+- metadata:
+    Microsoft.DSC:
+      duration: PT0.0185508S
+  name: Echo dynamic formatted string
+  type: Microsoft.DSC.Debug/Echo
+  result:
+    actualState:
+      output: Hello, Mikey! The time is 09:30.
+messages: []
+hadErrors: false
+```
+
+## Parameters
+
+### formatString
+
+The `format()` function requires a template string that includes placeholders for argument values.
+Placeholders use the format `{n}`, where `n` is the zero-based index of the argument to insert.
+
+```yaml
+Type:         string
+Required:     true
+MinimumCount: 1
+MaximumCount: 1
+```
+
+### arguments
+
+The function accepts one or more arguments of any type to insert into the formatted string.
+
+```yaml
+Type:         any
+Required:     true
+MinimumCount: 1
+MaximumCount: unlimited
+```
+
+## Output
+
+The `format()` function returns a string where each placeholder in the **formatString** is replaced
+with the corresponding argument value.
+
+```yaml
+Type: string
+```

docs/reference/schemas/config/functions/int.md

@@ -40,7 +40,7 @@ resources:
 ```
 
 ```bash
-dsc config get --document int.example.1.dsc.config.yaml config get
+dsc config get --file int.example.1.dsc.config.yaml config get
 ```
 
 ```yaml