Export-PnPPowerApp
SYNOPSIS
Required Permissions
- Azure: management.azure.com
- PowerApps: service.powerapps.com
Exports a Microsoft Power App
SYNTAX
Export-PnPPowerApp [-Environment <PowerPlatformEnvironmentPipeBind>] -Identity <PowerAppPipeBind>
[-PackageDisplayName <String>] [-PackageDescription <String>] [-PackageCreatedBy <String>]
[-PackageSourceEnvironment <String>] [-OutPath <String>] [-Force] [-Connection <PnPConnection>]
[<CommonParameters>]
DESCRIPTION
This cmdlet exports a Microsoft Power App as zip package.
Export failures are written to the PowerShell error stream. By default, these errors are non-terminating so batch exports can continue. Use -ErrorVariable to capture them, or -ErrorAction Stop to handle a failed export with try/catch.
Exporting a Power App is an asynchronous operation. The cmdlet waits for the service to finish preparing the package for up to 30 minutes, following the polling interval requested by the service where it provides one.
EXAMPLES
Example 1
Export-PnPPowerApp -Identity fba63225-baf9-4d76-86a1-1b42c917a182 -OutPath "C:\Users\user1\Downloads\test_20230408152624.zip"
This will export the specified Microsoft Power App from the default Power Platform environment as an output to the path specified in the command as -OutPath
Example 2
Export-PnPPowerApp -Environment (Get-PnPPowerPlatformEnvironment -Identity "myenvironment") -Identity fba63225-baf9-4d76-86a1-1b42c917a182 -OutPath "C:\Users\user1\Downloads\test_20230408152624.zip" -PackageDisplayName "MyAppDisplayName" -PackageDescription "Package exported using PnP Powershell" -PackageCreatedBy "Siddharth Vaghasia" -PackageSourceEnvironment "UAT Environment"
This will export the specified Microsoft Power App from the specified Power Platform environment with metadata specified
Example 3
Get-PnPPowerPlatformEnvironment | foreach { Get-PnPPowerApp -Environment $_.Name } | foreach { Export-PnPPowerApp -Environment $_.Properties.EnvironmentDetails.Name -Identity $_ -OutPath "C:\Users\user1\Downloads\$($_.Name).zip" }
This will export all the Microsoft Power Apps available within the tenant from all users from all the available Power Platform environments as a ZIP package for each of them to a local folder C:\Users\user1\Downloads
PARAMETERS
-Connection
Optional connection to be used by the cmdlet. Retrieve the value for this parameter by either specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.
Type: PnPConnection
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Environment
The name of the Power Platform environment or an Environment instance. If omitted, the default environment will be used.
Type: PowerPlatformEnvironmentPipeBind
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: The default environment
Accept pipeline input: True
Accept wildcard characters: False
-Force
If specified and the file exported already exists it will be overwritten without confirmation.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Identity
The value of the Name property of a Microsoft Power App that you wish to export
Type: PowerAppPipeBind
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-OutPath
Optional file name of the file to export to. If not provided, it will store the ZIP package to the current location from where the cmdlet is being run, using the filename returned by the service. Either way, when a file with that name already exists you are asked to confirm the overwrite unless -Force is specified.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PackageCreatedBy
The name of the person to be used as the creator of the exported package
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PackageDescription
The description to use in the exported package
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PackageDisplayName
The display name to use in the exported package
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PackageSourceEnvironment
The name of the source environment from which the exported package was taken
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False