Poweralienware User Support

-->

Search the Support section for your PC’s make and model for any new power management drivers. Do not remove any ACPI entries, because doing so may disable some of your laptop’s power management features, such as the ability to sleep the laptop by pressing the Power button.

Note

Effective November 2020:

Poweralienware
  • Overclocking guaranteed: The Alienware Aurora was designed to fully support custom upgrades. The processor lays on a motherboard using the Intel Z490 Chipset with a bus speed of 8 GT/s and support for overclocking, Intel ® Rapid Storage Technology and Intel ® Platform Trust Technology.
  • Your personal data will be used to support your experience throughout this website, to manage access to your account, and for other purposes described in our privacy policy. I want to receive updates about products and promotions.
  • Common Data Service has been renamed to Microsoft Dataverse. Learn more
  • Some terminology in Microsoft Dataverse has been updated. For example, entity is now table and field is now column. Learn more

This article will be updated soon to reflect the latest terminology.

With PowerShell cmdlets for app creators and administrators, you can automate many of the monitoring and management tasks that are only possible manually today in Power Apps.

Cmdlets

Cmdlets are functions written in PowerShell script language that execute commands in the Windows PowerShell environment. Running these Power Apps cmdlets will allow you to interact with your Business Application Platform without having to go through the admin portal in a web browser. You can combine these cmdlets with other PowerShell functions to write complex scripts that can optimize your workflow. Note that you can still use the cmdlets if you're not an admin on the tenant, but you will be limited to the resources you own. Cmdlets that start with the word 'Admin' are designed to be used by an administrative user account.

Cmdlets are available on the PowerShell gallery as two separate modules:

For information on the Power Apps admin module, see Get started using the Power Apps admin module and Microsoft.PowerApps.Administration.PowerShell.

Note

Regarding Dynamics 365 Government Community Cloud (GCC) level 2 support:

Software

The default endpoint is 'prod'. If a user wants to run a PowerShell script targeting a GCC environment, the -Endpoint parameter needs to be changed to 'usgov' for GCC Moderate, or 'usgovhigh' for GCC High, or 'dod' for GCC DOD.

Requirements

PowerShell in this topic requires PowerShell version 5.x. To check the version of PowerShell running on your machine, run the following command:

If you have an outdated version, see Upgrading existing Windows PowerShell.

Important

The modules described in this document, use .NET Framework. This makes it incompatible with PowerShell 6.0 and later, which uses .NET Core.

Installation

To run the PowerShell cmdlets for app creators, do the following:

  1. Run PowerShell as an administrator.

  2. Import the necessary modules using the following commands:

    Alternatively, if you don't have admin rights on your computer, you can use the following to use these modules:

  3. If you are prompted to accept the change to InstallationPolicy value of the repository, accept [A] Yes to all modules by typing 'A' and pressing Enter for each module.

  4. Before accessing any of the commands, you have the option to provide your credentials using the following command. These credentials are refreshed for up to ~8 hours before you're required to sign in again to continue using the cmdlets.

Power Apps cmdlets for app creators

Prerequisite

Users with a valid Power Apps license can perform the operations in these cmdlets, but they will only have access to the resources (for example, apps, flows, etc.) that have been created or shared with them.

Cmdlet list - Maker Cmdlets

Note

We have updated some of the cmdlets function names in the latest release in order to add appropriate prefixes to prevent collisions. See the table below for an overview of what has changed.

