Merge pull request #235456 from danay1999/danay1999/update-bicep-functions-files

Updated bicep-functions-files.md

Author: prmerger-automator[bot]

articles/azure-resource-manager/bicep/bicep-functions-files.md

@@ -3,7 +3,7 @@ title: Bicep functions - files
 description: Describes the functions to use in a Bicep file to load content from a file.
 ms.topic: conceptual
 ms.custom: devx-track-bicep
-ms.date: 10/10/2022
+ms.date: 04/21/2023
 ---
 
 # File functions for Bicep
@@ -74,7 +74,49 @@ The following example creates a JSON file that contains values for a network sec
 
 You load that file and convert it to a JSON object. You use the object to assign values to the resource.
 
-::: code language="bicep" source="~/azure-docs-bicep-samples/syntax-samples/functions/loadJsonContent/loadsharedrules.bicep" highlight="3,13-21" :::
+::: code language="bicep" source="~/azure-docs-bicep-samples/syntax-samples/functions/loadJsonContent/loadsharedrules.bicep" highlight="3,12" :::
+
+You can reuse the file of values in other Bicep files that deploy a network security group.
+
+## loadYamlContent
+
+`loadYamlContent(filePath, [pathFilter], [encoding])`
+
+Loads the specified YAML file as an Any object.
+
+Namespace: [sys](bicep-functions.md#namespaces-for-functions).
+
+### Parameters
+
+| Parameter | Required | Type | Description |
+|:--- |:--- |:--- |:--- |
+| filePath | Yes | string | The path to the file to load. The path is relative to the deployed Bicep file. It can't include variables. |
+| pathFilter | No | string | The path filter is a JSONPath expression to specify that only part of the file is loaded. |
+| encoding | No | string | The file encoding. The default value is `utf-8`. The available options are: `iso-8859-1`, `us-ascii`, `utf-16`, `utf-16BE`, or `utf-8`.  |
+
+### Remarks
+
+Use this function when you have YAML content or minified YAML content that is stored in a separate file. Rather than duplicating the YAML content in your Bicep file, load the content with this function. You can load a part of a YAML file by specifying a path filer. The file is loaded when the Bicep file is compiled to the YAML template. You can't include variables in the file path because they haven't been resolved when compiling to the template. During deployment, the YAML template contains the contents of the file as a hard-coded string.
+
+In VS Code, the properties of the loaded object are available intellisense. For example, you can create a file with values to share across many Bicep files. An example is shown in this article.
+
+This function requires **Bicep version >0.16.2**.
+
+The maximum allowed size of the file is **1,048,576 characters**, including line endings.
+
+### Return value
+
+The contents of the file as an Any object.
+
+### Examples
+
+The following example creates a YAML file that contains values for a network security group.
+
+::: code language="yml" source="~/azure-docs-bicep-samples/syntax-samples/functions/loadYamlContent/nsg-security-rules.yaml" :::
+
+You load that file and convert it to a JSON object. You use the object to assign values to the resource.
+
+::: code language="bicep" source="~/azure-docs-bicep-samples/syntax-samples/functions/loadYamlContent/loadsharedrules.bicep" highlight="3,12" :::
 
 You can reuse the file of values in other Bicep files that deploy a network security group.
 

articles/azure-resource-manager/bicep/bicep-functions.md

@@ -3,7 +3,7 @@ title: Bicep functions
 description: Describes the functions to use in a Bicep file to retrieve values, work with strings and numerics, and retrieve deployment information.
 ms.topic: conceptual
 ms.custom: devx-track-bicep
-ms.date: 07/05/2022
+ms.date: 04/21/2023
 ---
 
 # Bicep functions
@@ -75,6 +75,7 @@ The following functions are available for loading the content from external file
 
 * [loadFileAsBase64](bicep-functions-files.md#loadfileasbase64)
 * [loadJsonContent](bicep-functions-files.md#loadjsoncontent)
+* [loadYamlContent](bicep-functions-files.md#loadyamlcontent)
 * [loadTextContent](bicep-functions-files.md#loadtextcontent)
 
 ## Lambda functions