powerplatform_environment (Resource)

This resource manages a PowerPlatform environment

A Power Platform environment is a space in which you can store, manage, and share your organization's business data, apps, chatbots, and flows. It also serves as a container to separate apps that may have different roles, security requirements, or target audiences. Each environment is created under an Azure Active Directory tenant and is bound to a geographic location. You can create different types of environments, such as production, sandbox, trial, or developer, depending on your license and permissions. You can also move resources between environments and set data loss prevention policies. A Power Platform environment can have zero or one Microsoft Dataverse database, which provides storage for your apps and chatbots. You can only connect to the data sources that are deployed in the same environment as your app or chatbot. For more information, you can check out the following links:

• Environments overview - Power Platform | Microsoft Learn
• Create and manage environments in the Power Platform admin center
• Establishing an environment strategy - Microsoft Power Platform

Known Limitations

• Service principals can't create development type environments

Example Usage

terraform {
  required_providers {
    powerplatform = {
      source = "microsoft/power-platform"
    }
  }
}

provider "powerplatform" {
  use_cli = true
}

resource "powerplatform_environment" "development" {
  display_name     = "example_environment"
  location         = "europe"
  azure_region     = "northeurope"
  environment_type = "Sandbox"
  dataverse = {
    language_code     = "1033"
    currency_code     = "USD"
    domain            = "mydomain"
    security_group_id = "00000000-0000-0000-0000-000000000000"
  }
}

Schema

Required

• display_name (String) Display name
• environment_type (String) Type of the environment (Sandbox, Production etc.)
• location (String) Location of the environment (europe, unitedstates etc.). Can be queried using the powerplatform_locations data source. The region of your Entra tenant may limit the available locations for Power Platform. Changing this property after environment creation will result in a destroy and recreation of the environment (you can use the prevent_destroy lifecycle metatdata as an added safeguard to prevent accidental deletion of environments).

Optional

• azure_region (String) Azure region of the environment (westeurope, eastus etc.). Can be queried using the powerplatform_locations data source. This property should only be set if absolutely necessary like when trying to create an environment in the same Azure region as Azure resources or Fabric capacity. Changing this property after environment creation will result in a destroy and recreation of the environment (you can use the prevent_destroy lifecycle metatdata as an added safeguard to prevent accidental deletion of environments).
• billing_policy_id (String) Billing policy id (guid) for pay-as-you-go environments using Azure subscription billing
• dataverse (Attributes) Dataverse environment details (see below for nested schema)

Read-Only

• id (String) Unique environment id (guid)

Nested Schema for dataverse

Required:

• currency_code (String) Unique currency name
• language_code (Number) Unique language LCID (integer)
• security_group_id (String) Unique security group id (guid). For an empty security group, set this property to 0000000-0000-0000-0000-000000000000

Optional:

• domain (String) Domain name of the environment
• template_metadata (String) Additional D365 environment template metadata (if any)
• templates (List of String) The selected instance provisioning template (if any)

Read-Only:

• linked_app_id (String) The GUID of the linked D365 application
• linked_app_type (String) The type of the linked D365 application
• linked_app_url (String) The URL of the linked D365 application
• organization_id (String) Unique organization id (guid)
• url (String) Url of the environment
• version (String) Version of the environment