Merge pull request #301520 from mumian/0618-templates-deployer

Update template function deployer() with the new outputs

Author: v-regandowner

articles/azure-resource-manager/bicep/toc.yml

@@ -331,7 +331,7 @@ items:
       displayName: dateTimeAdd,dateTimeFromEpoch,dateTimeToEpoch,utcNow
       href: bicep-functions-date.md
     - name: Deployment functions
-      displayName: deployment,environment
+      displayName: deployer,deployment,environment
       href: bicep-functions-deployment.md
     - name: File functions
       displayName: loadFileAsBase64,loadJsonContent,loadYamlContent,loadTextContent
@@ -340,7 +340,7 @@ items:
       displayName: fail
       href: bicep-functions-flow-control.md
     - name: Lambda functions
-      displayName: filter,map,reduce,sort,toObject
+      displayName: filter,groupBy,map,mapValue,reduce,sort,toObject
       href: bicep-functions-lambda.md
     - name: Logical functions
       displayName: bool
@@ -349,13 +349,13 @@ items:
       displayName: int,max,min
       href: bicep-functions-numeric.md
     - name: Object functions
-      displayName: contains,empty,intersection,items,json,length,union
+      displayName: contains,empty,intersection,items,json,length,objectKeys,shallowMerge,union
       href: bicep-functions-object.md
     - name: Parameters file functions
       displayName: getSecret,readEnvironmentVariable
       href: bicep-functions-parameters-file.md
     - name: Resource functions
-      displayName: extensionResourceId,getSecret,list,pickZones,providers,reference,resourceId,subscriptionResourceId,managementGroupResourceId,tenantResourceId
+      displayName: extensionResourceId,getSecret,listAccountSas,ListKeys,listSecrets,list,managementGroupResourceId,pickZones,providers,reference,resourceId,subscriptionResourceId,tenantResourceId,toLogicalZone,toPhysicalZone
       href: bicep-functions-resource.md
     - name: Scope functions
       displayName: managementGroup,resourceGroup,subscription,tenant

articles/azure-resource-manager/templates/template-functions-deployment.md

@@ -3,7 +3,7 @@ title: Template functions - deployment
 description: Describes the functions to use in an Azure Resource Manager template (ARM template) to retrieve deployment information.
 ms.topic: reference
 ms.custom: devx-track-arm-template
-ms.date: 02/12/2025
+ms.date: 06/18/2025
 ---
 
 # Deployment functions for ARM templates
@@ -31,12 +31,13 @@ In Bicep, use the [deployer](../bicep/bicep-functions-deployment.md#deployer) fu
 
 ### Return value
 
-This function returns the information about the current deployment principal, including tenant ID and object ID.
+This function returns the information about the current deployment principal, including tenant ID, object ID, and user principal name.
 
 ```json
 {
   "objectId": "",
-  "tenantId": ""
+  "tenantId": "",
+  "userPrincipalName": ""
 }
 ```
 
@@ -63,7 +64,8 @@ The preceding example returns the following object:
 ```json
 {
   "objectId":"aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
-  "tenantId":"aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
+  "tenantId":"aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
+  "userPrincipalName":"[email protected]"
 }
 ```
 

articles/azure-resource-manager/templates/template-functions.md

@@ -222,8 +222,8 @@ Resource Manager provides several functions for working with objects.
 * [items](template-functions-object.md#items)
 * [json](template-functions-object.md#json)
 * [length](template-functions-object.md#length)
-* [objectKeys](template-functions-object.md#objectkeys)
 * [null](template-functions-object.md#null)
+* [objectKeys](template-functions-object.md#objectkeys)
 * [shallowMerge](template-functions-object.md#shallowmerge)
 * [union](template-functions-object.md#union)
 

articles/azure-resource-manager/templates/toc.yml

@@ -483,10 +483,10 @@ items:
       displayName: dateTimeAdd,dateTimeFromEpoch,dateTimeToEpoch,utcNow
       href: template-functions-date.md
     - name: Deployment functions
-      displayName: deployment,environment,parameters,variables
+      displayName: deployer,deployment,environment,parameters,variables
       href: template-functions-deployment.md
     - name: Lambda functions
-      displayName: filter,map,reduce,sort,toObject
+      displayName: filter,groupBy,map,reduce,sort,toObject
       href: template-functions-lambda.md
     - name: Logical functions
       displayName: and,bool,false,if,not,or,true
@@ -495,10 +495,10 @@ items:
       displayName: add,copyIndex,div,float,int,max,min,mod,mul,sub
       href: template-functions-numeric.md
     - name: Object functions
-      displayName: contains,createObject,empty,intersection,items,json,length,null,union
+      displayName: contains,createObject,empty,intersection,items,json,length,null,objectKeys,shallowMerge,union
       href: template-functions-object.md
     - name: Resource functions
-      displayName: extensionResourceId,list*,pickZones,providers,reference,references,resourceGroup,resourceId,subscription,subscriptionResourceId,managementGroupResourceId,tenantResourceId
+      displayName: extensionResourceId,listAccountSas,listKeys,listSecrets,list*,pickZones,providers,reference,references,resourceId,subscriptionResourceId,managementGroupResourceId,tenantResourceId
       href: template-functions-resource.md
     - name: Scope functions
       displayName: managementGroup,resourceGroup,subscription,tenant