Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into aznet-0414

Author: mbender-ms

articles/active-directory-b2c/find-help-open-support-ticket.md

@@ -75,10 +75,13 @@ If you're unable to find answers by using self-help resources, you can open an o
 
     1. Select a **[Severity](https://azure.microsoft.com/support/plans/response)**, and your preferred contact method.
 
+    > [!NOTE]
+    > Under **Advanced diagnostic information**, it's highly recommended that you allow the collection of advanced information by selecting **Yes**. It enables Microsoft support team to investigate the issue faster.
 
     :::image type="content" source="media/find-help-and-submit-support-ticket/find-help-and-submit-support-ticket-1.png" alt-text="Screenshot of how to find help and submit support ticket part 1.":::
 
     :::image type="content" source="media/find-help-and-submit-support-ticket/find-help-and-submit-support-ticket-2.png" alt-text="Screenshot of how to find help and submit support ticket part 2.":::
+
 
 1. Select **Next**. Under **4. Review + create**, you'll see a summary of your support ticket. 
 

articles/active-directory/app-provisioning/define-conditional-rules-for-provisioning-user-accounts.md

@@ -84,7 +84,7 @@ Scoping filters are configured as part of the attribute mappings for each Azure
 
    g. **REGEX MATCH**. Clause returns "true" if the evaluated attribute matches a regular expression pattern. For example: ([1-9][0-9]) matches any number between 10 and 99 (case sensitive).
 
-   h. **NOT REGEX MATCH**. Clause returns "true" if the evaluated attribute doesn't match a regular expression pattern.
+   h. **NOT REGEX MATCH**. Clause returns "true" if the evaluated attribute doesn't match a regular expression pattern. It will return "false" if the attribute is null / empty.
 
    i. **Greater_Than.** Clause returns "true" if the evaluated attribute is greater than the value. The value specified on the scoping filter must be an integer and the attribute on the user must be an integer [0,1,2,...]. 
 
@@ -97,6 +97,7 @@ Scoping filters are configured as part of the attribute mappings for each Azure
 > - The IsMemberOf filter is not supported currently.
 > - The members attribute on a group is not supported currently.
 > - EQUALS and NOT EQUALS are not supported for multi-valued attributes
+> - Scoping filters will return "false" if the value is null / empty
 
 9. Optionally, repeat steps 7-8 to add more scoping clauses.
 

articles/active-directory/app-provisioning/functions-for-customizing-application-data.md

@@ -7,7 +7,7 @@ ms.service: active-directory
 ms.subservice: app-provisioning
 ms.workload: identity
 ms.topic: reference
-ms.date: 02/16/2022
+ms.date: 04/13/2022
 ms.author: kenwith
 ms.reviewer: arvinh
 ---
@@ -1237,6 +1237,18 @@ Generate a user alias by taking first three letters of user's first name and fir
 * **INPUT** (surname): "Doe"
 * **OUTPUT**:  "JohDoe"
 
+### Add a comma between last name and first name. 
+Add a comma between last name and first name. 
+
+**Expression:** 
+`Join(", ", "", [surname], [givenName])`
+
+**Sample input/output:** 
+
+* **INPUT** (givenName): "John"
+* **INPUT** (surname): "Doe"
+* **OUTPUT**:  "Doe, John"
+
 
 ## Related Articles
 * [Automate User Provisioning/Deprovisioning to SaaS Apps](../app-provisioning/user-provisioning.md)

articles/active-directory/app-provisioning/on-premises-application-provisioning-architecture.md

@@ -13,7 +13,7 @@ ms.author: billmath
 ms.collection: M365-identity-device-management
 ---
 
-# Azure AD on-premises application provisioning architecture (preview)
+# Azure AD on-premises application identity provisioning architecture (preview)
 
 ## Overview
 
@@ -97,10 +97,6 @@ You can define one or more matching attribute(s) and prioritize them based on th
 ## Provisioning agent questions
 Some common questions are answered here.
 
-### What is the GA version of the provisioning agent?
-
-For the latest GA version of the provisioning agent, see [Azure AD connect provisioning agent: Version release history](provisioning-agent-release-version-history.md).
-
 ### How do I know the version of my provisioning agent?
 
  1. Sign in to the Windows server where the provisioning agent is installed.
@@ -138,19 +134,19 @@ You can also check whether all the required ports are open.
      - Microsoft Azure AD Connect Agent Updater
      - Microsoft Azure AD Connect Provisioning Agent Package
 
-### Provisioning agent history
+## Provisioning agent history
 This article lists the versions and features of Azure Active Directory Connect Provisioning Agent that have been released. The Azure AD team regularly updates the Provisioning Agent with new features and functionality. Please ensure that you do not use the same agent for on-prem provisioning and Cloud Sync / HR-driven provisioning.
 
 Microsoft provides direct support for the latest agent version and one version before.
 
-## Download link
+### Download link
 You can download the latest version of the agent using [this link](https://aka.ms/onpremprovisioningagent).
 
-## 1.1.846.0
+### 1.1.846.0
 
 April 11th, 2022 - released for download
 
-### Fixed issues
+#### Fixed issues
 
 - We added support for ObjectGUID as an anchor for the generic LDAP connector when provisioning users into AD LDS. 
 

articles/api-management/api-management-api-import-restrictions.md

@@ -141,6 +141,15 @@ For each operation found in the OpenAPI document, a new operation will be create
         * Length is limited to 300 characters.
     * If `summary` isn't specified (not present, `null`, or empty), display name value will set to `operationId`. 
 
+**Normalization rules for `operationId`**
+- Convert to lower case.
+- Replace each sequence of non-alphanumeric characters with a single dash.
+    - For example, `GET-/foo/{bar}?buzz={quix}` will be transformed into `get-foo-bar-buzz-quix-`.
+- Trim dashes on both sides.
+    - For example, `get-foo-bar-buzz-quix-` will become `get-foo-bar-buzz-quix`
+- Truncate to fit 76 characters, four characters less than maximum limit for a resource name.
+- Use remaining four characters for a de-duplication suffix, if necessary, in the form of `-1, -2, ..., -999`.
+
 ### Update an existing API via OpenAPI import
 
 During import, the existing API operation:
@@ -159,12 +168,6 @@ To make import more predictable, follow these guidelines:
 - Refrain from changing `operationId` after initial import.
 - Never change `operationId` and HTTP method or path template at the same time.
 
-### Export API as OpenAPI
-
-For each operation, its:
-* Azure resource name will be exported as an `operationId`.
-* Display name will be exported as a `summary`.
-
 **Normalization rules for `operationId`**
 - Convert to lower case.
 - Replace each sequence of non-alphanumeric characters with a single dash.
@@ -174,6 +177,14 @@ For each operation, its:
 - Truncate to fit 76 characters, four characters less than maximum limit for a resource name.
 - Use remaining four characters for a de-duplication suffix, if necessary, in the form of `-1, -2, ..., -999`.
 
+### Export API as OpenAPI
+
+For each operation, its:
+* Azure resource name will be exported as an `operationId`.
+* Display name will be exported as a `summary`.
+
+Note that normalization of the `operationId` is done on import, not on export.
+
 ## <a name="wsdl"> </a>WSDL
 
 You can create [SOAP pass-through](import-soap-api.md) and [SOAP-to-REST](restify-soap-api.md) APIs with WSDL files.

articles/app-service/networking/nat-gateway-integration.md

@@ -8,7 +8,7 @@ ms.assetid: 0a84734e-b5c1-4264-8d1f-77e781b28426
 ms.service: app-service
 ms.workload: web
 ms.topic: article
-ms.date: 08/04/2021
+ms.date: 04/08/2022
 ms.author: madsd
 ms.custom: seodec18, devx-track-azurecli 
 ms.devlang: azurecli
@@ -26,7 +26,7 @@ For more information and pricing. Go to the [NAT gateway overview](../../virtual
 :::image type="content" source="./media/nat-gateway-integration/nat-gateway-overview.png" alt-text="Diagram shows Internet traffic flowing to a NAT gateway in an Azure Virtual Network.":::
 
 > [!Note] 
-> * Using NAT gateway with App Service is dependent on virtual network integration, and therefore **Standard**, **Premium**, **PremiumV2** or **PremiumV3** App Service plan is required.
+> * Using NAT gateway with App Service is dependent on virtual network integration, and therefore a supported App Service plan pricing tier is required.
 > * When using NAT gateway together with App Service, all traffic to Azure Storage must be using private endpoint or service endpoint.
 > * NAT gateway cannot be used together with App Service Environment v1 or v2.
 

articles/app-service/overview-vnet-integration.md

@@ -3,7 +3,7 @@ title: Integrate your app with an Azure virtual network
 description: Integrate your app in Azure App Service with Azure virtual networks.
 author: madsd
 ms.topic: conceptual
-ms.date: 03/04/2022
+ms.date: 04/08/2022
 ms.author: madsd
 
 ---
@@ -158,7 +158,7 @@ After your app integrates with your virtual network, it uses the same DNS server
 
 There are some limitations with using regional virtual network integration:
 
-* The feature is available from all App Service deployments in Premium v2 and Premium v3. It's also available in Standard but only from newer App Service deployments. If you're on an older deployment, you can only use the feature from a Premium v2 App Service plan. If you want to make sure you can use the feature in a Standard App Service plan, create your app in a Premium v3 App Service plan. Those plans are only supported on our newest deployments. You can scale down if you want after the plan is created.
+* The feature is available from all App Service deployments in Premium v2 and Premium v3. It's also available in Basic and Standard tier but only from newer App Service deployments. If you're on an older deployment, you can only use the feature from a Premium v2 App Service plan. If you want to make sure you can use the feature in a Standard App Service plan, create your app in a Premium v3 App Service plan. Those plans are only supported on our newest deployments. You can scale down if you want after the plan is created.
 * The feature can't be used by Isolated plan apps that are in an App Service Environment.
 * You can't reach resources across peering connections with classic virtual networks.
 * The feature requires an unused subnet that's an IPv4 `/28` block or larger in an Azure Resource Manager virtual network.
@@ -257,7 +257,7 @@ The regional virtual network integration feature has no extra charge for use bey
 
 Three charges are related to the use of the gateway-required virtual network integration feature:
 
-* **App Service plan pricing tier charges**: Your apps need to be in a Standard, Premium, Premium v2, or Premium v3 App Service plan. For more information on those costs, see [App Service pricing](https://azure.microsoft.com/pricing/details/app-service/).
+* **App Service plan pricing tier charges**: Your apps need to be in a Basic, Standard, Premium, Premium v2, or Premium v3 App Service plan. For more information on those costs, see [App Service pricing](https://azure.microsoft.com/pricing/details/app-service/).
 * **Data transfer costs**: There's a charge for data egress, even if the virtual network is in the same datacenter. Those charges are described in [Data transfer pricing details](https://azure.microsoft.com/pricing/details/data-transfers/).
 * **VPN gateway costs**: There's a cost to the virtual network gateway that's required for the point-to-site VPN. For more information, see [VPN gateway pricing](https://azure.microsoft.com/pricing/details/vpn-gateway/).
 

articles/applied-ai-services/form-recognizer/concept-read.md

@@ -15,15 +15,15 @@ ms.custom: ignite-fall-2021
 
 # Form Recognizer read model
 
-The prebuilt-read model extracts printed and handwritten textual elements including lines, words, locations, and detected languages from documents (PDF and TIFF) and images (JPG, PNG, and BMP). The read model is the foundation for all Form Recognizer models. Layout, general document, custom, and prebuilt models use the prebuilt-read model as a basis for extracting text from documents.
+The Form Recognizer v3.0 preview includes the new Read API. Read extracts printed and handwritten from documents. The read model can detect lines, words, locations, and languages and is the core of all the other Form Recognizer models. Layout, general document, custom, and prebuilt models all use the read model as a foundation for extracting texts from documents.
 
 ## Development options
 
 The following resources are supported by Form Recognizer v3.0:
 
 | Feature | Resources | Model ID |
 |----------|------------|------------|
-|**Read model**| <ul><li>[**Form Recognizer Studio**](https://formrecognizer.appliedai.azure.com)</li><li>[**REST API**](https://westus.dev.cognitive.microsoft.com/docs/services/form-recognizer-api-v3-0-preview-1/operations/AnalyzeDocument)</li><li>[**C# SDK**](quickstarts/try-v3-csharp-sdk.md)</li><li>[**Python SDK**](quickstarts/try-v3-python-sdk.md)</li><li>[**Java SDK**](quickstarts/try-v3-java-sdk.md)</li><li>[**JavaScript SDK**](quickstarts/try-v3-javascript-sdk.md)</li></ul>|**prebuilt-read**|
+|**Read model**| <ul><li>[**Form Recognizer Studio**](https://formrecognizer.appliedai.azure.com)</li><li>[**REST API**](how-to-guides/use-prebuilt-read.md?pivots=programming-language-rest-api)</li><li>[**C# SDK**](how-to-guides/use-prebuilt-read.md?pivots=programming-language-csharp)</li><li>[**Python SDK**](how-to-guides/use-prebuilt-read.md?pivots=programming-language-python)</li><li>[**Java SDK**](how-to-guides/use-prebuilt-read.md?pivots=programming-language-java)</li><li>[**JavaScript**](how-to-guides/use-prebuilt-read.md?pivots=programming-language-javascript)</li></ul>|**prebuilt-read**|
 
 ## Data extraction
 
@@ -77,7 +77,7 @@ Form Recognizer preview version supports several languages for the read model. *
 
 ### Text lines and words
 
-Read API extracts text from documents and images with multiple text angles and colors. It accepts photos of documents, faxes, printed and/or handwritten (English only) text, and mixed modes. Text is extracted with information provided on lines, words, bounding boxes, confidence scores, and style (handwritten or other).
+Read API extracts text from documents and images with multiple text angles and colors. It accepts photos of documents, faxes, printed and/or handwritten (English only) text, and mixed modes. Text is extracted from data provided in lines, words, bounding boxes, confidence scores, and style.
 
 ### Language detection (v3.0 preview)
 
@@ -93,12 +93,17 @@ For large multi-page documents, use the `pages` query parameter to indicate spec
 
 ## Next steps
 
-* Complete a Form Recognizer quickstart:
+Complete a Form Recognizer quickstart:
 
-  > [!div class="nextstepaction"]
-  > [Form Recognizer quickstart](quickstarts/try-sdk-rest-api.md)
+> [!div class="checklist"]
+>
+> * [**REST API**](how-to-guides/use-prebuilt-read.md?pivots=programming-language-rest-api)
+> * [**C# SDK**](how-to-guides/use-prebuilt-read.md?pivots=programming-language-csharp)
+> * [**Python SDK**](how-to-guides/use-prebuilt-read.md?pivots=programming-language-python)
+> * [**Java SDK**](how-to-guides/use-prebuilt-read.md?pivots=programming-language-java)
+> * [**JavaScript**](how-to-guides/use-prebuilt-read.md?pivots=programming-language-javascript)</li></ul>
 
-* Explore our REST API:
+Explore our REST API:
 
-    > [!div class="nextstepaction"]
-    > [Form Recognizer API v3.0](https://westus.dev.cognitive.microsoft.com/docs/services/form-recognizer-api-v3-0-preview-2/operations/AnalyzeDocument)
+> [!div class="nextstepaction"]
+> [Form Recognizer API v3.0](https://westus.dev.cognitive.microsoft.com/docs/services/form-recognizer-api-v3-0-preview-2/operations/AnalyzeDocument)