Merge pull request #12901 from MicrosoftDocs/main

1/20/2025 PM Publish

powerbi-docs/collaborate-share/service-modern-usage-metrics.md

@@ -329,7 +329,6 @@ In addition to the above differences between previous and improved usage metrics
 - If your organization is using [Azure Private Link](/fabric/security/security-private-links-overview) in Power BI, because client-telemetry is not available the usage metrics reports will only contain Report Open events.
 - If your organization is using [Azure Private Link](/fabric/security/security-private-links-overview) and **Block Public Internet Access** in Power BI, the refresh for the semantic model will fail and the usage metrics report won't show any data.
 - In order to create and refresh the usage metrics report, the user is required to authenticate to enable the backend API calls to extract the tenant telemetry. For privacy reasons, guest users aren't allowed this authentication. This authentication is only allowed for members of the tenant.
-- Page views that are made from mobile devices aren't shown in the usage metrics report.
 - Duplicate reports with different Report ObjectIds in the usage metrics report can show up for the following scenarios:
     - Reports have been deleted and re-created with the same name
        - If a report has been deleted and then re-created with the same name, it continues to show up in the filters for the usage metrics report.

powerbi-docs/developer/embedded/azure-pbie-pause-start.md

@@ -9,13 +9,16 @@ tags: ''
 ms.service: powerbi
 ms.subservice: powerbi-developer
 ms.topic: how-to
-ms.date: 07/18/2024
+ms.date: 01/19/2025
+#customer intent: As a Power BI Embedded capacity admin, I want to learn how to pause and start my capacity in the Azure portal to prevent billing when the capacity isn't needed.
 ---
 
-# Pause and start your Power BI Embedded capacity in the Azure portal
+# Pause and start your Power BI Embedded A SKU capacity in the Azure portal
 
 This article walks through how to pause and start a Power BI Embedded capacity in Microsoft Azure. This article assumes you have a Power BI Embedded capacity. If you haven't, see [Create Power BI Embedded capacity in the Azure portal](azure-pbie-create-capacity.md) to get started.
 
+This information only applies to A SKU embedded capacities. EM SKU embedded capacities don't work the same way. For information on pausing F SKU capacities, see [Pause and resume your capacity](/fabric/enterprise/pause-resume).
+
 If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/) before you begin.
 
 ## Pause your capacity

powerbi-docs/developer/embedded/create-an-azure-active-directory-tenant.md

@@ -1,26 +1,25 @@
 ---
-title: Create a Microsoft Entra tenant to use with Power BI embedded 
-description: Learn how to create a new Microsoft Entra tenant for a custom embedded analytics application that calls Power BI REST APIs and enables embedded BI intelligence for customers.
+title: Create a Microsoft Entra tenant for Power BI embedded 
+description: Learn how to create a new Microsoft Entra tenant for a custom embedded analytics application that calls Power BI REST APIs.
 author: mberdugo
 ms.author: monaberdugo
 ms.reviewer: ''
 ms.service: powerbi
 ms.subservice: powerbi-developer
 ms.topic: how-to
-ms.date: 01/15/2025
+ms.date: 01/19/2025
+#customer intent: As a developer, I want to create a Microsoft Entra tenant so that I can create a custom app that calls Power BI REST APIs.
 ---
 
 # Create a Microsoft Entra tenant to use with Power BI
 
 **APPLIES TO:** :::image type="icon" source="../../includes/media/yes-icon.svg" border="false"::: App owns data :::image type="icon" source="../../includes/media/yes-icon.svg" border="false"::: User owns data
 
-This article shows you how to create a new Microsoft Entra tenant to use when creating a custom app that calls [Power BI REST APIs](/rest/api/power-bi/).
+This article shows you how to create a Microsoft Entra tenant to use when creating a custom app that calls [Power BI REST APIs](/rest/api/power-bi/).
 
-A Microsoft Entra tenant is a reserved Microsoft Entra service instance that an organization receives and owns once it signs up for a Microsoft cloud service such as Azure, Microsoft Intune, or Microsoft 365. Each tenant represents an organization, and is distinct and separate from other Microsoft Entra tenants.
+A Microsoft Entra tenant is a reserved Microsoft Entra service instance that an organization receives and owns once it signs up for a Microsoft cloud service such as Azure, Microsoft Intune, or Microsoft 365. Each tenant represents an organization, and is distinct and separate from other Microsoft Entra tenants. Once you have a Microsoft Entra tenant, you can define an application and assign it permissions so it can call [Power BI REST APIs](/rest/api/power-bi/).
 
-Once you have a Microsoft Entra tenant, you can define an application and assign it permissions so it can call [Power BI REST APIs](/rest/api/power-bi/).
-
-Your organization may already have a Microsoft Entra tenant that you can use for your app, or you can create a new tenant specifically for your app. This article shows how to create a new tenant.
+Your organization may already have a Microsoft Entra tenant that you can use for your app. If it doesn't, here's how you can create a new tenant specifically for your app.
 
 <a name='create-an-azure-active-directory-tenant'></a>
 
