adds arg power bi connector quickstart

Author: davidsmatlak

articles/governance/resource-graph/media/power-bi-connector-quickstart/power-bi-get-data.png

@@ -1,7 +1,7 @@
 ---
 title: Overview of Azure Resource Graph
 description: Understand how the Azure Resource Graph service enables complex querying of resources at scale across subscriptions and tenants.
-ms.date: 01/20/2024
+ms.date: 01/29/2024
 ms.topic: overview
 ms.custom: devx-track-arm-template
 ---
@@ -145,6 +145,13 @@ Resource Graph also supports Azure CLI, Azure PowerShell, and REST API. The quer
 
 You can create alert rules by using either Azure Resources Graph queries or integrating Log Analytics with Azure Resources Graph queries through Azure Monitor. Both methods can be used to create alerts for Azure resources. For examples, go to [Quickstart: Create alerts with Azure Resource Graph and Log Analytics](./alerts-query-quickstart.md).
 
+## Run queries with Power BI connector
+
+> [!NOTE]
+> The Azure Resource Graph Power BI connector is in public preview.
+
+The Azure Resource Graph Power BI connector runs queries at the tenant level but you can change the scope to subscription or management group. The Power BI connector has an optional setting to return all records if your query results have more than 1,000 records. For more information, go to [Quickstart: Run queries with the Azure Resource Graph Power BI connector](./power-bi-connector-quickstart.md).
+
 ## Next steps
 
 - Learn more about the [query language](./concepts/query-language.md).

articles/governance/resource-graph/media/power-bi-connector-quickstart/query-dialog-box-options.png

@@ -0,0 +1,80 @@
+---
+title: Run queries with the Azure Resource Graph Power BI connector
+description: In this quickstart, you learn how to run queries with the Azure Resource Graph Power BI connector.
+ms.date: 01/29/2024
+ms.topic: quickstart
+---
+
+# Quickstart: Run queries with the Azure Resource Graph Power BI connector
+
+In this quickstart, you learn how to run queries with the Azure Resource Graph Power BI connector. By default the Power BI connector runs queries at the tenant level but you can change the scope to subscription or management group. Resource Graph by default returns a maximum of 1,000 records but the Power BI connector has an optional setting to return all records if your query results have more than 1,000 records.
+
+> [!NOTE]
+> The Azure Resource Graph Power BI connector is in public preview.
+
+> [!TIP]
+> If you participated in the private preview, delete your _AzureResourceGraph.mez_ preview file. If the file isn't deleted, your custom connector might be used by Power Query instead of the certified connector.
+
+## Prerequisites
+
+- If you don't have an Azure account with an active subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
+- [Power BI Desktop](https://powerbi.microsoft.com/desktop/).
+- Azure role-based access control rights with at least _Reader_ role assignment to resources. Learn more about [how to assign roles](../../role-based-access-control/role-assignments-portal.md).
+
+## Connect Resource Graph with Power BI connector
+
+After Power BI Desktop is installed, you can connect Resource Graph with Power BI connector so that you can run a query. If you don't have a query to run, you can use the following sample that queries for storage accounts.
+
+```kusto
+resources
+| where type == 'microsoft.storage/storageaccounts'
+```
+
+The following example runs a query with the default settings.
+
+1. Open the Power BI Desktop app on your computer and close any dialog boxes that are displayed.
+1. Go to **Home** > **Get data** > **More** > **Azure** > **Azure Resource Graph** and select **Connect**.
+
+   :::image type="content" source="./media/power-bi-connector-quickstart/power-bi-get-data.png" alt-text="Screenshot of the get data dialog box in Power BI Desktop to select the Azure Resource Graph connector.":::
+
+1. On the **Azure Resource Graph** dialog box, enter your query into the **Query** box.
+
+   :::image type="content" source="./media/power-bi-connector-quickstart/query-dialog-box.png" alt-text="Screenshot of the Azure Resource Graph dialog box to enter a query and use the default settings.":::
+
+1. Select **OK** to run the query and if prompted, enter your credentials.
+1. Select **Connect** to run the query. The results are displayed in Power BI Desktop.
+1. Select **Load** or **Transform Data**.
+
+   - **Load** imports the query results into Power BI Desktop.
+   - **Transform Data** opens the Power Query Editor with your query results.
+
+## Use optional settings
+
+You can select optional values to change the Azure subscription or management group that the query runs against or to get query results of more than 1,000 records.
+
+| Option | Description |
+| ---- | ---- |
+| Scope | You can select subscription or management group. Tenant is the default scope when no selection is made. |
+| Subscription ID | Required if you select subscription scope. Specify the Azure subscription ID. Use a comma-separated list to query multiple subscriptions. |
+| Management group ID | Required if you select management group scope. Specify the Azure management group ID. Use a comma-separated list to query multiple management groups. |
+| Advanced options | To get more than 1,000 records change `$resultTruncated` to `FALSE`. By default Resource Graph returns a maximum of 1,000 records. |
+
+For example, to run a query for a subscription that returns more than 1,000 records:
+
+- Set the scope to subscription.
+- Enter a subscription ID.
+- Set `$resultTruncated` to `FALSE`.
+
+:::image type="content" source="./media/power-bi-connector-quickstart/query-dialog-box-options.png" alt-text="Screenshot of the Azure Resource Graph dialog box to enter a query and use optional settings for scope, subscription ID, and $resultTruncated.":::
+
+## Clean up resources
+
+When you're finished, close any Power BI Desktop or Power Query windows and save or discard your queries.
+
+## Related content
+
+For more information about the query language or how to explore resources, go to the following articles.
+
+- [Understanding the Azure Resource Graph query language](./concepts/query-language.md).
+- [Explore your Azure resources with Resource Graph](./concepts/explore-resources.md).
+- Sample queries listed by [table](./samples/samples-by-table.md) or [category](./samples/samples-by-category.md).

articles/governance/resource-graph/media/power-bi-connector-quickstart/query-dialog-box.png

@@ -38,6 +38,9 @@
   - name: Create alert on ARG query
     displayName: alerts, portal, resource graph, monitor, log analytics, query
     href: ./alerts-query-quickstart.md
+  - name: Run ARG query with Power BI connector
+    displayName: portal, resource graph, query, power bi
+    href: ./power-bi-connector-quickstart.md
 - name: Tutorials
   items:
   - name: Create and share a query in Azure portal