New Microsoft Power Platform Build Tools tasks

Just a little reminder to everyone that the documentation does not always keep up with the current situation and the possibilities of the tools that are available to us.

The official documentation page for Power Platform Build Tools still references the old Tasks version under Microsoft Power Platform Build Tools tasks. So if you do any analysis or research based only on the documentation, it is worth paying attention to the steps and their options that are in the toolkit.

Useful extras:

Only perform the action on a single component type.

      "name": "SingleComponent"
	      "label": "Single Component",
	      "type": "pickList",
	      "required": false,
	      "helpMarkDown": "Only perform action on a single component type.",
	      "defaultValue": "None",
	      "options": {
	        "WebResource": "WebResource",
	        "Plugin": "Plugin",
	        "Workflow": "Workflow",
	        "None": "None"
	      }
        

Deployment Profile for Environment variable and Connection References. Option to auto Publish Customization after import in the same task(Publish all customization changes after import succeeds). Activate Plugins parameter to replace PublishWorkflows

steps
- task: microsoft-IsvExpTools.PowerPlatform-BuildTools.import-solution.PowerPlatformImportSolution@2
? displayName: 'Power Platform Import Solution '
? inputs:
? ? authenticationType: PowerPlatformSPN
? ? PowerPlatformSPN: ${{parameters.SPN}} 
? ? Environment: ${{parameters.Environment}}
? ? SolutionInputFile: ${{parameters.SolutionInputFile}}
? ? UseDeploymentSettingsFile: ${{parameters.UseDeploymentSettingsFile}}
? ? DeploymentSettingsFile: ${{parameters.DeploymentSettingsFile}}
    ActivatePlugins: ${{parameters.ActivatePlugins}}
    PublishCustomizationChanges: ${{parameters.PublishCustomizationChanges}}        

New Tasks:

Sets BuildTools.* variables to provide custom script tasks access to use the Service Connection as a single source of truth. The main goal is to be able to reuse the existing SPN in other types of tasks, eg PowerShell Admin modules or direct CLI calls.

steps
- task: PowerPlatformSetConnectionVariables@2
? displayName: 'Power Platform Set Connection Variables '
? name: connection
? inputs:
? ? authenticationType: PowerPlatformSPN
? ? PowerPlatformSPN: ${{parameters.SPN}}
? ? Environment: ${{parameters.Environment}}
        

Power Platform assign user to target environment with specified security role

steps
- task: PowerPlatformAssignUser@2
? displayName: 'Power Platform Assign User '
? inputs:
? ? authenticationType: PowerPlatformSPN
? ? PowerPlatformSPN: ${{parameters.SPN}} 
? ? Environment: ${{parameters.Environment}}
? ? User: ${{parameters.User}}
? ? Role: ${{parameters.Role}}:        

Adds a solution component to the target unmanaged solution in the connected Dataverse environment

steps
- task: PowerPlatformAddSolutionComponent@2
? displayName: 'Power Platform Add Solution Component '
? inputs:
? ? authenticationType: PowerPlatformSPN
? ? PowerPlatformSPN: ${{parameters.SPN}} 
? ? Environment: ${{parameters.Environment}}
? ? SolutionName: ?${{parameters.SolutionName}}
? ? Component: ?${{parameters.Component}}
? ? ComponentType: ?${{parameters.ComponentType}}
? ? AddRequiredComponents: ?${{parameters.AddRequiredComponents}}:        

Power Platform Upload PowerPages web site (PAPortal). The wrapper on pac paportal download Microsoft Power Platform CLI paportal command group - Power Platform | Microsoft Learn

steps
- task: PowerPlatformUploadPaportal@2
? displayName: 'Power Platform Upload PAPortal '
? inputs:
? ? authenticationType: PowerPlatformSPN
? ? PowerPlatformSPN: ${{parameters.SPN}}
? ? UploadPath: ${{parameters.Path}}
? ? Environment: ${{parameters.Environment}}
    DeploymentProfile: ${{parameters.DeploymentProfile}}

          

Power Platform Download PowerPages web site (PAPortal). The wrapper on pac paportal upload Microsoft Power Platform CLI paportal command group - Power Platform | Microsoft Learn

steps
- task: PowerPlatformDownloadPaportal@2
? displayName: 'Power Platform Download PAPortal '
? inputs:
? ? authenticationType: PowerPlatformSPN
? ? PowerPlatformSPN: ${{parameters.SPN}}
? ? Environment: ${{parameters.Environment}}
? ? DownloadPath: ${{parameters.Path}}
? ? WebsiteId: ${{parameters.WebsiteId}}
? ? Overwrite: ${{parameters.Overwrite}}
? ? ExcludeEntities: ${{parameters.ExcludeEntities}}