Skip to main content
cancel
Turn on suggestions
Auto-suggest helps you quickly narrow down your search results by suggesting possible matches as you type.
Showing results for 
Search instead for 
Did you mean: 

Did you hear? There's a new SQL AI Developer certification (DP-800). Start preparing now and be one of the first to get certified. Register now

talk2rick
Microsoft Employee
‎06-30-2021 10:51 AM

Heads up: breaking change coming to Power BI PowerShell Cmdlets

It’s been a while since we talked about the PowerShell Power BI management cmdlets on this blog. Since we announced them almost 3 years ago, we have seen steady adoption as well as the formation of an active community on Github.

Today I’d like to announce two important updates that will benefit our growing community of cmdlet users: a breaking change and an update to the auth library used for the Connect-PowerBIserviceAccount cmdlet.

MicrosoftPowerBIMgmt versions older than 1.0946 will break during login: please update modules to a newer version

We have made changes to the way the cmdlets talk to Azure Active Directory. As a result, MicrosoftPowerBIMgmt version older than 1.0946 will error out during the login flow. This change will start to roll out on July 30th, so please upgrade your MicrosoftPowerBIMgmt module version by that date to avoid disruption.

To find out what version of the module you have, run this command in Windows PowerShell:

PS C:\windows\system32> Get-InstalledModule -Name MicrosoftPowerBIMgmt

Heads_up_breaking_change_coming_to_Power_BI_PowerShell_CmdletsHeads_up_breaking_change_coming_to_Power_BI_PowerShell_Cmdlets

If the version number shown is equal to or greater than 1.0946, no further action is needed on your part. However, if your version number is lower than 1.0946, you need to update the module to avoid breaking your existing Powershell scripts. To do so, simply open Windows PowerShell as an Admin and execute the following command:

Update-Module -Name MicrosoftPowerBIMgmt

Connect-PowerBIServiceAccount is now using MSAL: no action required

Additionally, we have upgraded the Connect-PowerBIserviceAccount cmdlet to use the Microsoft Authentication Library (MSAL), rather than the Active Directory Authentication Library (ADAL). MSAL is now the recommended authentication library for use with the Microsoft Identity Platform. It is more secure and resilient, supports more authentication features, and has a number of other benefits . This update requires no action on your part, and does not change the current cmdlet end-user experience. Give it a try to address incompatibility issues previously  experienced when using  some Azure services (such as this or this).

Next steps

Please upgrade your MicrosoftPowerBIMgmt module to the latest version before July 30th, to avoid breaking your code and enable you to take advantage of new MSAL auth capabilities. As always, please leave feedback and questions below, or file an issue on Github. We’d love to hear from you!

0