published on Monday, May 18, 2026 by rpothin
published on Monday, May 18, 2026 by rpothin
Manages settings on a Power Platform environment. Settings are applied via PATCH to the BAP admin API. Deletion removes the resource from Pulumi state only (settings cannot be unset).
Create EnvironmentSettings Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new EnvironmentSettings(name: string, args: EnvironmentSettingsArgs, opts?: CustomResourceOptions);@overload
def EnvironmentSettings(resource_name: str,
args: EnvironmentSettingsArgs,
opts: Optional[ResourceOptions] = None)
@overload
def EnvironmentSettings(resource_name: str,
opts: Optional[ResourceOptions] = None,
environment_id: Optional[str] = None,
is_read_audit_enabled: Optional[bool] = None,
audit_retention_period_in_days: Optional[int] = None,
allow_microsoft_trusted_service_tags: Optional[bool] = None,
is_activity_logging_enabled: Optional[str] = None,
is_audit_enabled: Optional[str] = None,
allow_application_user_access: Optional[bool] = None,
is_user_access_audit_enabled: Optional[str] = None,
max_upload_file_size: Optional[str] = None,
plugin_trace_log_setting: Optional[str] = None,
power_apps_component_framework_for_canvas_apps: Optional[bool] = None,
reverse_proxy_ip_addresses: Optional[str] = None,
show_dashboard_cards_in_expanded_state: Optional[bool] = None)func NewEnvironmentSettings(ctx *Context, name string, args EnvironmentSettingsArgs, opts ...ResourceOption) (*EnvironmentSettings, error)public EnvironmentSettings(string name, EnvironmentSettingsArgs args, CustomResourceOptions? opts = null)
public EnvironmentSettings(String name, EnvironmentSettingsArgs args)
public EnvironmentSettings(String name, EnvironmentSettingsArgs args, CustomResourceOptions options)
type: powerplatform:EnvironmentSettings
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
resource "powerplatform_environmentsettings" "name" {
# resource properties
}Parameters
- name string
- The unique name of the resource.
- args EnvironmentSettingsArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args EnvironmentSettingsArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args EnvironmentSettingsArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args EnvironmentSettingsArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args EnvironmentSettingsArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var environmentSettingsResource = new Powerplatform.EnvironmentSettings("environmentSettingsResource", new()
{
EnvironmentId = "string",
IsReadAuditEnabled = false,
AuditRetentionPeriodInDays = 0,
AllowMicrosoftTrustedServiceTags = false,
IsActivityLoggingEnabled = "string",
IsAuditEnabled = "string",
AllowApplicationUserAccess = false,
IsUserAccessAuditEnabled = "string",
MaxUploadFileSize = "string",
PluginTraceLogSetting = "string",
PowerAppsComponentFrameworkForCanvasApps = false,
ReverseProxyIpAddresses = "string",
ShowDashboardCardsInExpandedState = false,
});
example, err := powerplatform.NewEnvironmentSettings(ctx, "environmentSettingsResource", &powerplatform.EnvironmentSettingsArgs{
EnvironmentId: pulumi.String("string"),
IsReadAuditEnabled: pulumi.Bool(false),
AuditRetentionPeriodInDays: pulumi.Int(0),
AllowMicrosoftTrustedServiceTags: pulumi.Bool(false),
IsActivityLoggingEnabled: pulumi.String("string"),
IsAuditEnabled: pulumi.String("string"),
AllowApplicationUserAccess: pulumi.Bool(false),
IsUserAccessAuditEnabled: pulumi.String("string"),
MaxUploadFileSize: pulumi.String("string"),
PluginTraceLogSetting: pulumi.String("string"),
PowerAppsComponentFrameworkForCanvasApps: pulumi.Bool(false),
ReverseProxyIpAddresses: pulumi.String("string"),
ShowDashboardCardsInExpandedState: pulumi.Bool(false),
})
resource "powerplatform_environmentsettings" "environmentSettingsResource" {
environment_id = "string"
is_read_audit_enabled = false
audit_retention_period_in_days = 0
allow_microsoft_trusted_service_tags = false
is_activity_logging_enabled = "string"
is_audit_enabled = "string"
allow_application_user_access = false
is_user_access_audit_enabled = "string"
max_upload_file_size = "string"
plugin_trace_log_setting = "string"
power_apps_component_framework_for_canvas_apps = false
reverse_proxy_ip_addresses = "string"
show_dashboard_cards_in_expanded_state = false
}
var environmentSettingsResource = new EnvironmentSettings("environmentSettingsResource", EnvironmentSettingsArgs.builder()
.environmentId("string")
.isReadAuditEnabled(false)
.auditRetentionPeriodInDays(0)
.allowMicrosoftTrustedServiceTags(false)
.isActivityLoggingEnabled("string")
.isAuditEnabled("string")
.allowApplicationUserAccess(false)
.isUserAccessAuditEnabled("string")
.maxUploadFileSize("string")
.pluginTraceLogSetting("string")
.powerAppsComponentFrameworkForCanvasApps(false)
.reverseProxyIpAddresses("string")
.showDashboardCardsInExpandedState(false)
.build());
environment_settings_resource = powerplatform.EnvironmentSettings("environmentSettingsResource",
environment_id="string",
is_read_audit_enabled=False,
audit_retention_period_in_days=0,
allow_microsoft_trusted_service_tags=False,
is_activity_logging_enabled="string",
is_audit_enabled="string",
allow_application_user_access=False,
is_user_access_audit_enabled="string",
max_upload_file_size="string",
plugin_trace_log_setting="string",
power_apps_component_framework_for_canvas_apps=False,
reverse_proxy_ip_addresses="string",
show_dashboard_cards_in_expanded_state=False)
const environmentSettingsResource = new powerplatform.EnvironmentSettings("environmentSettingsResource", {
environmentId: "string",
isReadAuditEnabled: false,
auditRetentionPeriodInDays: 0,
allowMicrosoftTrustedServiceTags: false,
isActivityLoggingEnabled: "string",
isAuditEnabled: "string",
allowApplicationUserAccess: false,
isUserAccessAuditEnabled: "string",
maxUploadFileSize: "string",
pluginTraceLogSetting: "string",
powerAppsComponentFrameworkForCanvasApps: false,
reverseProxyIpAddresses: "string",
showDashboardCardsInExpandedState: false,
});
type: powerplatform:EnvironmentSettings
properties:
allowApplicationUserAccess: false
allowMicrosoftTrustedServiceTags: false
auditRetentionPeriodInDays: 0
environmentId: string
isActivityLoggingEnabled: string
isAuditEnabled: string
isReadAuditEnabled: false
isUserAccessAuditEnabled: string
maxUploadFileSize: string
pluginTraceLogSetting: string
powerAppsComponentFrameworkForCanvasApps: false
reverseProxyIpAddresses: string
showDashboardCardsInExpandedState: false
EnvironmentSettings Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The EnvironmentSettings resource accepts the following input properties:
- Environment
Id string - The ID of the environment to manage settings for. Immutable after creation.
- Allow
Application boolUser Access - Whether service principal (application user) access is allowed.
- bool
- Whether Microsoft trusted Azure service tags are allowed for connectivity.
- Audit
Retention intPeriod In Days - Audit log retention period in days. Use -1 for forever, or a value between 31 and 24855.
- Is
Activity stringLogging Enabled - Whether activity logging is enabled (true or false).
- Is
Audit stringEnabled - Whether auditing is enabled (true or false).
- Is
Read boolAudit Enabled - Whether read auditing is enabled (GDPR). Managed via Dataverse organizations table.
- Is
User stringAccess Audit Enabled - Whether user access auditing is enabled (true or false).
- Max
Upload stringFile Size - Maximum file upload size in bytes.
- Plugin
Trace stringLog Setting - Plugin trace log setting (Off, Exception, All).
- Power
Apps boolComponent Framework For Canvas Apps - Whether Power Apps Component Framework (PCF) controls are enabled for canvas apps.
- Reverse
Proxy stringIp Addresses - Comma-separated list of allowed reverse proxy IP addresses or CIDR ranges.
- Show
Dashboard boolCards In Expanded State - Whether dashboard cards are shown in expanded state by default.
- Environment
Id string - The ID of the environment to manage settings for. Immutable after creation.
- Allow
Application boolUser Access - Whether service principal (application user) access is allowed.
- bool
- Whether Microsoft trusted Azure service tags are allowed for connectivity.
- Audit
Retention intPeriod In Days - Audit log retention period in days. Use -1 for forever, or a value between 31 and 24855.
- Is
Activity stringLogging Enabled - Whether activity logging is enabled (true or false).
- Is
Audit stringEnabled - Whether auditing is enabled (true or false).
- Is
Read boolAudit Enabled - Whether read auditing is enabled (GDPR). Managed via Dataverse organizations table.
- Is
User stringAccess Audit Enabled - Whether user access auditing is enabled (true or false).
- Max
Upload stringFile Size - Maximum file upload size in bytes.
- Plugin
Trace stringLog Setting - Plugin trace log setting (Off, Exception, All).
- Power
Apps boolComponent Framework For Canvas Apps - Whether Power Apps Component Framework (PCF) controls are enabled for canvas apps.
- Reverse
Proxy stringIp Addresses - Comma-separated list of allowed reverse proxy IP addresses or CIDR ranges.
- Show
Dashboard boolCards In Expanded State - Whether dashboard cards are shown in expanded state by default.
- environment_
id string - The ID of the environment to manage settings for. Immutable after creation.
- allow_
application_ booluser_ access - Whether service principal (application user) access is allowed.
- bool
- Whether Microsoft trusted Azure service tags are allowed for connectivity.
- audit_
retention_ numberperiod_ in_ days - Audit log retention period in days. Use -1 for forever, or a value between 31 and 24855.
- is_
activity_ stringlogging_ enabled - Whether activity logging is enabled (true or false).
- is_
audit_ stringenabled - Whether auditing is enabled (true or false).
- is_
read_ boolaudit_ enabled - Whether read auditing is enabled (GDPR). Managed via Dataverse organizations table.
- is_
user_ stringaccess_ audit_ enabled - Whether user access auditing is enabled (true or false).
- max_
upload_ stringfile_ size - Maximum file upload size in bytes.
- plugin_
trace_ stringlog_ setting - Plugin trace log setting (Off, Exception, All).
- power_
apps_ boolcomponent_ framework_ for_ canvas_ apps - Whether Power Apps Component Framework (PCF) controls are enabled for canvas apps.
- reverse_
proxy_ stringip_ addresses - Comma-separated list of allowed reverse proxy IP addresses or CIDR ranges.
- show_
dashboard_ boolcards_ in_ expanded_ state - Whether dashboard cards are shown in expanded state by default.
- environment
Id String - The ID of the environment to manage settings for. Immutable after creation.
- allow
Application BooleanUser Access - Whether service principal (application user) access is allowed.
- Boolean
- Whether Microsoft trusted Azure service tags are allowed for connectivity.
- audit
Retention IntegerPeriod In Days - Audit log retention period in days. Use -1 for forever, or a value between 31 and 24855.
- is
Activity StringLogging Enabled - Whether activity logging is enabled (true or false).
- is
Audit StringEnabled - Whether auditing is enabled (true or false).
- is
Read BooleanAudit Enabled - Whether read auditing is enabled (GDPR). Managed via Dataverse organizations table.
- is
User StringAccess Audit Enabled - Whether user access auditing is enabled (true or false).
- max
Upload StringFile Size - Maximum file upload size in bytes.
- plugin
Trace StringLog Setting - Plugin trace log setting (Off, Exception, All).
- power
Apps BooleanComponent Framework For Canvas Apps - Whether Power Apps Component Framework (PCF) controls are enabled for canvas apps.
- reverse
Proxy StringIp Addresses - Comma-separated list of allowed reverse proxy IP addresses or CIDR ranges.
- show
Dashboard BooleanCards In Expanded State - Whether dashboard cards are shown in expanded state by default.
- environment
Id string - The ID of the environment to manage settings for. Immutable after creation.
- allow
Application booleanUser Access - Whether service principal (application user) access is allowed.
- boolean
- Whether Microsoft trusted Azure service tags are allowed for connectivity.
- audit
Retention numberPeriod In Days - Audit log retention period in days. Use -1 for forever, or a value between 31 and 24855.
- is
Activity stringLogging Enabled - Whether activity logging is enabled (true or false).
- is
Audit stringEnabled - Whether auditing is enabled (true or false).
- is
Read booleanAudit Enabled - Whether read auditing is enabled (GDPR). Managed via Dataverse organizations table.
- is
User stringAccess Audit Enabled - Whether user access auditing is enabled (true or false).
- max
Upload stringFile Size - Maximum file upload size in bytes.
- plugin
Trace stringLog Setting - Plugin trace log setting (Off, Exception, All).
- power
Apps booleanComponent Framework For Canvas Apps - Whether Power Apps Component Framework (PCF) controls are enabled for canvas apps.
- reverse
Proxy stringIp Addresses - Comma-separated list of allowed reverse proxy IP addresses or CIDR ranges.
- show
Dashboard booleanCards In Expanded State - Whether dashboard cards are shown in expanded state by default.
- environment_
id str - The ID of the environment to manage settings for. Immutable after creation.
- allow_
application_ booluser_ access - Whether service principal (application user) access is allowed.
- bool
- Whether Microsoft trusted Azure service tags are allowed for connectivity.
- audit_
retention_ intperiod_ in_ days - Audit log retention period in days. Use -1 for forever, or a value between 31 and 24855.
- is_
activity_ strlogging_ enabled - Whether activity logging is enabled (true or false).
- is_
audit_ strenabled - Whether auditing is enabled (true or false).
- is_
read_ boolaudit_ enabled - Whether read auditing is enabled (GDPR). Managed via Dataverse organizations table.
- is_
user_ straccess_ audit_ enabled - Whether user access auditing is enabled (true or false).
- max_
upload_ strfile_ size - Maximum file upload size in bytes.
- plugin_
trace_ strlog_ setting - Plugin trace log setting (Off, Exception, All).
- power_
apps_ boolcomponent_ framework_ for_ canvas_ apps - Whether Power Apps Component Framework (PCF) controls are enabled for canvas apps.
- reverse_
proxy_ strip_ addresses - Comma-separated list of allowed reverse proxy IP addresses or CIDR ranges.
- show_
dashboard_ boolcards_ in_ expanded_ state - Whether dashboard cards are shown in expanded state by default.
- environment
Id String - The ID of the environment to manage settings for. Immutable after creation.
- allow
Application BooleanUser Access - Whether service principal (application user) access is allowed.
- Boolean
- Whether Microsoft trusted Azure service tags are allowed for connectivity.
- audit
Retention NumberPeriod In Days - Audit log retention period in days. Use -1 for forever, or a value between 31 and 24855.
- is
Activity StringLogging Enabled - Whether activity logging is enabled (true or false).
- is
Audit StringEnabled - Whether auditing is enabled (true or false).
- is
Read BooleanAudit Enabled - Whether read auditing is enabled (GDPR). Managed via Dataverse organizations table.
- is
User StringAccess Audit Enabled - Whether user access auditing is enabled (true or false).
- max
Upload StringFile Size - Maximum file upload size in bytes.
- plugin
Trace StringLog Setting - Plugin trace log setting (Off, Exception, All).
- power
Apps BooleanComponent Framework For Canvas Apps - Whether Power Apps Component Framework (PCF) controls are enabled for canvas apps.
- reverse
Proxy StringIp Addresses - Comma-separated list of allowed reverse proxy IP addresses or CIDR ranges.
- show
Dashboard BooleanCards In Expanded State - Whether dashboard cards are shown in expanded state by default.
Outputs
All input properties are implicitly available as output properties. Additionally, the EnvironmentSettings resource produces the following output properties:
- Id string
- The provider-assigned unique ID for this managed resource.
- Id string
- The provider-assigned unique ID for this managed resource.
- id string
- The provider-assigned unique ID for this managed resource.
- id String
- The provider-assigned unique ID for this managed resource.
- id string
- The provider-assigned unique ID for this managed resource.
- id str
- The provider-assigned unique ID for this managed resource.
- id String
- The provider-assigned unique ID for this managed resource.
Package Details
- Repository
- powerplatform rpothin/pulumi-powerplatform
- License
- MIT
published on Monday, May 18, 2026 by rpothin