@@ -49,23 +48,19 @@ Create a master user to use as your master embedding account. You can think of t
 
 2. Under **Manage**, select **Users**.
 
-    > [!div class="mx-imgBorder"]
-    >![Screenshot of Microsoft Entra users and groups tab.](media/create-an-azure-active-directory-tenant/users-and-groups.png)
+    :::image type="content" source="media/create-an-azure-active-directory-tenant/users-and-groups.png" alt-text="Screenshot of Microsoft Entra users and groups tab.":::
 
 3. Under **+ New user** select **+ Create new user**.
 
-    > [!div class="mx-imgBorder"]
-    >![Screenshot showing Microsoft Entra ID create new user button.](media/create-an-azure-active-directory-tenant/create-new-user.png)
+    :::image type="content" source="media/create-an-azure-active-directory-tenant/create-new-user.png" alt-text="Screenshot showing Microsoft Entra ID create new user button.":::
 
 4. Provide a **Display Name** and **User name** for your tenant Global Admin. Leave **Directory role** as **user**. Note the password, then select **Create**.
 
-    > [!div class="mx-imgBorder"]
-    >![Screenshot showing how to create a Microsoft Entra ID master user.](media/create-an-azure-active-directory-tenant/master-user.png)
+    :::image type="content" source="media/create-an-azure-active-directory-tenant/master-user.png" alt-text="Screenshot showing how to create a Microsoft Entra ID master user.":::
 
 5. Sign up for Power BI with the user account that you created in step 4. Go to [powerbi.com](https://powerbi.microsoft.com/getting-started-with-power-bi/) and select **Try Power BI for free**.
 
-    > [!div class="mx-imgBorder"]
-    >![Screenshot showing the Power BI free offer.](media/create-an-azure-active-directory-tenant/try-powerbi-free.png)
+    :::image type="content" source="media/create-an-azure-active-directory-tenant/try-powerbi-free.png" alt-text="Screenshot showing the Power BI free trial offer.":::
 
     When you sign up, you're prompted to try Power BI Pro free for 60 days. You can opt into that to become a Pro user, which gives you the option to [start developing an embedded solution](embed-sample-for-customers.md).
 
@@ -74,9 +69,8 @@ Create a master user to use as your master embedding account. You can think of t
 
 ## Related content
 
-Now that you have a Microsoft Entra tenant, you can use this tenant to test items within Power BI. You can also embed Power BI dashboards and reports in your app. For more information, see [How to embed your Power BI dashboards, reports, and tiles](embed-sample-for-customers.md).
-
 * [Register an app](register-app.md)
-* [Quickstart: Set up a dev environment](/azure/active-directory/develop/active-directory-howto-tenant)  
+* [Quickstart: Set up a dev environment](/azure/active-directory/develop/active-directory-howto-tenant)
+* [How to embed your Power BI dashboards, reports, and tiles](embed-sample-for-customers.md)
 
 More questions? [Try asking the Power BI Community](https://community.powerbi.com/)

powerbi-docs/developer/embedded/embed-sample-for-customers.md

@@ -7,7 +7,7 @@ ms.reviewer: ""
 ms.topic: tutorial
 ms.service: powerbi
 ms.subservice: powerbi-developer
-ms.date: 10/21/2024
+ms.date: 01/06/2025
 #customer intent: As a developer, I want to learn how to embed Power BI content into my application, so that I can provide my users with interactive reports, dashboards, and tiles.
 ---
 
@@ -177,6 +177,9 @@ Registering your application with Microsoft Entra ID allows you to:
 
 [!INCLUDE[Create a Power BI report](../../includes/embed-tutorial-create-report.md)]
 
+> [!NOTE]
+> If your report uses a Direct Lake semantic model, make sure review these [limitations](#considerations-and-limitations).
+
 ## Step 5 - Get the embedding parameter values
 
 To embed your content, you need to obtain certain parameter values. The following table shows the required values, and indicates if they're applicable to the *service principal* authentication method, the *master user* authentication method, or both.
@@ -518,6 +521,14 @@ Try out the [Power BI embedded analytics playground](./power-bi-playground.md) t
 > [!IMPORTANT]
 > If you used free embed trial tokens for development, you must buy a capacity for production. Until a capacity is purchased, the *Free trial version* banner will continue to appear at the top of the embedded report.
 
+## Considerations and limitations
+
+The following limitations apply for Direct Lake mode:
+
+* Requires a [V2 embed token](./generate-embed-token.md).
+* If you're using a service principal, you need a [Fixed Identity](/fabric/get-started/direct-lake-fixed-identity) connection (No-SSO).
+* Currently, setting a [service principal](./embed-service-principal.md) as the authentication method on a [Fixed Identity](/fabric/get-started/direct-lake-fixed-identity) connection is the only option supported through automation. Other methods are supported manually through the portal.
+
 ## Related content
 
 * [Move to production](move-to-production.md)

powerbi-docs/developer/embedded/embedded-faq.yml

@@ -160,8 +160,7 @@ sections:
         answer: |
           When a user is granted permissions to a workspace, app, or item, it might not be immediately available through API calls.
           The result can either be a missing item in a 'GET' API response, or an error when trying to use the item.
-          The user can resolve this issue by calling [refreshUserPermissions API](/rest/api/power-bi/users/refreshuserpermissions), which updates the user permissions.
-          
+          The user can resolve this issue by calling [refreshUserPermissions API](/rest/api/power-bi/users/refreshuserpermissions), which updates the user permissions.      
           
       - question: |
           How can I find my PBI tenant region?
@@ -190,7 +189,7 @@ sections:
           Yes, there are PowerShell cmdlets and Azure Resource Manager REST APIs you can use to create and manage PBIE resources.
           
           * [Rest APIs](/rest/api/power-bi-embedded/) 
-          * [PowerShell cmdlets](/powershell/module/azurerm.powerbiembedded/)
+          * [PowerShell cmdlets](/powershell/module/microsoftpowerbimgmt.capacities)
           
       - question: |
           What is the PBI Embedded capacity role in a PBI Embedded solution?
@@ -290,6 +289,14 @@ sections:
           > [!NOTE]
           > *Master user* is not supported.
 
+      - question: |
+          How can I embed a report that uses a Direct Lake semantic model?
+        answer: |
+          To use Power BI Embedded with Direct Lake mode:
+          1.	Create a [Direct Lake enabled semantic model](/fabric/get-started/direct-lake-overview). 
+          1. Specify a fixed identity for a Direct   2. Specify a [fixed identity](/fabric/get-started/directlake-fixed-identity) for a Direct Lake enabled semantic model.
+          1. [Embed a Power BI report](/power-bi/developer/embedded/embed-sample-for-customers) over the Direct Lake semantic model for your customers.
+
       - question: |
           Can you sign into the Power BI service with service principal?
         answer: |
@@ -346,7 +353,7 @@ sections:
       - question: |
           Can I get a trial experience for Power BI Embedded in Azure?
         answer: |
-          Since Power BI Embedded is a part of Azure, it's possible to use the service with the [$200 credit received when signing up for Azure](https://azure.microsoft.com/free/).
+          Since Power BI Embedded is a part of Azure, you can use the service with the [$200 credit received when signing up for Azure](https://azure.microsoft.com/free/).
           
       - question: |
           Is Power BI Embedded available for national/regional clouds (US Government, Germany, China)?
@@ -357,40 +364,6 @@ sections:
           Is Power BI Embedded available for non-profits and educational?
         answer: |
           There's no special Azure pricing for non-profit and educational entities.
-
-  - name: Power BI Workspace Collection
-    questions:
-      - question: |
-          What is Power BI Workspace Collection?
-        answer: |
-          **Power BI Workspace Collection** (**Power BI Embedded** Version 1) is a solution based on the **Power BI Workspace Collection** Azure resource. This solution allows you to create **Power BI Embedded** applications for your customers using Power BI content under the **Power BI Workspace Collection** solution, dedicated APIs, and workspace collection keys to authenticate the application to Power BI.
-          
-      - question: |
-          Is Power BI Workspace Collection on a deprecation path?
-        answer: |
-          Yes, but customers that are already using the **Power BI Workspace Collection** solution can continue to use it until deprecation. Customers can also create new workspace collections and any **Power BI Embedded** applications that still use the **Power BI Workspace Collection** solution.
-          
-          However, this also means that new features aren't added to any **Power BI Workspace Collection** solutions. We encourage customers to plan their migration to the new **Power BI Embedded** solution.
-          
-      - question: |
-          When is Power BI Workspace Collection support discontinued?
-        answer: |
-          Customers that are already using the **Power BI Workspace Collections** solution can continue to use it until the end of their support agreement.
-
-      - question: |
-          In what regions can I create a PBI Workspace Collection?
-        answer: |
-          The available regions are Australia Southeast, Brazil South, Canada Central, East US 2, Japan East, North Central US, North Europe, South Central US, Southeast Asia, UK South, West Europe, West India, and West US.
-
-      - question: |
-          Why should I migrate from PBI Workspace Collection to Power BI Embedded?
-        answer: |
-          There are some **Power BI Embedded** solution features and capabilities  that you can't do with **Power BI Workspace Collection**.
-          
-          Some of the features are:
-          * All the PBI data sources are supported. Only  two **Power BI Workspace Collection** data sources are supported. 
-          * Features such as Q&A, refresh, bookmarks, embedding dashboards & tiles, and custom menus are only supported in the **Power BI Embedded** solution.
-          * Capacity billing model.
           
   - name: Embedding setup tool
     questions: