Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into rolyon-rbac-metadata-manager

rolyon · rolyon · commit 769b990dde41 · 2022-08-19T16:48:41.000-07:00
diff --git a/articles/active-directory/fundamentals/1-secure-access-posture.md b/articles/active-directory/fundamentals/1-secure-access-posture.md
@@ -8,7 +8,7 @@ ms.service: active-directory
 ms.workload: identity
 ms.subservice: fundamentals
 ms.topic: conceptual
-ms.date: 12/18/2020
+ms.date: 08/19/2022
 ms.author: jricketts
 ms.reviewer: ajburnle
 ms.custom: "it-pro, seodec18"
@@ -91,4 +91,4 @@ See the following articles on securing external access to resources. We recommen
 9. [Secure access to Microsoft Teams, OneDrive, and SharePoint](9-secure-access-teams-sharepoint.md)
  
 
-​
+​
diff --git a/articles/active-directory/fundamentals/8-secure-access-sensitivity-labels.md b/articles/active-directory/fundamentals/8-secure-access-sensitivity-labels.md
@@ -8,7 +8,7 @@ ms.service: active-directory
 ms.workload: identity
 ms.subservice: fundamentals
 ms.topic: conceptual
-ms.date: 12/18/2020
+ms.date: 08/19/2022
 ms.author: jricketts
 ms.reviewer: ajburnle
 ms.custom: "it-pro, seodec18"
diff --git a/articles/active-directory/fundamentals/resilience-b2b-authentication.md b/articles/active-directory/fundamentals/resilience-b2b-authentication.md
@@ -8,7 +8,7 @@ ms.service: active-directory
 ms.workload: identity
 ms.subservice: fundamentals
 ms.topic: conceptual
-ms.date: 11/30/2020
+ms.date: 08/19/2022
 ms.author: jricketts
 ms.reviewer: ajburnle
 ms.custom: "it-pro, seodec18"
diff --git a/articles/active-directory/fundamentals/resilience-in-credentials.md b/articles/active-directory/fundamentals/resilience-in-credentials.md
@@ -9,7 +9,7 @@ ms.service: active-directory
 ms.workload: identity
 ms.subservice: fundamentals
 ms.topic: conceptual
-ms.date: 11/30/2020
+ms.date: 08/19/2022
 ms.author: jricketts
 ms.reviewer: ajburnle
 ms.custom: "it-pro, seodec18"
@@ -78,4 +78,4 @@ Resilience resources for developers
 
 * [Build IAM resilience in your applications](resilience-app-development-overview.md)
 
-* [Build resilience in your CIAM systems](resilience-b2c.md)
+* [Build resilience in your CIAM systems](resilience-b2c.md)
diff --git a/articles/active-directory/fundamentals/resilience-in-hybrid.md b/articles/active-directory/fundamentals/resilience-in-hybrid.md
@@ -8,7 +8,7 @@ ms.service: active-directory
 ms.workload: identity
 ms.subservice: fundamentals
 ms.topic: conceptual
-ms.date: 11/30/2020
+ms.date: 08/19/2022
 ms.author: jricketts
 ms.reviewer: ajburnle
 ms.custom: "it-pro, seodec18"
@@ -117,4 +117,4 @@ Resilience resources for developers
 
 * [Build IAM resilience in your applications](resilience-app-development-overview.md)
 
-* [Build resilience in your CIAM systems](resilience-b2c.md)
+* [Build resilience in your CIAM systems](resilience-b2c.md)
diff --git a/articles/active-directory/fundamentals/resilience-on-premises-access.md b/articles/active-directory/fundamentals/resilience-on-premises-access.md
@@ -8,7 +8,7 @@ ms.service: active-directory
 ms.workload: identity
 ms.subservice: fundamentals
 ms.topic: conceptual
-ms.date: 11/30/2020
+ms.date: 08/19/2022
 ms.author: jricketts
 ms.reviewer: ajburnle
 ms.custom: "it-pro, seodec18"
@@ -55,4 +55,4 @@ Resilience resources for developers
 
 * [Build IAM resilience in your applications](resilience-app-development-overview.md)
 
-* [Build resilience in your CIAM systems](resilience-b2c.md)
+* [Build resilience in your CIAM systems](resilience-b2c.md)
diff --git a/articles/active-directory/fundamentals/resilience-with-continuous-access-evaluation.md b/articles/active-directory/fundamentals/resilience-with-continuous-access-evaluation.md
@@ -9,7 +9,7 @@ ms.service: active-directory
 ms.workload: identity
 ms.subservice: fundamentals
 ms.topic: conceptual
-ms.date: 11/30/2020
+ms.date: 08/19/2022
 ms.author: jricketts
 ms.reviewer: ajburnle
 ms.custom: "it-pro, seodec18"
diff --git a/articles/active-directory/fundamentals/resilience-with-device-states.md b/articles/active-directory/fundamentals/resilience-with-device-states.md
@@ -8,7 +8,7 @@ ms.service: active-directory
 ms.workload: identity
 ms.subservice: fundamentals
 ms.topic: conceptual