PurposeCmdlet
Add a canvas app to a Microsoft Dataverse solutionSetPowerAppAsSolutionAware
Read environmentsGet-PowerAppEnvironment (previously Get-PowerAppsEnvironment)
Get-FlowEnvironment
Read, update, and delete a canvas appGet-PowerApp (previously Get-App)
Remove-PowerApp (previously Remove-App)
Publish-PowerApp (previously Publish-App)
Set-AppDisplayName (previously Set-PowerAppDisplayName)
Get-PowerAppVersion (previously Get-AppVersion)
Restore-PowerAppVersion (previously Restore-AppVersion)
Read, update, and delete canvas app permissionsGet-PowerAppRoleAssignment (previously Get-AppRoleAssignment)
Set-PowerAppRoleAssignment (previously Set-AppRoleAssignment)
Remove-PowerAppRoleAssignment (previously Remove-AppRoleAssignment)
Read, update, and delete a flowGet-Flow
Get-FlowRun
Enable-Flow
Disable-Flow
Remove-Flow
Read, update, and delete flow permissionsGet-FlowOwnerRole
Set-FlowOwnerRole
Remove-FlowOwnerRole
Read and respond to flow approvalsGet-FlowApprovalRequest
Get-FlowApproval
RespondTo-FlowApprovalRequest
Read and delete connectionsGet-PowerAppConnection (previously Get-Connection)
Remove-PowerAppConnection (previously Remove-Connection)
Read, update, and delete connection permissionsGet-PowerAppConnectionRoleAssignment (previously Get-ConnectionRoleAssignment)
Set-PowerAppConnectionRoleAssignment (previously Set-ConnectionRoleAssignment)
Remove-PowerAppConnectionRoleAssignment (previously Remove-ConnectionRoleAssignment)
Read, and delete connectorsGet-PowerAppConnector (previously Get-Connector)
Remove-PowerAppConnector (previously Remove-Connector)
Add, read, update, and delete custom connector permissionsGet-PowerAppConnectorRoleAssignment (previously Get-ConnectorRoleAssignment)
Set-PowerAppConnectorRoleAssignment (previously Set-ConnectorRoleAssignment)
Remove-PowerAppConnectorRoleAssignment (previously Remove-ConnectorRoleAssignment)
Read, add, and remove policy URL patternsGet-PowerAppPolicyUrlPatterns
New-PowerAppPolicyUrlPatterns
Remove-PowerAppPolicyUrlPatterns
Read, register, and remove management appsGet-PowerAppManagementApp
Get-PowerAppManagementApps
New-PowerAppManagementApp
Remove-PowerAppManagementApp
Read, create, update, and import protection keysGet-PowerAppRetrieveAvailableTenantProtectionKeys
Get-PowerAppGenerateProtectionKey
Get-PowerAppRetrieveTenantProtectionKey
New-PowerAppImportProtectionKey
Set-PowerAppTenantProtectionKey

Power Apps cmdlets for administrators

Prerequisite

To perform the administration operations in the admin cmdlets, you'll need the following:

  • A user with any of these roles, Global admins, Azure Active Directory Global admins, or Dynamics 365 admin, can access the Power Apps admin PowerShell cmdlets. These roles no longer require a Power Apps plan for administrative access to the Power Apps admin PowerShell cmdlets. However, these administrators need to sign in to the Power Platform admin center at least once before using the PowerShell cmdlets. If this is not done, the cmdlets will fail with an authorization error.

  • Microsoft 365 Global admin or an Azure Active Directory Global Administrator, or Dynamics 365 admin permissions if you need to search through another user's resources. Note that Environment Admins only have access to those environments and environment resources for which they have permissions.

Cmdlet list - Admin Cmdlets

