How to Delete your Power Apps Community Plan Environment

If you are like me, the best way to learn is hands on. There are hundreds of Power Platform community content such as blogs, videos, presentations and learning paths.

Chances are, your boss or clients won’t be keen on you experimenting using their production environments. A great way to experiment is to use the Power Apps Community Plan. The community plan is a FREE, non-production environment where you can build and try out many aspects of the Power Platform.

Power Apps Community Plan

However, over time it is going to get filled with junk. There will be a bunch of entities that you created when you wanted to try building a model-driven app. There was that canvas app you built for the hackathon. Remember that old portal you created to figure out how entity permissions worked?

There will come a day when you want to wipe that environment clean and start from scratch.

Typical Power Apps Developer Environment after a few months

No problem, right? You know you can delete environments using the Power Platform Admin center. Select the environment and choose Delete.

Delete Power Platform Environment

However, once you select your community plan environment (aka Developer environment) you notice that you do NOT have the option to delete or reset the environment!

Delete not available on Environment

The ability to delete developer environments is blocked from the Power Platform Admin center.

PowerShell to the Rescue!

As per the Microsoft Docs, Tenant level admins have the ability to delete an individual environment from the user interface, however this still doesn’t appear to be the case. However, it does provide how to delete the environment using PowerShell.

PowerShell is a task-automation, command-line scripting language. PowerShell is used by administrators to automate a variety of tasks.

The first step is to enable the Power Platform commandlets on your machine. (Assuming you are running a Windows machine, right?)

Search for Powershell and run as an Administrator.

Start PowerShell

You will be presented with a command-line interface. If you are 30 years old or below, don’t be afraid, this is how your parents learned how to interact with a computer. They didn’t click, they typed in commands (just like in the movies).

Install Power Platform Modules

The next step is to install the Power Platform modules. Again, Microsoft Docs has some great resources (click here).

PowerShell

Enter in the following (cut and paste or type)

Install-Module -Name Microsoft.PowerApps.Administration.PowerShell

You may get a few messages about “untrusted repositories” In all cases, choose “Y” or “A” to continue the process.

Don’t worry about untrusted repositories

Then enter in the following (cut and paste, or type)

Install-Module -Name Microsoft.PowerApps.PowerShell -AllowClobber

Again, you may get a few messages about untrusted repositories.

Locate your Developer Environment GUID

Now that the Power Platform modules are installed, you have access to a large list of different automation tasks for various Power Platform chores (e.g. create environments, update permissions, etc) If you are interested to learn more, check out the Microsoft Docs.

For now, lets locate the GUID of the developer environment you wish to delete.

Enter in the following command;

Get-AdminPowerAppEnvironment

You will then get prompted for your Power Platform credentials, enter in your login and password.

Enter in credentials

You will then see the listing of all your environments. Locate your developer environment and copy the GUID. You will need this in the next step.

Locate Developer Environment GUID

Delete that Developer Environment!

NOTE: You cannot backup your environment. Once it is gone, it is gone. There will not even be a “Are you sure?” message (that you would likely ignore anyway). If you do want to save something, export the assets.

The final step is to delete the developer environment. Enter in the following command;

Remove-AdminPowerAppEnvironment -EnvironmentName <<guid>>
Delete Developer Environment

And that’s it! Your developer environment is now gone. Deleted, kaput, gonzo. You can now go back to the Power Apps Community Plan site and create a brand new fresh environment.

Summary

Everyone deserves a fresh start, including Power Platform learners. I hope these steps give you that clean new environment to continue learning and experimenting cool new Power Platform features. I also hope you learned something about PowerShell, and possibly exposed you to a new world of automating a variety of tedious Power Platform tasks.

Cover Photo by Devin Avery on Unsplash

Garbage Photo by NeONBRAND on Unsplash

Nick Doelman is a Microsoft Business Applications MVP, a Microsoft Certified Trainer and isn’t afraid of command-line interfaces. Hear Nick talk about building business applications at DynamicsCon on his talk “You Might Not Need Dynamics CRM. You Need a Power App!

2 thoughts on “How to Delete your Power Apps Community Plan Environment

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s