-ms.date: 11/30/2020
+ms.date: 08/19/2022
 ms.author: jricketts
 ms.reviewer: ajburnle
 ms.custom: "it-pro, seodec18"
@@ -61,4 +61,4 @@ Resilience resources for developers
 
 * [Build IAM resilience in your applications](resilience-app-development-overview.md)
 
-* [Build resilience in your CIAM systems](resilience-b2c.md)
+* [Build resilience in your CIAM systems](resilience-b2c.md)
diff --git a/articles/active-directory/fundamentals/service-accounts-govern-on-premises.md b/articles/active-directory/fundamentals/service-accounts-govern-on-premises.md
@@ -8,7 +8,7 @@ ms.service: active-directory
 ms.workload: identity
 ms.subservice: fundamentals
 ms.topic: conceptual
-ms.date: 2/15/2021
+ms.date: 08/19/2022
 ms.author: jricketts
 ms.reviewer: ajburnle
 ms.custom: "it-pro, seodec18"
diff --git a/articles/search/media/search-get-started-rest/search-tree.png b/articles/search/media/search-get-started-rest/search-tree.png
diff --git a/articles/search/media/search-get-started-rest/subscriptions.png b/articles/search/media/search-get-started-rest/subscriptions.png
diff --git a/articles/search/media/search-get-started-rest/vscode-ext-subscription-list.png b/articles/search/media/search-get-started-rest/vscode-ext-subscription-list.png
diff --git a/articles/search/search-get-started-vs-code.md b/articles/search/search-get-started-vs-code.md
@@ -1,12 +1,12 @@
 ---
-title: 'Quickstart: Get started with Azure Cognitive Search using Visual Studio Code'
+title: 'Quickstart: Use Visual Studio Code with Search'
 titleSuffix: Azure Cognitive Search
 description: Learn how to install and use the Visual Studio Code extension for Azure Cognitive Search.
 author: dereklegenzoff
 ms.author: delegenz
 ms.service: cognitive-search
 ms.topic: quickstart
-ms.date: 03/10/2021
+ms.date: 08/19/2022
 ms.custom: mode-ui
 ---
 
@@ -17,7 +17,7 @@ This article explains how to formulate REST API requests interactively using the
 If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
 
 > [!IMPORTANT] 