PurposeCmdlets
Read, update, delete, lock, unlock, and recover environments and Dataverse databasesNew-AdminPowerAppEnvironment
Set-AdminPowerAppEnvironmentDisplayName
Get-AdminPowerAppEnvironment (previously Get-AdminEnvironment)
Remove-AdminPowerAppEnvironment (previously Remove-AdminEnvironment)
Get-AdminPowerAppSoftDeletedEnvironment
Recover-AdminPowerAppEnvironment
Copy-PowerAppEnvironment
Backup-PowerAppEnvironment
Get-PowerAppEnvironmentBackups
Restore-PowerAppEnvironment
Remove-PowerAppEnvironmentBackup
Reset-PowerAppEnvironment
New-AdminPowerAppCdsDatabase
Get-AdminPowerAppCdsDatabaseLanguages
Get-AdminPowerAppCdsDatabaseCurrencies
Get-AdminPowerAppEnvironmentLocations
Set-PowerAppLockAllEnvironments
Set-PowerAppUnlockEnvironment
Set-PowerAppProtectionStatus
Delete Dataverse databaseRemove-LegacyCDSDatabase
Read, update, and delete environment permissions
These cmdlets only work today for environments that do not have a Dataverse database.
Get-AdminPowerAppEnvironmentRoleAssignment (previously Get-AdminEnvironmentRoleAssignment)
Set-AdminPowerAppEnvironmentRoleAssignment (previously Set-AdminEnvironmentRoleAssignment)
Remove-AdminPowerAppEnvironmentRoleAssignment (previously Remove-AdminEnvironmentRoleAssignment)
Set-AdminPowerAppEnvironmentRuntimeStat
Read, update, remove, and recover canvas appsGet-AdminPowerApp (previously Get-AdminApp)
Remove-AdminPowerApp (previously Remove-AdminApp)
Get-AdminPowerAppConnectionReferences
Set-AdminPowerAppAsFeatured
Clear-AdminPowerAppAsFeatured
Set-AdminPowerAppAsHero
Clear-AdminPowerAppAsHero
Set-AdminPowerAppApisToBypassConsent
Clear-AdminPowerAppApisToBypassConsent
Get-AdminDeletedPowerAppsList
Get-AdminRecoverDeletedPowerApp
Read, update, and delete canvas app permissionsGet-AdminPowerAppRoleAssignment (previously Get-AdminAppRoleAssignment)
Remove-AdminPowerAppRoleAssignment (previously Remove-AdminAppRoleAssignment)
Set-AdminPowerAppRoleAssignment (previously Set-AdminAppRoleAssignment)
Set-AdminPowerAppOwner (previously Set-AdminAppOwner)
Read, update, and delete flowsGet-AdminFlow
Enable-AdminFlow
Disable-AdminFlow
Remove-AdminFlow
Remove-AdminFlowApprovals
Read, update, and delete flow permissionsGet-AdminFlowOwnerRole
Set-AdminFlowOwnerRole
Remove-AdminFlowOwnerRole
Read and delete connectionsGet-AdminPowerAppConnection (previously Get-AdminConnection)
Remove-AdminPowerAppConnection (previously Remove-AdminConnection)
Read, update, and delete connection permissionsGet-AdminPowerAppConnectionRoleAssignment (previously Get-AdminConnectionRoleAssignment)
Set-AdminPowerAppEnvironmentConnectionRoleAssignment (previously Set-AdminConnectionRoleAssignment)
Remove-AdminPowerAppConnectionRoleAssignment (previously Remove-AdminConnectionRoleAssignment)
Read and delete custom connectorsGet-AdminPowerAppConnector (previously Get-AdminConnector)
Remove-AdminPowerAppConnector (previously Remove-AdminConnector)
Read, update, and delete custom connector permissionsGet-AdminPowerAppConnectorRoleAssignment (previously Get-AdminConnectorRoleAssignment)
Set-AdminPowerAppConnectorRoleAssignment (previously Set-AdminConnectorRoleAssignment)
Remove-AdminPowerAppConnectorRoleAssignment (previously Remove-AdminConnectorRoleAssignment)
Read a user's Power Apps user settings, user-app settings, and notificationsGet-AdminPowerAppsUserDetails
Read and delete a user's Power Automate settings, which are not visible to user, but that support flow executionGet-AdminFlowUserDetails
Remove-AdminFlowUserDetails
Create, read, update and delete data loss prevention policies for your organization using a three-way classification - Business, Non-Business, and BlockedGet-DlpPolicy (previously Get-AdminDlpPolicy)
New-DlpPolicy (previously Add-AdminDlpPolicy)
Remove-DlpPolicy (previously Remove-AdminDlpPolicy)
Set-DlpPolicy (previously Set-AdminDlpPolicy)
Learn more about the Power Platform data loss prevention (DLP) SDK.
Read, add, remove, and update tenant settingsGet-TenantSettings
Set-TenantSettings
Get-PowerAppTenantUrlPatterns
New-PowerAppTenantUrlPatterns
Remove-PowerAppTenantUrlPatterns
Get-AdminPowerAppTenantConsumedQuota
Read, add, and remove allowed consent/trial plans within the tenantRemove-AllowedConsentPlans
Add-AllowedConsentPlans
Get-AllowedConsentPlans
Read tenant assigned user licensesGet-AdminPowerAppLicenses
Read, update, and reset the environment that Power Apps uses to save SharePoint form appsGet-AdminPowerAppSharepointFormEnvironment
Set-AdminPowerAppSharepointFormEnvironment
Reset-AdminPowerAppSharepointFormEnvironment
Read operation statusGet-AdminPowerAppOperationStatus
Read and update tenant isolation status and policyGet-PowerAppTenantIsolationOperationStatus
Get-PowerAppTenantIsolationPolicy
Set-PowerAppTenantIsolationPolicy

