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

Author: seligj95

.openpublishing.redirection.json

@@ -4087,10 +4087,12 @@
             "source_path_from_root": "/articles/event-grid/move-domains-across-regions.md",
             "redirect_url": "/azure",
             "redirect_document_id": false
+        },
+        {
+            "source_path_from_root": "/articles/data-factory/continuous-integration-delivery-automate-github-actions.md",
+            "redirect_url": "/azure",
+            "redirect_document_id": false
         }
-
-
-
-        
+       
     ]
 }

articles/active-directory-b2c/TOC.yml

@@ -824,8 +824,6 @@
     href: user-flow-versions-legacy.md
 - name: Resources
   items:
-  - name: Azure Roadmap
-    href: https://azure.microsoft.com/updates/?status=nowavailable,inpreview,indevelopment&category=identity,security&query=b2c
   - name: Frequently asked questions
     href: ./faq.yml
     displayName: FAQ

articles/ai-services/cognitive-services-virtual-networks.md

@@ -8,7 +8,7 @@ manager: nitinme
 ms.service: azure-ai-services
 ms.custom: devx-track-azurepowershell, devx-track-azurecli
 ms.topic: how-to
-ms.date: 04/05/2024
+ms.date: 06/13/2024
 ms.author: aahi
 ---
 
@@ -573,7 +573,10 @@ You can grant a subset of trusted Azure services access to Azure OpenAI, while m
 |Azure AI Search     | `Microsoft.Search`         |
 
 
-You can grant networking access to trusted Azure services by creating a network rule exception using the REST API:
+You can grant networking access to trusted Azure services by creating a network rule exception using the REST API or Azure portal:
+
+### Using the Azure CLI
+
 ```bash
 
 accessToken=$(az account get-access-token --resource https://management.azure.com --query "accessToken" --output tsv)
@@ -595,9 +598,6 @@ curl -i -X PATCH https://management.azure.com$rid?api-version=2023-10-01-preview
 '
 ```
 
-> [!NOTE]
-> The trusted service feature is only available using the command line described above, and cannot be done using the Azure portal.
-
 To revoke the exception, set `networkAcls.bypass` to `None`. 
 
 To verify if the trusted service has been enabled from the Azure portal, 
@@ -610,6 +610,16 @@ To verify if the trusted service has been enabled from the Azure portal,
 
     :::image type="content" source="media/vnet/virtual-network-trusted-service.png" alt-text="A screenshot showing the trusted service is enabled." lightbox="media/vnet/virtual-network-trusted-service.png":::
 
