Merge pull request #273164 from davidsmatlak/ds-update-arg-pwsh-quickstart-20240423

Updates ARG quickstart for Azure PowerShell

Author: JamesJBarnett

articles/governance/resource-graph/changes/get-resource-changes.md

@@ -22,7 +22,7 @@ In this article, you learn:
 
 ## Prerequisites
 
-- To enable Azure PowerShell to query Azure Resource Graph, [add the module](../first-query-powershell.md#add-the-resource-graph-module).
+- To enable Azure PowerShell to query Azure Resource Graph, [add the module](../first-query-powershell.md#install-the-module).
 - To enable Azure CLI to query Azure Resource Graph, [add the extension](../first-query-azurecli.md#install-the-extension).
 
 ## Understand change event properties

articles/governance/resource-graph/first-query-powershell.md

@@ -1,140 +1,117 @@
 ---
-title: 'Quickstart: Your first PowerShell query'
-description: In this quickstart, you follow the steps to enable the Resource Graph module for Azure PowerShell and run your first query.
-ms.date: 06/15/2022
+title: "Quickstart: Run Resource Graph query using Azure PowerShell"
+description: In this quickstart, you run an Azure Resource Graph query using the module for Azure PowerShell.
+ms.date: 04/24/2024
 ms.topic: quickstart
 ms.custom: mode-api, devx-track-azurepowershell
 ---
-# Quickstart: Run your first Resource Graph query using Azure PowerShell
 
-The first step to using Azure Resource Graph is to check that the module for Azure PowerShell is
-installed. This quickstart walks you through the process of adding the module to your Azure
-PowerShell installation.
+# Quickstart: Run Resource Graph query using Azure PowerShell
 
-At the end of this process, you'll have added the module to your Azure PowerShell installation of
-choice and run your first Resource Graph query.
+This quickstart describes how to run an Azure Resource Graph query using the `Az.ResourceGraph` module for Azure PowerShell. The article also shows how to order (sort) and limit the query's results. You can run a query for resources in your tenant, management groups, or subscriptions. When you're finished, you can remove the module.
 
 ## Prerequisites
 
-If you don't have an Azure subscription, create a [free](https://azure.microsoft.com/free/) account
-before you begin.
+- If you don't have an Azure account, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
+- [PowerShell](/powershell/scripting/install/installing-powershell).
+- [Azure PowerShell](/powershell/azure/install-azure-powershell).
+- [Visual Studio Code](https://code.visualstudio.com/).
 
-[!INCLUDE [cloud-shell-try-it.md](../../../includes/cloud-shell-try-it.md)]
+## Install the module
 
-## Add the Resource Graph module
+Install the `Az.ResourceGraph` module so that you can use Azure PowerShell to run Azure Resource Graph queries. The Azure Resource Graph module requires PowerShellGet version 2.0.1 or higher. If you installed the latest versions of PowerShell and Azure PowerShell, you already have the required version.
 
-To enable Azure PowerShell to query Azure Resource Graph, the module must be added. This module can
-be used with locally installed PowerShell, with [Azure Cloud Shell](https://shell.azure.com), or
-with the [PowerShell Docker image](https://hub.docker.com/_/microsoft-powershell).
+1. Verify your PowerShellGet version:
 
-### Base requirements
+    ```azurepowershell
+    Get-Module -Name PowerShellGet
+    ```
 
-The Azure Resource Graph module requires the following software:
+   If you need to update, go to [PowerShellGet](/powershell/gallery/powershellget/install-powershellget).
 
-- Azure PowerShell 1.0.0 or higher. If it isn't yet installed, follow
-  [these instructions](/powershell/azure/install-azure-powershell).
+1. Install the module:
 
-- PowerShellGet 2.0.1 or higher. If it isn't installed or updated, follow
-  [these instructions](/powershell/gallery/powershellget/install-powershellget).
-
-### Install the module
+   ```azurepowershell
+   Install-Module -Name Az.ResourceGraph -Repository PSGallery -Scope CurrentUser
+   ```
 
-The Resource Graph module for PowerShell is **Az.ResourceGraph**.
+    The command installs the module in the `CurrentUser` scope. If you need to install in the `AllUsers` scope, run the installation from an administrative PowerShell session.
 
-1. From an **administrative** PowerShell prompt, run the following command:
+1. Verify the module was installed:
 
-   ```azurepowershell-interactive
-   # Install the Resource Graph module from PowerShell Gallery
-   Install-Module -Name Az.ResourceGraph
+   ```azurepowershell
+   Get-Command -Module Az.ResourceGraph -CommandType Cmdlet
    ```
 
-1. Validate that the module has been imported and is at least version `0.11.0`:
+   The command displays the `Search-AzGraph` cmdlet version and loads the module into your PowerShell session.
 
-   ```azurepowershell-interactive
-   # Get a list of commands for the imported Az.ResourceGraph module
-   Get-Command -Module 'Az.ResourceGraph' -CommandType 'Cmdlet'
-   ```
+## Connect to Azure
 
-## Run your first Resource Graph query
+From a Visual Studio Code terminal session, connect to Azure. If you have more than one subscription, run the commands to set context to your subscription. Replace `<subscriptionID>` with your Azure subscription ID.
+
+```azurepowershell
+Connect-AzAccount
+
+# Run these commands if you have multiple subscriptions
+Get-AzSubScription
+Set-AzContext -Subscription <subscriptionID>
+```
 
-With the Azure PowerShell module added to your environment of choice, it's time to try out a simple
-tenant-based Resource Graph query. The query returns the first five Azure resources with the
-**Name** and **Resource Type** of each resource. To query by
-[management group](../management-groups/overview.md) or subscription, use the `-ManagementGroup`
-or `-Subscription` parameters.
+## Run a query
 
-1. Run your first Azure Resource Graph query using the `Search-AzGraph` cmdlet:
+After the module is added to your environment, you can run a tenant-based query. The query in this example returns five Azure resources with the `name` and `type` of each resource. To query by [management group](../management-groups/overview.md) or subscription, use the `-ManagementGroup` or `-Subscription` parameters.
 
-   ```azurepowershell-interactive
-   # Login first with Connect-AzAccount if not using Cloud Shell
+1. Run an Azure Resource Graph query using the `Search-AzGraph` cmdlet:
 
-   # Run Azure Resource Graph query
+   ```azurepowershell
    Search-AzGraph -Query 'Resources | project name, type | limit 5'
    ```
 
-   > [!NOTE]
-   > As this query example doesn't provide a sort modifier such as `order by`, running this query
-   > multiple times is likely to yield a different set of resources per request.
+   This query example doesn't use a sort modifier like `order by`. If you run the query multiple times, it might yield a different set of resources for each request.
 
-1. Update the query to `order by` the **Name** property:
+1. Update the query to `order by` the `name` property:
 
-   ```azurepowershell-interactive
-   # Run Azure Resource Graph query with 'order by'
+   ```azurepowershell
    Search-AzGraph -Query 'Resources | project name, type | limit 5 | order by name asc'
    ```
 
-   > [!NOTE]
-   > Just as with the first query, running this query multiple times is likely to yield a different
-   > set of resources per request. The order of the query commands is important. In this example,
-   > the `order by` comes after the `limit`. This command order first limits the query results and
-   > then orders them.
+   Like the previous query, if you run this query multiple times might yield a different set of resources for each request. The order of the query commands is important. In this example, the `order by` comes after the `limit`. The query limits the results to five resources and then orders those results by name.
 
-1. Update the query to first `order by` the **Name** property and then `limit` to the top five
-   results:
+1. Update the query to `order by` the `name` property and then `limit` the output to five results:
 
-   ```azurepowershell-interactive
-   # Store the query in a variable
-   $query = 'Resources | project name, type | order by name asc | limit 5'
-
-   # Run Azure Resource Graph query with `order by` first, then with `limit`
-   Search-AzGraph -Query $query
+   ```azurepowershell
+   Search-AzGraph -Query 'Resources | project name, type | order by name asc | limit 5'
    ```
 
-When the final query is run several times, assuming that nothing in your environment changes,
-the results returned are consistent and ordered by the **Name** property, but still limited to the
-top five results.
+   If this query is run several times with no changes to your environment, the results are consistent and ordered by the `name` property, but still limited to five results. The query orders the results by name and then limits the output to five resources.
 
-> [!NOTE]
-> If the query does not return results from a subscription you already have access to, then note
-> that `Search-AzGraph` cmdlet defaults to subscriptions in the default context. To see the list of
-> subscription IDs which are part of the default context run this
-> `(Get-AzContext).Account.ExtendedProperties.Subscriptions` If you wish to search across all the
-> subscriptions you have access to, one can set the PSDefaultParameterValues for `Search-AzGraph`
-> cmdlet by running
-> `$PSDefaultParameterValues=@{"Search-AzGraph:Subscription"= $(Get-AzSubscription).ID}`
+If a query doesn't return results from a subscription you already have access to, then note that `Search-AzGraph` cmdlet defaults to subscriptions in the default context. To see the list of subscription IDs that are part of the default context, run this `(Get-AzContext).Account.ExtendedProperties.Subscriptions` If you wish to search across all the subscriptions you have access to, set the `PSDefaultParameterValues` for `Search-AzGraph` cmdlet by running `$PSDefaultParameterValues=@{"Search-AzGraph:Subscription"= $(Get-AzSubscription).ID}`
 
 ## Clean up resources
 
-If you wish to remove the Resource Graph module from your Azure PowerShell environment, you can do
-so by using the following command:
+To remove the `Az.ResourceGraph` module from your PowerShell session, run the following command:
+
+```azurepowershell
+Remove-Module -Name Az.ResourceGraph
+```
 
-```azurepowershell-interactive
-# Remove the Resource Graph module from the current session
-Remove-Module -Name 'Az.ResourceGraph'
+To uninstall the `Az.ResourceGraph` module from your computer, run the following command:
 
-# Uninstall the Resource Graph module from the environment
-Uninstall-Module -Name 'Az.ResourceGraph'
+```azurepowershell
+Uninstall-Module -Name Az.ResourceGraph
 ```
 
-> [!NOTE]
-> This doesn't delete the module file downloaded earlier. It only removes it from the running
-> PowerShell session.
+A message might be displayed that _module Az.ResourceGraph is currently in use_. If so, you need to shut down your PowerShell session and start a new session. Then run the command to uninstall the module from your computer.
+
+To sign out of your Azure PowerShell session:
+
+```azurepowershell
+Disconnect-AzAccount
+```
 
 ## Next steps
 
-In this quickstart, you've added the Resource Graph module to your Azure PowerShell environment and
-run your first query. To learn more about the Resource Graph language, continue to the query
-language details page.
+In this quickstart, you added the Resource Graph module to your Azure PowerShell environment and ran a query. To learn more, go to the query language details page.
 
 > [!div class="nextstepaction"]
-> [Get more information about the query language](./concepts/query-language.md)
+> [Understanding the Azure Resource Graph query language](./concepts/query-language.md)

articles/governance/resource-graph/samples/advanced.md

@@ -38,7 +38,7 @@ before you begin.
 Azure CLI (through an extension) and Azure PowerShell (through a module) support Azure Resource
 Graph. Before running any of the following queries, check that your environment is ready. See
 [Azure CLI](../first-query-azurecli.md#install-the-extension) and [Azure
-PowerShell](../first-query-powershell.md#add-the-resource-graph-module) for steps to install and
+PowerShell](../first-query-powershell.md#install-the-module) for steps to install and
 validate your shell environment of choice.
 
 ## Show resource types and API versions

articles/governance/resource-graph/samples/starter.md

@@ -42,7 +42,7 @@ before you begin.
 Azure CLI (through an extension) and Azure PowerShell (through a module) support Azure Resource
 Graph. Before running any of the following queries, check that your environment is ready. See
 [Azure CLI](../first-query-azurecli.md#install-the-extension) and [Azure
-PowerShell](../first-query-powershell.md#add-the-resource-graph-module) for steps to install and
+PowerShell](../first-query-powershell.md#install-the-module) for steps to install and
 validate your shell environment of choice.
 
 ## Count Azure resources