-> This skill is in public preview under [supplemental terms of use](https://azure.microsoft.com/support/legal/preview-supplemental-terms/). 
+> This extension is in public preview under [supplemental terms of use](https://azure.microsoft.com/support/legal/preview-supplemental-terms/). 
 
 ## Prerequisites
 
@@ -31,31 +31,31 @@ The following services and tools are required for this quickstart.
 
 ## Install the extension
 
-Start by opening [VS Code](https://code.visualstudio.com). Select the **Extensions** tab on the activity bar then search for *Azure Cognitive Search*. Find the extension in the search results, and select **Install**.
+Start [Visual Studio Code](https://code.visualstudio.com). Select the **Extensions** tab on the activity bar, then search for *Azure Cognitive Search*. Find the extension in the search results, and select **Install**.
 
 ![VS Code extension pane](media/search-get-started-rest/download-extension.png "Downloading the VS Code extension")
 
-Alternatively, you can install  the [Azure Cognitive Search extension](https://aka.ms/vscode-search) from the VS Code marketplace in a web browser.
+Alternatively, you can install the [Azure Cognitive Search extension](https://aka.ms/vscode-search) from the Visual Studio Code marketplace in a web browser.
 
-You should see a new Azure tab appear on the activity bar if you didn't already have it.
+You should see a new Azure tab appear on the activity bar if you don't already have it.
 
 ![VS Code Azure pane](media/search-get-started-rest/azure-pane.png "Azure pane in VS Code")
 
 ## Connect to your subscription
 
 Select **Sign in to Azure...** and log into your Azure Account.
 
-You should see your subscriptions appear. Select the subscription to see a list of the search services in the subscription.
+You should see your subscriptions. In the following screenshot, the subscription name is "Visual Studio Enterprise" and it contains one search service named "azsearch-service". 
 
 ![VS Code Azure subscriptions](media/search-get-started-rest/subscriptions.png "Subscriptions in VS Code")
 
 To limit the subscriptions displayed, open the command palette (Ctrl+Shift+P or Cmd+Shift+P) and search for *Azure* or *Select Subscriptions*. There are also commands available for signing in and out of your Azure account.
 
-When you expand the search service, you will see tree items for each of the Cognitive Search resources: indexes, data sources, indexers, skillsets, and synonym maps.
+When you expand the search service, you'll see tree items for each Cognitive Search item: indexes, data sources, indexers, skillsets, synonym maps, and aliases.
 
 ![VS Code Azure search tree](media/search-get-started-rest/search-tree.png "VS Code Azure search tree")
 
-These tree items can be expanded to show any resources you have in your search service
+These tree items can be expanded to show any resources you have in your search service.
 
 ## 1 - Create an index
 
@@ -203,31 +203,31 @@ The `fields` collection defines the structure of documents in the search index.
 
 To create a new index, right-click on **Indexes** and then select **Create new index**. An editor with a name similar to `indexes-new-28c972f661.azsindex` will pop up. 
 
-Paste the index definition from above into the window. Save the file and select **Upload** when prompted if you want to update the index. This will create the index and it will be available in the tree view.
+Paste the index definition from above into the window. Save the file and select **Upload** when prompted if you want to update the index. This step creates the index and adds it to the tree view on the left.
 
 ![Gif of creating an index](media/search-get-started-rest/create-index.gif)
 
-If there is a problem with your index definition, you should see an error message pop up explaining the error.
+If there's a problem with your index definition, you should see an error message similar to the one below.
 
 ![Create index error message](media/search-get-started-rest/create-index-error.png)
 
-If this happens, fix the issue and resave the file.
+If an error occurs, fix the issue and resave the file.
 
 ## 2 - Load documents
 
-Creating the index and populating the index are separate steps. In Azure Cognitive Search, the index contains all searchable data. In this scenario, the data is provided as JSON documents. The [Add, Update, or Delete Documents REST API](/rest/api/searchservice/addupdate-or-delete-documents) is used for this task. 
+In the REST API, creating the index and populating the index are separate steps. In Azure Cognitive Search, the index contains all searchable data. In this quickstart, the data is provided as JSON documents. The [Add, Update, or Delete Documents REST API](/rest/api/searchservice/addupdate-or-delete-documents) is used for this task. 
 
-To add new documents in VS Code:
+To add new documents to the index:
 
 1. Expand the `hotels-quickstart` index you created. Right-click on **Documents** and select **Create new document**.
 
     ![Create a document](media/search-get-started-rest/create-document.png)
 
-2. This will open up a JSON editor that has inferred the schema of your index.
+2. You should see a JSON editor that has inferred the schema of your index.
 
     ![Create a document json](media/search-get-started-rest/create-document-2.png)
 
-3. Paste in the JSON below and then save the file. A prompt will open up asking you to confirm your changes. Select **Upload** to save the changes.
+3. Paste in the JSON below and then save the file. A prompt asks you to confirm your changes. Select **Upload** to save the changes.
 
     ```json
     {
@@ -249,7 +249,7 @@ To add new documents in VS Code:
     }
     ```
 
-4. Repeat this process for the three remaining documents
+4. Repeat this process for the three remaining documents:
 
     Document 2:
     ```json
@@ -320,19 +320,16 @@ At this point, you should see all four documents available in the documents sect
 
 ## 3 - Search an index
 
-Now that the index and document set are loaded, you can issue queries against them using [Search Documents REST API](/rest/api/searchservice/search-documents).
+Now that the index contains content, you can issue queries using [Search Documents REST API](/rest/api/searchservice/search-documents):
 
-To do this in VS Code:
-
-1. Right-click the index you want to search and select **Search index**. This will open an editor with a name similar to `sandbox-b946dcda48.azs`.
+1. Right-click the index you want to search and select **Search**. This step opens an editor with a name similar to `sandbox-b946dcda48.azs`.
 
     ![search view of extension](media/search-get-started-rest/search-vscode.png)
 
 2. A simple query is autopopulated. Press **Ctrl+Alt+R** or **Cmd+Alt+R** to submit the query. You'll see the results pop up in a window to the left.
 
     ![search results in extension](media/search-get-started-rest/search-results.png)
 
-
 ### Example queries
 
 Try a few other query examples to get a feel for the syntax. There's four additional queries below for you to try. You can add multiple queries to the same editor. When you press **Ctrl+Alt+R** or **Cmd+Alt+R**, the line your cursor determines which query will be submitted.
@@ -350,17 +347,17 @@ In the next query, we specify the search term `wifi` and also include a filter t
 
 ```
 // Query example 2 - Search with filter, orderBy, select, and count
-search=wifi&$filter=Address/StateProvince eq 'FL'&$select=HotelId,HotelName,Rating&$orderby=Rating desc
+search=wifi&$filter=Address/StateProvince eq 'FL'&$select=HotelId,HotelName,Rating,Address/StateProvince&$orderby=Rating desc
 ```
 
 Next, the search is limited to a single searchable field using the `searchFields` parameter. This is a great option to make your query more efficient if you know you're only interested in matches in certain fields.
 
 ```
 // Query example 3 - Limit searchFields
-search=submlime cliff&$select=HotelId,HotelName,Rating&searchFields=HotelName
+search=sublime cliff&$select=HotelId,HotelName,Rating&searchFields=HotelName
 ```
 
-Another common option to include in a query is `facets`. Facets allow you to build out filters on your UI to make it easy for users to know what values they can filter down to.
+Another common option to include in a query is `facets`. Facets allow you to build out filters on your app to make it easy for users to know what values they can filter down to.
 
 ```
 // Query example 4 - Take the top two results, and show only HotelName and Category in the results
@@ -369,7 +366,7 @@ search=*&$select=HotelId,HotelName,Rating&searchFields=HotelName&facet=Category
 
 ## Open index in the portal
 
-If you'd like to view your search service in the portal, right-click the name of the search service and select **Open in Portal**. This will take you to the search service in the Azure portal.
+If you'd like to view your search service in the portal, right-click the name of the search service and select **Open in Portal**.
 
 ## Clean up resources
 