+### Using the Azure portal
+
+1. Navigate to your Azure OpenAI resource, and select **Networking** from the navigation menu. 
+1. Under **Exceptions**, select **Allow Azure services on the trusted services list to access this cognitive services account.**
+    > [!TIP]
+    > You can view the **Exceptions** option by selecting either **Selected networks and private endpoints** or **Disabled** under **Allow access from**.    
+
+    :::image type="content" source="media/vnet/toggle-trusted-service.png" alt-text="A screenshot showing the networking settings for a resource in the Azure portal." lightbox="media/vnet/toggle-trusted-service.png":::
+***
+
 ### Pricing
 
 For pricing details, see [Azure Private Link pricing](https://azure.microsoft.com/pricing/details/private-link).

articles/ai-services/computer-vision/includes/identity-curl-quickstart.md

@@ -24,8 +24,7 @@ Get started with facial recognition using the Face REST API. The Face service pr
     * You'll need the key and endpoint from the resource you create to connect your application to the Face API. You'll paste your key and endpoint into the code below later in the quickstart.
     * You can use the free pricing tier (`F0`) to try the service, and upgrade later to a paid tier for production.
 * [PowerShell version 6.0+](/powershell/scripting/install/installing-powershell-core-on-windows), or a similar command-line application.
-* [cURL](https://curl.haxx.se/) installed.
-
+* [cURL](https://curl.se/) installed.
 
 
 
@@ -34,58 +33,134 @@ Get started with facial recognition using the Face REST API. The Face service pr
 > [!NOTE]
 > If you haven't received access to the Face service using the [intake form](https://aka.ms/facerecognition), some of these functions won't work.
 
-1. First, call the Detect API on the source face. This is the face that we'll try to identify from the larger group. Copy the following command to a text editor, insert your own key, and then copy it into a shell window and run it.
+1. First, call the Detect API on the source face. This is the face that we'll try to identify from the larger group. Copy the following command to a text editor, insert your own key and endpoint, and then copy it into a shell window and run it.
+
+    #### [Windows](#tab/windows)
+
+    :::code source="~/cognitive-services-quickstart-code/curl/face/detect.ps1" ID="identify_detect":::
+
+    #### [Linux](#tab/linux)
 
     :::code source="~/cognitive-services-quickstart-code/curl/face/detect.sh" ID="identify_detect":::
 
+    ---
+
     Save the returned face ID string to a temporary location. You'll use it again at the end.
 
-1. Next you'll need to create a **LargePersonGroup**. This object will store the aggregated face data of several persons. Run the following command, inserting your own key. Optionally, change the group's name and metadata in the request body.
+1. Next you'll need to create a **LargePersonGroup** and give it an arbitrary ID that matches regex pattern `^[a-z0-9-_]+$`. This object will store the aggregated face data of several persons. Run the following command, inserting your own key. Optionally, change the group's name and metadata in the request body.
+
+    #### [Windows](#tab/windows)
+
+    :::code source="~/cognitive-services-quickstart-code/curl/face/detect.ps1" ID="identify_create_persongroup":::
+
+    #### [Linux](#tab/linux)
 
     :::code source="~/cognitive-services-quickstart-code/curl/face/detect.sh" ID="identify_create_persongroup":::
 
-    Save the returned ID of the created group to a temporary location.
+    ---
+
+    Save the specified ID of the created group to a temporary location.
 
 1. Next, you'll create **Person** objects that belong to the group. Run the following command, inserting your own key and the ID of the **LargePersonGroup** from the previous step. This command creates a **Person** named "Family1-Dad".
 
+    #### [Windows](#tab/windows)
+
+    :::code source="~/cognitive-services-quickstart-code/curl/face/detect.ps1" ID="identify_create_person":::
+
+    #### [Linux](#tab/linux)
+
     :::code source="~/cognitive-services-quickstart-code/curl/face/detect.sh" ID="identify_create_person":::
 
+    ---
+
     After you run this command, run it again with different input data to create more **Person** objects: "Family1-Mom", "Family1-Son", "Family1-Daughter", "Family2-Lady", and "Family2-Man".
 
     Save the IDs of each **Person** created; it's important to keep track of which person name has which ID.
 
 1. Next you'll need to detect new faces and associate them with the **Person** objects that exist. The following command detects a face from the image *Family1-Dad1.jpg* and adds it to the corresponding person. You need to specify the `personId` as the ID that was returned when you created the "Family1-Dad" **Person** object. The image name corresponds to the name of the created **Person**. Also enter the **LargePersonGroup** ID and your key in the appropriate fields.
 
+    #### [Windows](#tab/windows)
+
+    :::code source="~/cognitive-services-quickstart-code/curl/face/detect.ps1" ID="identify_add_face":::
+
+    #### [Linux](#tab/linux)
+
     :::code source="~/cognitive-services-quickstart-code/curl/face/detect.sh" ID="identify_add_face":::
 
+    ---
+
     Then, run the above command again with a different source image and target **Person**. The images available are: *Family1-Dad1.jpg*, *Family1-Dad2.jpg* *Family1-Mom1.jpg*, *Family1-Mom2.jpg*, *Family1-Son1.jpg*, *Family1-Son2.jpg*, *Family1-Daughter1.jpg*, *Family1-Daughter2.jpg*, *Family2-Lady1.jpg*, *Family2-Lady2.jpg*, *Family2-Man1.jpg*, and *Family2-Man2.jpg*. Be sure that the **Person** whose ID you specify in the API call matches the name of the image file in the request body.
 
     At the end of this step, you should have multiple **Person** objects that each have one or more corresponding faces, detected directly from the provided images.
 
 1. Next, train the **LargePersonGroup** with the current face data. The training operation teaches the model how to associate facial features, sometimes aggregated from multiple source images, to each single person. Insert the **LargePersonGroup** ID and your key before running the command.
 
+    #### [Windows](#tab/windows)
+
+    :::code source="~/cognitive-services-quickstart-code/curl/face/detect.ps1" ID="identify_train":::
+
+    #### [Linux](#tab/linux)
+
     :::code source="~/cognitive-services-quickstart-code/curl/face/detect.sh" ID="identify_train":::
+
+    ---
 
+1. Check whether the training status is succeeded. If not, wait for a while and query again.
+
+    #### [Windows](#tab/windows)
+
+    :::code source="~/cognitive-services-quickstart-code/curl/face/detect.ps1" ID="identify_check_status":::
+
+    #### [Linux](#tab/linux)
+
+    :::code source="~/cognitive-services-quickstart-code/curl/face/detect.sh" ID="identify_check_status":::
+
+    ---
+
 1. Now you're ready to call the Identify API, using the source face ID from the first step and the **LargePersonGroup** ID. Insert these values into the appropriate fields in the request body, and insert your key.
 
+    #### [Windows](#tab/windows)
+
+    :::code source="~/cognitive-services-quickstart-code/curl/face/detect.ps1" ID="identify_identify":::
+
+    #### [Linux](#tab/linux)
+
     :::code source="~/cognitive-services-quickstart-code/curl/face/detect.sh" ID="identify_identify":::
 
+    ---
+
     The response should give you a **Person** ID indicating the person identified with the source face. It should be the ID that corresponds to the "Family1-Dad" person, because the source face is of that person.
 
 1. To do face verification, you'll use the **Person** ID returned in the previous step, the **LargePersonGroup** ID, and also the source face ID. Insert these values into the fields in the request body, and insert your key.
 
+    #### [Windows](#tab/windows)
+
+    :::code source="~/cognitive-services-quickstart-code/curl/face/detect.ps1" ID="verify":::
+
+    #### [Linux](#tab/linux)
+
     :::code source="~/cognitive-services-quickstart-code/curl/face/detect.sh" ID="verify":::
 
+    ---
+
     The response should give you a boolean verification result along with a confidence value.
 
 
 
 ## Clean up resources
 
-To delete the **LargePersonGroup** you created in this exercise, run the LargePersonGroup - Delete call.
+To delete the **LargePersonGroup** you created in this exercise, run the [LargePersonGroup - Delete](/rest/api/face/person-group-operations/delete-large-person-group) call.
+
+#### [Windows](#tab/windows)
+
+:::code source="~/cognitive-services-quickstart-code/curl/face/detect.ps1" ID="identify_delete":::
+
+#### [Linux](#tab/linux)
 
 :::code source="~/cognitive-services-quickstart-code/curl/face/detect.sh" ID="identify_delete":::
 
+---
+
 If you want to clean up and remove an Azure AI services subscription, you can delete the resource or resource group. Deleting the resource group also deletes any other resources associated with it.
 
 * [Portal](../../multi-service-resource.md?pivots=azportal#clean-up-resources)

articles/ai-services/containers/includes/cognitive-services-container-security.md

@@ -39,7 +39,7 @@ The host should allowlist **port 443** and the following domains:
 
 #### Disable deep packet inspection
 
-[Deep packet inspection](https://en.wikipedia.org/wiki/Deep_packet_inspection) (DPI) is a type of data processing that inspects in detail the data sent over a computer network, and usually takes action by blocking, rerouting, or logging it accordingly.
+[Deep packet inspection (DPI)](https://en.wikipedia.org/wiki/Deep_packet_inspection) is a type of data processing that inspects in detail the data sent over a computer network, and usually takes action by blocking, rerouting, or logging it accordingly.
 
 Disable DPI on the secure channels that the Azure AI containers create to Microsoft servers. Failure to do so will prevent the container from functioning correctly.
 

articles/ai-services/document-intelligence/containers/install-run.md

@@ -19,7 +19,7 @@ ms.author: lajanuar
 <!-- markdownlint-disable MD051 -->
 
 :::moniker range="doc-intel-2.1.0 || doc-intel-4.0.0"
-Support for containers is currently available with Document Intelligence version `2022-08-31 (GA)` for all models and `2023-07-31 (GA)` for Read and Layout only:
+Support for containers is currently available with Document Intelligence version `2022-08-31 (GA)` for all models and `2023-07-31 (GA)` for Read, Layout, ID Document, Receipt and Invoice models:
 
 * [REST API `2022-08-31 (GA)`](/rest/api/aiservices/document-models/analyze-document?view=rest-aiservices-v3.0%20(2022-08-31)&preserve-view=true&tabs=HTTP)
 * [REST API `2023-07-31 (GA)`](/rest/api/aiservices/document-models/analyze-document?view=rest-aiservices-v3.1%20(2023-07-31)&tabs=HTTP&preserve-view=true)
@@ -38,9 +38,9 @@ Azure AI Document Intelligence is an Azure AI service that lets you build automa
 
 In this article you learn how to download, install, and run Document Intelligence containers. Containers enable you to run the Document Intelligence service in your own environment. Containers are great for specific security and data governance requirements.
 
-* **Read**, and **Layout**  models are supported by Document Intelligence v3.1 containers.
+* **Read**, **Layout**,  **ID Document**,  **Receipt**, and **Invoice**  models are supported by Document Intelligence v3.1 containers.
 
-* **Read**, **Layout**, **General Document**, **ID Document**,  **Receipt**, **Invoice**, **Business Card**, and **Custom** models are supported by Document Intelligence v3.0 containers.
+* **Read**, **Layout**, **General Document**, **Business Card**, and **Custom** models are supported by Document Intelligence v3.0 containers.
 
 * **Business Card** model is currently only supported in the [v2.1 containers](install-run.md?view=doc-intel-2.1.0&preserve-view=true).
 

articles/ai-services/document-intelligence/create-sas-tokens.md

@@ -1,6 +1,6 @@
 ---
 title: Create shared access signature (SAS) tokens for your storage containers and blobs
-description: How to create Shared Access Signature tokens (SAS) for containers and blobs with Microsoft Storage Explorer and the Azure portal.
+description: How to create Shared Access Signature (SAS) tokens for containers and blobs with Microsoft Storage Explorer and the Azure portal.
 ms.topic: how-to
 author: laujan
 manager: nitinme

articles/ai-services/document-intelligence/how-to-guides/includes/v3-0/java-sdk.md

@@ -34,7 +34,7 @@ monikerRange: 'doc-intel-3.1.0 || doc-intel-3.0.0'
 
   If you aren't using Visual Studio Code, make sure you have the following installed in your development environment:
 
-  - A [**Java Development Kit** (JDK)](/java/openjdk/download#openjdk-17) version 8 or later. For more information, see [Microsoft Build of OpenJDK](https://www.microsoft.com/openjdk).
+  - A [**Java Development Kit (JDK)**](/java/openjdk/download#openjdk-17) version 8 or later. For more information, see [Microsoft Build of OpenJDK](https://www.microsoft.com/openjdk).
   - [**Gradle**](https://docs.gradle.org/current/userguide/installation.html), version 6.8 or later.
 
 - An Azure AI services or Document Intelligence resource. Create a <a href="https://portal.azure.com/#create/Microsoft.CognitiveServicesFormRecognizer" title="Create a Document Intelligence resource." target="_blank">single-service</a> or <a href="https://portal.azure.com/#create/Microsoft.CognitiveServicesAllInOne" title="Create a multiple Document Intelligence resource." target="_blank">multi-service</a>. You can use the free pricing tier (`F0`) to try the service, and upgrade later to a paid tier for production.

articles/ai-services/document-intelligence/how-to-guides/includes/v4-0/java-sdk.md

@@ -27,7 +27,7 @@ ms.custom: devx-track-csharp, ignite-2023, linux-related-content
 
   If you aren't using Visual Studio Code, make sure you have the following installed in your development environment:
 
-  - A [**Java Development Kit** (JDK)](/java/openjdk/download#openjdk-17) version 8 or later. For more information, see [Microsoft Build of OpenJDK](https://www.microsoft.com/openjdk).
+  - A [**Java Development Kit (JDK)**](/java/openjdk/download#openjdk-17) version 8 or later. For more information, see [Microsoft Build of OpenJDK](https://www.microsoft.com/openjdk).
   - [**Gradle**](https://docs.gradle.org/current/userguide/installation.html), version 6.8 or later.
 
 - An Azure AI services or Document Intelligence resource. Create a <a href="https://portal.azure.com/#create/Microsoft.CognitiveServicesFormRecognizer" title="Create a Document Intelligence resource." target="_blank">single-service</a> or <a href="https://portal.azure.com/#create/Microsoft.CognitiveServicesAllInOne" title="Create a multiple Document Intelligence resource." target="_blank">multi-service</a>. You can use the free pricing tier (`F0`) to try the service, and upgrade later to a paid tier for production.
@@ -85,10 +85,10 @@ This article uses the Gradle dependency manager. You can find the client library
 
 1. Open the project's *build.gradle.kts* file in your IDE. Copy and paste the following code to include the client library as an `implementation` statement, along with the required plugins and settings.
 
-    ```kotlin
-    plugins {
-       java
-       application
+   ```kotlin
+   plugins {
+      java
+      application
    }
    application {
        mainClass.set("DocIntelligence")
@@ -98,9 +98,8 @@ This article uses the Gradle dependency manager. You can find the client library
    }
    dependencies {
        implementation group: 'com.azure', name: 'azure-ai-documentintelligence', version: '1.0.0-beta.2'
-
    }
-    ```
+   ```
 
 ## Create a Java application
 

articles/ai-services/document-intelligence/quickstarts/includes/java-sdk.md

@@ -43,7 +43,7 @@ In this quickstart, use the following features to analyze and extract data and v
 
 * If you aren't using Visual Studio Code, make sure you have the following installed in your development environment:
 
-  * A [**Java Development Kit** (JDK)](/java/openjdk/download#openjdk-17) version 8 or later. For more information, *see* [Microsoft Build of OpenJDK](https://www.microsoft.com/openjdk).
+  * A [**Java Development Kit (JDK)**](/java/openjdk/download#openjdk-17) version 8 or later. For more information, *see* [Microsoft Build of OpenJDK](https://www.microsoft.com/openjdk).
 
   * [**Gradle**](https://docs.gradle.org/current/userguide/installation.html), version 6.8 or later.