Tips

  • Use Get-Help 'CmdletName' to get a list of examples.

  • To cycle through the possible options for input tags, click on the tab key after typing out the dash (-) character, after the cmdlet name.

    Skyrim

Example commands:

Operation examples

Below are some common scenarios that show how to use new and existing Power Apps cmdlets.

Environments commands

Use these commands to get details on and update environments in your tenant.

Display a list of all environments

Returns a list of each environment across your tenant, with details of each (e.g., environment name (guid), display name, location, creator, etc).

Display details of your default environment

Returns the details for only the default environment of the tenant.

Display details of a specific environment

Note: The EnvironmentName field is a unique identifier, which is different from the DisplayName (see first and second fields in the output in the following image).

Power Apps commands

These operations are used to read and modify Power Apps data in your tenant.

Display a list of all Power Apps

Returns a list of all Power Apps across the tenant, with details of each (e.g., application name (guid), display name, creator, etc).

Display a list of all Power Apps that match the input display name

Returns a list of all the Power Apps in your tenant that match the display name.

Note: Use quotation characters (') around input values that contain spaces.

Feature an application

Featured applications are grouped and pushed to the top of the list in the Power Apps mobile player.

Note: Like environments, the AppName field is a unique identifier, which is different from the DisplayName. If you want to perform operations based on the display name, some functions will let you use the pipeline (see next function).

Make an application a Hero app, using the pipeline

A Hero app will appear at the top of the list in the Power Apps mobile player. There can only be one Hero app.

The pipeline (represented as the ' ' character between two cmdlets) takes the output of the first cmdlet and passes it as the input value of the second, assuming the function has been written to accommodate the pipeline feature.

Note: an app must already be a featured app before it is changed to a hero.

Display the number of apps each user owns

You can combine native PowerShell functions with the Power Apps cmdlets to manipulate data even further. Here we use the Select function to isolate the Owner attribute (an object) from the Get-AdminApp object. We then isolate the name of the owner object by pipelining that output into another Select function. Finally, passing the second Select function output into the Group function returns a nice table that includes a count of each owner's number of apps.

Display the number of apps in each environment

Download Power Apps user details

The above command will store the Power Apps user details (basic usage information about the input user via their user principal name) in the specified text file. It will create a new file if there is no existing file with that name, and overwrite the text file if it already exists.

Export a list of assigned user licenses

Exports all the assigned user licenses (Power Apps and Power Automate) in your tenant into a tabular view .csv file. The exported file contains both self-service sign up internal trial plans as well as plans that are sourced from Azure Active Directory. The internal trial plans are not visible to admins in the Microsoft 365 admin center.

The export can take a while for tenants with a large number of Power Platform users.

Set logged in user as the owner of a canvas app

Changes the owner role of a PowerApp to the current user, and replaces the original owner as a 'can view' role type.

Note: The AppName and EnvironmentName fields are the unique identifiers (guids), not the display names.

Display a list of deleted canvas apps in an environment

This displays all canvas apps that were recently deleted and may still be recovered.

Alienware Support Forum

Recover a deleted canvas app

This recovers a canvas app that is discoverable via Get-AdminDeletedPowerAppsList cmdlet. Any canvas app that isn't displayed in Get-AdminDeletedPowerAppsList isn't recoverable.

Power Automate commands

Use these commands to view and modify data related to Power Automate.

Alienware Support Assist

Display all flows

Returns a list of all flows in the tenant.

Display flow owner role details

Returns the owner details of the specified flow.

Note: Like Environments and PowerApps, FlowName is the unique identifier (guid), which is different from the display name of the flow.

Display flow user details

Returns the user details regarding flow usage. In this example we're using the user Id of the current logged in user of the PowerShell session as input.

Remove flow user details

Deletes the details on a flow user completely from the Microsoft database. All flows the input user owns must be deleted before the flow user details can be purged.

Note: The UserId field is the Object ID of the user's Azure Active Directory record, which can be found in the Azure Portal under Azure Active Directory > Users > Profile > Object ID. You must be an admin to access this data from here.

Export all flows to a CSV file

Exports all the flows in your tenant into a tabular view .csv file.

API connection commands

View and manage API connections in your tenant.

Display all native Connections in your default environment

Displays a list of all API connections you have in the default environment. Native connections are found under the Data > Connections tab in the maker portal.

Display all custom connectors in the tenant

Returns a list of all custom connector details in the tenant.

Data loss prevention (DLP) policy commands

Note

The ability to block connectors by using a three-way classification—Business, Non-Business, and Blocked—in addition to DLP policy UI support in the Power Platform admin center are currently in public preview. There is new DLP policy PowerShell support for three-way DLP policy classification, which is also in public preview. Legacy DLP policy support for two-way classification (Business and Non-Business), along with admin center UI and PowerShell support for two-way classification, are currently generally available and will continue to be available for the foreseeable future. More information: Connectors documentation

These cmdlets control the DLP policies on your tenant.

Create a DLP policy

Creates a new DLP policy for the signed-in admin's tenant.

Retrieve a list of of DLP objects

Gets policy objects for the signed-in admin's tenant.

Update a DLP policy

Updates details of the policy, such as the policy display name.

Remove a policy

Deletes a DLP policy.

Block trial licenses commands

Commands:

The allowed consent plans cmdlets can be used to add or remove access to a particular type of consent plan from a tenant. 'Internal' consent plans are either trial licenses or community plans that users can sign themselves up for via Power Apps/Power Automate portals. 'Ad-hoc subscription' consent plans are trial licenses that users can sign themselves up for via https://signup.microsoft.com or admins can assign to users via Azure Active Directory (Azure AD) or the Microsoft 365 admin portal. By default all types of consent plans are allowed in a tenant. A common use case for these cmdlets is if a Power Platform admin wants to block users within their tenant from the ability to assign themselves trial licenses but retain the ability to assign trial licenses on behalf of users. This can be accomplished by using the Remove-AllowedConsentPlans -Types 'Internal' command as well as disabling the setting AllowAdHocSubscriptions in Azure AD. It is important to note that when using Remove-AllowedConsentPlans all existing plans of the specified type will be removed from all users in the tenant and will not be recoverable. In addition, it will block all further assignment of plans of that type. If, at a later time, the Power Platform admin wishes to re-enable plans of that type they can use Add-AllowedConsentPlans. If they want to view the current state of allowed consent plans they can use Get-AllowedConsentPlans.

Questions?

If you have any comments, suggestions, or questions, post them on the Administering Power Apps community board.

See also

Get started using the Power Apps admin module
Microsoft.PowerApps.Administration.PowerShell