If you’re evaluating Microsoft Material and don’t at present personal a Premium Capability, likelihood is you’re utilizing Microsoft Material Trial Capacities. All Energy BI customers inside an organisation or particular safety teams given the rights can decide into Material Trial Capacities. Due to this fact, chances are you’ll have already got a number of Trial Material Capacities in your tenant. Your Material Directors can particularly management who can decide into the Material Trial capacities inside the Material Admin Portal, on the Assist and help settings part, and enabling the Customers can attempt Microsoft Material paid options setting as proven within the following picture:

The authorised customers can then decide into Material Trial by following this course of:

1. Click on the Account Supervisor on the highest proper nook of the web page
2. Click on the Begin trial button
3. Click on the Begin trial button once more
4. Present the required particulars
5. Click on the Lengthen my free trial button

The next picture exhibits the previous steps:

As you see, opting into Material Trial is easy, except it isn’t!

There are instances the place authorised customers can’t begin their Material Trial as a result of their tenant has already exceeded the restrict of accessible trial capacities. In that case, the customers get the next message:

Unable to enroll in the Microsoft Material trial
We can’t assign you a free Microsoft Material trial capability as a result of your Microsoft tenant has reached the utmost variety of out there free trial capacities.

If we do some digging, we discover out that the restricted variety of out there trial capacities is documented within the official Micrsoft Be taught’s web site. To sum up the documentation, the customers who face this concern have a few choices being:

• Buy a Material capability
• Ask one other trial capability consumer to provide you with entry to a workspace assigned to their trial capability
• Ask your Material administrator(s) to create a Microsoft help ticket to extend your tenant’s capability limits

These options are all easy. However chances are you’ll face some sudden roadblocks. In some instances, many individuals inside the organisation wish to be taught Microsoft Material. Nonetheless, the organisation’s governance insurance policies don’t permit the creation of workspaces on the manufacturing tenant for self-learning functions. As an alternative, the customers should use their Private Workspace for studying functions.

This weblog put up focuses on taking a look at our choices to beat this problem.

We’ve two choices requiring the Material Admin position as follows:

• Reassign private workspaces from the Material Admin Portal
• Use Energy BI REST APIs to assign workspaces to a Material trial capability

Reassign Private Workspaces from the Material Admin Portal

Comply with these steps to Reassign private workspaces in case you are a Material administrator:

1. Inside the Admin Portal click on the Workspaces tab
2. Choose a private workspace
3. Click on the Reassign Workspace from the ribbon
4. Choose the Trial choice
5. Click on the Save button

As we see, the non-public workspace is now assigned to a trial capability.

It seems prefer it did the trick, however there’s a caveat. This technique works fantastic if now we have just one Material trial capability within the tenant. As we noticed earlier, now we have but to be given the choice to pick a selected Material capability. As an alternative, we simply chosen the Trial license mode. In my checks on a tenant with a number of trial capacities, the above course of at all times assigned the workspace to the newer capability (the capability that was created final). However what if you wish to assign the non-public workspaces to a selected capability and to not each capability? Energy BI APIs to the rescue!

Use Energy BI REST APIs to assign workspaces to a Material trial capability

As talked about earlier than, we have to be a Material Admin to implement this technique efficiently. The required API is the Admin – Capacities AssignWorkspacesToCapacity. This API’s technique is POST, so we have to move the checklist of workspace IDs and the capability ID to the API’s Physique. The Physique for this API should observe this construction:

{
  "capacityMigrationAssignments": [
    {
      "targetCapacityObjectId": "CAPACITY_ID",
      "workspacesToAssign": [
        "WORKSPACE_ID1"
        , "WORKSPACE_ID2"
        , ...
      ]
    }
  ]
}

We’ve a few choices to get the capability ID and workspace IDs, similar to utilizing Microsoft Material’s Consumer Interface (UI), Discover the Function Utilization and Adoption semantic mannequin underneath the Admin Monitoring workspace of the Microsoft Purview hub, and working Admin REST APIs. The only means for the aim of this blogpost is to make use of Microsoft Material’s net UI. To maintain this weblog brief and easy, we use the net UI to seize the capability and workspace IDs. I’ll write a separate weblog to elucidate the Microsoft Purview hub setup and utilization, so keep tuned!

Get Capability ID in Microsoft Material

Login to your Microsoft Material account and navigate to the Admin Portal. Comply with these steps to get the specified capability ID:

1. Click on the Capability settings tab
2. Click on the specified capability kind; in our case, we’re after a Material Trial capability, so we click on the Trial tab
3. Click on the Settings for the specified capability underneath the Actions column
4. The Capability ID seems on the backside of the capability Settings web page

The next picture exhibits these steps:

Get Workspace ID in Microsoft Material

On Microsoft Material, navigate to the Admin Portal, then observe these steps:

1. Choose the Workspaces tab
2. Hover over the specified Private Workspace and click on the Actions ellipsis button
3. Choose the Particulars choice
4. The workspace ID exhibits up

The next picture exhibits these steps:

Run Admin/Capacities/AssignWorkspaces REST API

Now that now we have the capability ID and workspace ID helpful, we will go forward and run the POST https://api.powerbi.com/v1.0/myorg/admin/capacities/AssignWorkspaces REST API.

I’m a giant fan of the Strive It functionality within the Energy BI REST API pages that allows us to actually run the APIs with out writing a single line of code, which is ideal for working one-off actions. Comply with these steps to run the API immediately from the API documentation webpage:

1. Go to Microsoft Be taught documentation for the admin/capacities/assignworkspaces API
2. Click on the Strive It button

Tip

If that is the primary time you employ this characteristic, you have to agree with and provides the required consent.

3. On the Affirm your account click on the Proceed with Account button

4. Copy/paste the Physique half as proven right here

Word

Bear in mind to exchange the CAPACITY_ID and WORKSPACE_ID with the IDs captured from the Microsoft Material UI.

5. Click on the Run button

We’ll get Response Code: 200 if the API efficiently runs, as proven within the following picture:

If we test the Workspaces on the Admin Portal, we see that the non-public workspace is now assigned to the specified capability.

Whereas Microsoft generously gives a free Material trial capability to empower organisations to be taught this expertise, sure limitations could current roadblocks for customers exploring Microsoft Material. This weblog has tackled these challenges, specializing in efficient options like assigning Private Workspaces to current Material Trial capabilities, making certain a smoother studying expertise for the customers. Understanding and overcoming these limitations is essential for directors navigating governance insurance policies of their organisations.

As at all times, I invite you to share your ideas within the feedback beneath. Comply with me on X (Twitter) and LinkedIn to get notified of my new posts.