Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into rolyon-aadroles-admin-units-assign-roles-powershell-update

Author: rolyon

articles/applied-ai-services/form-recognizer/service-limits.md

@@ -3,12 +3,12 @@ title: Form Recognizer quotas and limits
 titleSuffix: Azure Applied AI Services
 description: Quick reference, detailed description, and best practices on Azure Form Recognizer service Quotas and Limits
 services: cognitive-services
-author: vkurpad
+author: laujan
 manager: nitinme
 ms.service: applied-ai-services
 ms.subservice: forms-recognizer
 ms.topic: conceptual
-ms.date: 02/15/2022
+ms.date: 05/09/2022
 ms.author: lajanuar
 ---
 

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

@@ -2,7 +2,7 @@
 title: Template functions - objects
 description: Describes the functions to use in an Azure Resource Manager template (ARM template) for working with objects.
 ms.topic: conceptual
-ms.date: 03/10/2022
+ms.date: 05/09/2022
 ---
 
 # Object functions for ARM templates
@@ -163,6 +163,146 @@ The output from the preceding example with the default values is:
 | objectOutput | Object | {"one": "a", "three": "c"} |
 | arrayOutput | Array | ["two", "three"] |
 
+## items
+
+`items(object)`
+
+Converts a dictionary object to an array.
+
+In Bicep, use the [items](../bicep/bicep-functions-object.md#items).
+
+### Parameters
+
+| Parameter | Required | Type | Description |
+|:--- |:--- |:--- |:--- |
+| object |Yes |object |The dictionary object to convert to an array. |
+
+### Return value
+
+An array of objects for the converted dictionary. Each object in the array has a `key` property that contains the key value for the dictionary. Each object also has a `value` property that contains the properties for the object.
+
+### Example
+
+The following example converts a dictionary object to an array. For each object in the array, it creates a new object with modified values.
+
+```json
+{
+  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
+  "contentVersion": "1.0.0.0",
+  "variables": {
+    "copy": [
+      {
+        "name": "modifiedListOfEntities",
+        "count": "[length(items(variables('entities')))]",
+        "input": {
+          "key": "[items(variables('entities'))[copyIndex('modifiedListOfEntities')].key]",
+          "fullName": "[items(variables('entities'))[copyIndex('modifiedListOfEntities')].value.displayName]",
+          "itemEnabled": "[items(variables('entities'))[copyIndex('modifiedListOfEntities')].value.enabled]"
+        }
+      }
+    ],
+    "entities": {
+      "item002": {
+        "enabled": false,
+        "displayName": "Example item 2",
+        "number": 200
+      },
+      "item001": {
+        "enabled": true,
+        "displayName": "Example item 1",
+        "number": 300
+      }
+    }
+  },
+  "resources": [],
+  "outputs": {
+    "modifiedResult": {
+      "type": "array",
+      "value": "[variables('modifiedListOfEntities')]"
+    }
+  }
+}
+```
+
+The preceding example returns:
+
+```json
+"modifiedResult": {
+  "type": "Array",
+  "value": [
+    {
+      "fullName": "Example item 1",
+      "itemEnabled": true,
+      "key": "item001"
+    },
+    {
+      "fullName": "Example item 2",
+      "itemEnabled": false,
+      "key": "item002"
+    }
+  ]
+}
+```
+
+The following example shows the array that is returned from the items function.
+
+```json
+{
+  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
+  "contentVersion": "1.0.0.0",
+  "variables": {
+    "entities": {
+      "item002": {
+        "enabled": false,
+        "displayName": "Example item 2",
+        "number": 200
+      },
+      "item001": {
+        "enabled": true,
+        "displayName": "Example item 1",
+        "number": 300
+      }
+    },
+    "entitiesArray": "[items(variables('entities'))]"
+  },
+  "resources": [],
+  "outputs": {
+    "itemsResult": {
+      "type": "array",
+      "value": "[variables('entitiesArray')]"
+    }
+  }
+}
+```
+
+The example returns:
+
+```json
+"itemsResult": {
+  "type": "Array",
+  "value": [
+    {
+      "key": "item001",
+      "value": {
+        "displayName": "Example item 1",
+        "enabled": true,
+        "number": 300
+      }
+    },
+    {
+      "key": "item002",
+      "value": {
+        "displayName": "Example item 2",
+        "enabled": false,
+        "number": 200
+      }
+    }
+  ]
+}
+```
+
+The items() function sorts the objects in the alphabetical order. For example, **item001** appears before **item002** in the outputs of the two preceding samples.
+
 <a id="json"></a>
 
 ## json

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

@@ -164,6 +164,7 @@ Resource Manager provides several functions for working with objects.
 * [createObject](template-functions-object.md#createobject)
 * [empty](template-functions-object.md#empty)
 * [intersection](template-functions-object.md#intersection)
+* [items](template-functions-object.md#items)
 * [json](template-functions-object.md#json)
 * [length](template-functions-object.md#length)
 * [null](template-functions-object.md#null)

articles/expressroute/media/designing-for-disaster-recovery-with-expressroute-pvt/configure-weight.png

@@ -604,6 +604,9 @@
       - name: Store scripts
         displayName: Image builder, images, building, scripts
         href: ./linux/image-builder-user-assigned-identity.md
+      - name: What's new in Azure Image Builder
+        displayName: Image builder, images, building, api, features, updates, change log
+        href: image-builder-api-update-release-notes.md
       - name: Troubleshoot
         displayName: Image builder, images, building
         href: ./linux/image-builder-troubleshoot.md

articles/traffic-manager/media/traffic-manager-nested-profiles/figure-11.png

@@ -0,0 +1,93 @@
+---
+title: What's new in Azure Image Builder 
+description: Learn what is new with Azure Image Builder; such as the latest release notes, known issues, bug fixes, deprecated functionality, and upcoming changes.
+author: kof-f
+ms.service: virtual-machines
+ms.topic: conceptual
+ms.workload: infrastructure
+ms.date: 04/04/2022
+ms.reviewer: erd
+ms.subservice: image-builder
+ms.custom: references_regions
+
+
+---
+
+# What's new in Azure Image Builder
+
+**Applies to:** :heavy_check_mark: Linux VMs :heavy_check_mark: Windows VMs :heavy_check_mark: Flexible scale sets :heavy_check_mark: Uniform scale sets
+
+This document contains all major API changes and feature updates for the Azure Image Builder service.
+
+## API Releases
+
+
+
+
+### 2021-10-01
+
+**Breaking Change**:
+ 
+Our 2021-10-01 API introduces a change to the error schema that will be part of every future API release. Any Azure Image Builder automations you may have need to take account the new error output when switching to 2021-10-01 or newer API versions (new schema shown below). We recommend that once customers switch to the new API version (2021-10-01 and beyond), they don't revert to older versions as they'll have to change their automation again to expect the older error schema. We don't anticipate changing the error schema again in future releases.
+
+For API versions 2020-02-14 and older, the error output will look like the following messages:
+
+```
+{ 
+"error": {
+ "code": "ValidationFailed",
+  "message": "Validation failed: 'ImageTemplate.properties.source': Field 'imageId' has a bad value: '/subscriptions/subscriptionID/resourceGroups/resourceGroupName/providers/Microsoft.Compute//images//imageName'. Please review  http://aka.ms/azvmimagebuildertmplref  for details on fields requirements in the Image Builder Template." 
+} 
+```
+
+
+For API versions 2021-10-01 and newer, the error output will look like the following messages:
+
+```
+{ 
+  "error": { 
+    "code": "ValidationFailed", 
+    "message": "Validation failed: 'ImageTemplate.properties.source': Field 'imageId' has a bad value: '/subscriptions/subscriptionID/resourceGroups/resourceGroupName/providers/Microsoft.Compute//images//imageName'. Please review  http://aka.ms/azvmimagebuildertmplref  for details on fields requirements in the Image Builder Template." 
+  } 
+} 
+```
+
+**Improvements**:
+
+- Added support for [Build VM MSIs](linux/image-builder-json.md#user-assigned-identity-for-the-image-builder-build-vm).
+- Added support for Proxy VM size customization.
+
+### 2020-02-14
+
+
+
+**Improvements:**
+
+- Added support for creating images from the following sources:
+    - Managed Image
+    - Azure Compute Gallery
+    - Platform Image Repository (including Platform Image Purchase Plan)
+- Added support for the following customizations:
+    - Shell (Linux) - Script or Inline
+    - PowerShell (Windows) - Script or Inline, run elevated, run as system
+    - File (Linux and Windows)
+    - Windows Restart (Windows)
+    - Windows Update (Windows) (with search criteria, filters, and update limit)
+- Added support for the following distribution types:
+    - VHD
+    - Managed Image
+    - Azure Compute Gallery
+- **Other Features**
+    - Added support for customers to use their own VNet.
+    - Added support for customers to customize the build VM (VM size, OS disk size).
+    - Added support for user assigned MSI (for customize/distribute steps).
+    - Added support for [Gen2 images.](image-builder-overview.md#hyper-v-generation).
+
+### Preview APIs
+
+ The following APIs are deprecated, but still supported:
+- 2019-05-01-preview
+
+
+## Next steps
+Learn more about [Image Builder](image-builder-overview.md).