@pnp/cli-microsoft365 6.5.0-beta.f8b8018 → 6.6.0-beta.2339ae2

package/dist/m365/spfx/commands/spfx-doctor.js

@@ -467,6 +467,36 @@ class SpfxDoctorCommand extends base_project_command_1.BaseProjectCommand {
                     range: '^4',
                     fix: 'npm i -g yo@4'
                 }
+            },
+            '1.17.0': {
+                gulpCli: {
+                    range: '^1 || ^2',
+                    fix: 'npm i -g gulp-cli@2'
+                },
+                node: {
+                    range: '>=16.13.0 <17.0.0',
+                    fix: 'Install Node.js >=16.13.0 <17.0.0'
+                },
+                sp: SharePointVersion.SPO,
+                yo: {
+                    range: '^4',
+                    fix: 'npm i -g yo@4'
+                }
+            },
+            '1.17.1': {
+                gulpCli: {
+                    range: '^1 || ^2',
+                    fix: 'npm i -g gulp-cli@2'
+                },
+                node: {
+                    range: '>=16.13.0 <17.0.0',
+                    fix: 'Install Node.js >=16.13.0 <17.0.0'
+                },
+                sp: SharePointVersion.SPO,
+                yo: {
+                    range: '^4',
+                    fix: 'npm i -g yo@4'
+                }
             }
         };
         __classPrivateFieldGet(this, _SpfxDoctorCommand_instances, "m", _SpfxDoctorCommand_initTelemetry).call(this);

package/dist/m365/spo/commands/file/file-move.js

@@ -147,7 +147,7 @@ class SpoFileMoveCommand extends SpoCommand_1.default {
                 yield Cli_1.Cli.executeCommand(removeCommand, { options: Object.assign(Object.assign({}, removeOptions), { _: [] }) });
             }
             catch (err) {
-                if (err.error !== undefined && err.error.message !== undefined && err.error.message.includes('does not exist')) {
+                if (err !== undefined && err.message !== undefined && err.message.includes('does not exist')) {
                 }
                 else {
                     throw err;

package/dist/m365/spo/commands/file/file-retentionlabel-ensure.js

@@ -42,6 +42,9 @@ class SpoFileRetentionLabelEnsureCommand extends SpoCommand_1.default {
         return __awaiter(this, void 0, void 0, function* () {
             try {
                 const fileProperties = yield this.getFileProperties(logger, args);
+                if (args.options.assetId) {
+                    yield this.applyAssetId(args.options.webUrl, fileProperties.ListItemAllFields.ParentList.Id, fileProperties.ListItemAllFields.Id, args.options.assetId);
+                }
                 const options = {
                     webUrl: args.options.webUrl,
                     listId: fileProperties.ListItemAllFields.ParentList.Id,
@@ -84,12 +87,28 @@ class SpoFileRetentionLabelEnsureCommand extends SpoCommand_1.default {
             return yield request_1.default.get(requestOptions);
         });
     }
+    applyAssetId(webUrl, listId, listItemId, assetId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestUrl = `${webUrl}/_api/web/lists(guid'${formatting_1.formatting.encodeQueryParameter(listId)}')`;
+            const requestBody = { "formValues": [{ "FieldName": "ComplianceAssetId", "FieldValue": assetId }] };
+            const requestOptions = {
+                url: `${requestUrl}/items(${listItemId})/ValidateUpdateListItem()`,
+                headers: {
+                    'accept': 'application/json;odata=nometadata'
+                },
+                data: requestBody,
+                responseType: 'json'
+            };
+            yield request_1.default.post(requestOptions);
+        });
+    }
 }
 _SpoFileRetentionLabelEnsureCommand_instances = new WeakSet(), _SpoFileRetentionLabelEnsureCommand_initTelemetry = function _SpoFileRetentionLabelEnsureCommand_initTelemetry() {
     this.telemetry.push((args) => {
         Object.assign(this.telemetryProperties, {
             fileUrl: typeof args.options.fileUrl !== 'undefined',
-            fileId: typeof args.options.fileId !== 'undefined'
+            fileId: typeof args.options.fileId !== 'undefined',
+            assetId: typeof args.options.assetId !== 'undefined'
         });
     });
 }, _SpoFileRetentionLabelEnsureCommand_initOptions = function _SpoFileRetentionLabelEnsureCommand_initOptions() {
@@ -101,6 +120,8 @@ _SpoFileRetentionLabelEnsureCommand_instances = new WeakSet(), _SpoFileRetention
         option: '--fileUrl [fileUrl]'
     }, {
         option: '-i, --fileId [fileId]'
+    }, {
+        option: '-a, --assetId [assetId]'
     });
 }, _SpoFileRetentionLabelEnsureCommand_initValidators = function _SpoFileRetentionLabelEnsureCommand_initValidators() {
     this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {

package/dist/m365/spo/commands/listitem/ListItemFieldValueResult.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ListItemFieldValueResult.js.map

package/dist/m365/spo/commands/listitem/listitem-add.js

@@ -15,6 +15,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 };
 var _SpoListItemAddCommand_instances, _SpoListItemAddCommand_initTelemetry, _SpoListItemAddCommand_initOptions, _SpoListItemAddCommand_initValidators, _SpoListItemAddCommand_initTypes, _SpoListItemAddCommand_initOptionSets;
 Object.defineProperty(exports, "__esModule", { value: true });
+const os = require("os");
 const request_1 = require("../../../../request");
 const formatting_1 = require("../../../../utils/formatting");
 const spo_1 = require("../../../../utils/spo");
@@ -139,16 +140,16 @@ class SpoListItemAddCommand extends SpoCommand_1.default {
                 const response = yield request_1.default.post(requestOptions);
                 // Response is from /AddValidateUpdateItemUsingPath POST call, perform get on added item to get all field values
                 const fieldValues = response.value;
+                if (fieldValues.some(f => f.HasException)) {
+                    throw `Creating the item failed with the following errors: ${os.EOL}${fieldValues.filter(f => f.HasException).map(f => { return `- ${f.FieldName} - ${f.ErrorMessage}`; }).join(os.EOL)}`;
+                }
                 const idField = fieldValues.filter((thisField) => {
                     return (thisField.FieldName === "Id");
                 });
                 if (this.debug) {
-                    logger.logToStderr(`field values returned:`);
+                    logger.logToStderr(`Field values returned:`);
                     logger.logToStderr(fieldValues);
-                    logger.logToStderr(`Id returned by AddValidateUpdateItemUsingPath: ${idField}`);
-                }
-                if (idField.length === 0) {
-                    throw `Item didn't add successfully`;
+                    logger.logToStderr(`Id returned by AddValidateUpdateItemUsingPath: ${idField[0].FieldValue}`);
                 }
                 requestOptions = {
                     url: `${requestUrl}/items(${idField[0].FieldValue})`,

package/dist/m365/spo/commands/listitem/listitem-batch-add.js

@@ -23,6 +23,7 @@ var __asyncValues = (this && this.__asyncValues) || function (o) {
 var _SpoListItemBatchAddCommand_instances, _SpoListItemBatchAddCommand_initTelemetry, _SpoListItemBatchAddCommand_initOptions, _SpoListItemBatchAddCommand_initValidators, _SpoListItemBatchAddCommand_initTypes, _SpoListItemBatchAddCommand_initOptionSets;
 Object.defineProperty(exports, "__esModule", { value: true });
 const fs = require("fs");
+const os = require("os");
 const request_1 = require("../../../../request");
 const uuid_1 = require("uuid");
 const formatting_1 = require("../../../../utils/formatting");
@@ -116,7 +117,11 @@ class SpoListItemBatchAddCommand extends SpoCommand_1.default {
                 },
                 data: requestBody.join('')
             };
-            yield request_1.default.post(requestOptions);
+            const response = yield request_1.default.post(requestOptions);
+            const parsedResponse = this.parseBatchResponseBody(response);
+            if (parsedResponse.some(r => r.HasException)) {
+                throw `Creating some items failed with the following errors: ${os.EOL}${parsedResponse.filter(f => f.HasException).map(f => { return `- Line ${f.csvLineNumber}: ${f.FieldName} - ${f.ErrorMessage}`; }).join(os.EOL)}`;
+            }
         });
     }
     parseBatchRequestBody(items, batchId, requestUrl) {
@@ -142,6 +147,18 @@ class SpoListItemBatchAddCommand extends SpoCommand_1.default {
         batchBody.push(`--batch_${batchId}--\n`);
         return batchBody;
     }
+    parseBatchResponseBody(response) {
+        const batchResults = [];
+        response.split('\r\n')
+            .filter((line) => line.startsWith('{'))
+            .forEach((line, index) => {
+            const parsedResponse = JSON.parse(line);
+            parsedResponse.value.forEach((fieldValueResult) => {
+                batchResults.push(Object.assign({ csvLineNumber: (index + 2) }, fieldValueResult));
+            });
+        });
+        return batchResults;
+    }
     getSingleItemRequestBody(row) {
         const requestBody = [];
         Object.keys(row).forEach(key => {

package/dist/m365/spo/commands/listitem/listitem-get.js

@@ -58,8 +58,14 @@ class SpoListItemGetCommand extends SpoCommand_1.default {
             const propertiesToExpand = propertiesWithSlash.map(e => e.split('/')[0]);
             const expandPropertiesArray = propertiesToExpand.filter((item, pos) => propertiesToExpand.indexOf(item) === pos);
             const fieldExpand = expandPropertiesArray.length > 0 ? `&$expand=${expandPropertiesArray.join(",")}` : ``;
+            if (args.options.id) {
+                requestUrl += `/items(${args.options.id})`;
+            }
+            else {
+                requestUrl += `/GetItemByUniqueId(guid'${args.options.uniqueId}')`;
+            }
             const requestOptions = {
-                url: `${requestUrl}/items(${args.options.id})?$select=${formatting_1.formatting.encodeQueryParameter(propertiesSelect.join(","))}${fieldExpand}`,
+                url: `${requestUrl}?$select=${formatting_1.formatting.encodeQueryParameter(propertiesSelect.join(","))}${fieldExpand}`,
                 headers: {
                     'accept': 'application/json;odata=nometadata'
                 },
@@ -68,7 +74,7 @@ class SpoListItemGetCommand extends SpoCommand_1.default {
             try {
                 const itemProperties = yield request_1.default.get(requestOptions);
                 if (args.options.withPermissions) {
-                    requestOptions.url = `${requestUrl}/items(${args.options.id})/RoleAssignments?$expand=Member,RoleDefinitionBindings`;
+                    requestOptions.url = `${requestUrl}/RoleAssignments?$expand=Member,RoleDefinitionBindings`;
                     const response = yield request_1.default.get(requestOptions);
                     response.value.forEach((r) => {
                         r.RoleDefinitionBindings = formatting_1.formatting.setFriendlyPermissions(r.RoleDefinitionBindings);
@@ -90,6 +96,8 @@ _SpoListItemGetCommand_instances = new WeakSet(), _SpoListItemGetCommand_initTel
             listId: typeof args.options.listId !== 'undefined',
             listTitle: typeof args.options.listTitle !== 'undefined',
             listUrl: typeof args.options.listUrl !== 'undefined',
+            id: typeof args.options.id !== 'undefined',
+            uniqueId: typeof args.options.uniqueId !== 'undefined',
             withPermissions: !!args.options.withPermissions
         });
     });
@@ -97,7 +105,9 @@ _SpoListItemGetCommand_instances = new WeakSet(), _SpoListItemGetCommand_initTel
     this.options.unshift({
         option: '-u, --webUrl <webUrl>'
     }, {
-        option: '-i, --id <id>'
+        option: '-i, --id [id]'
+    }, {
+        option: '--uniqueId [uniqueId]'
     }, {
         option: '-l, --listId [listId]'
     }, {
@@ -119,15 +129,20 @@ _SpoListItemGetCommand_instances = new WeakSet(), _SpoListItemGetCommand_initTel
             !validation_1.validation.isValidGuid(args.options.listId)) {
             return `${args.options.listId} in option listId is not a valid GUID`;
         }
-        if (isNaN(parseInt(args.options.id))) {
+        if (args.options.id &&
+            isNaN(parseInt(args.options.id))) {
             return `${args.options.id} is not a number`;
         }
+        if (args.options.uniqueId &&
+            !validation_1.validation.isValidGuid(args.options.uniqueId)) {
+            return `${args.options.uniqueId} in option uniqueId is not a valid GUID`;
+        }
         return true;
     }));
 }, _SpoListItemGetCommand_initTypes = function _SpoListItemGetCommand_initTypes() {
-    this.types.string.push('webUrl', 'listId', 'listTitle', 'id', 'properties');
+    this.types.string.push('webUrl', 'listId', 'listTitle', 'id', 'uniqueId', 'properties');
 }, _SpoListItemGetCommand_initOptionSets = function _SpoListItemGetCommand_initOptionSets() {
-    this.optionSets.push({ options: ['listId', 'listTitle', 'listUrl'] });
+    this.optionSets.push({ options: ['listId', 'listTitle', 'listUrl'] }, { options: ['id', 'uniqueId'] });
 };
 module.exports = new SpoListItemGetCommand();
 //# sourceMappingURL=listitem-get.js.map

package/dist/m365/spo/commands/listitem/listitem-retentionlabel-ensure.js

@@ -42,6 +42,9 @@ class SpoListItemRetentionLabelEnsureCommand extends SpoCommand_1.default {
         return __awaiter(this, void 0, void 0, function* () {
             try {
                 const labelInformation = yield this.getLabelInformation(args.options, logger);
+                if (args.options.assetId) {
+                    yield this.applyAssetId(args.options, logger);
+                }
                 yield this.applyLabel(args.options, labelInformation, logger);
             }
             catch (err) {
@@ -106,6 +109,34 @@ class SpoListItemRetentionLabelEnsureCommand extends SpoCommand_1.default {
             yield request_1.default.post(requestOptions);
         });
     }
+    applyAssetId(options, logger) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.verbose) {
+                logger.logToStderr(`Applying the asset Id ${options.assetId}...`);
+            }
+            let requestUrl = `${options.webUrl}/_api/web`;
+            if (options.listId) {
+                requestUrl += `/lists(guid'${formatting_1.formatting.encodeQueryParameter(options.listId)}')/items(${options.listItemId})/ValidateUpdateListItem()`;
+            }
+            else if (options.listTitle) {
+                requestUrl += `/lists/getByTitle('${formatting_1.formatting.encodeQueryParameter(options.listTitle)}')/items(${options.listItemId})/ValidateUpdateListItem()`;
+            }
+            else if (options.listUrl) {
+                const listServerRelativeUrl = urlUtil_1.urlUtil.getServerRelativePath(options.webUrl, options.listUrl);
+                requestUrl += `/GetList(@listUrl)/items(${options.listItemId})/ValidateUpdateListItem()?@listUrl='${formatting_1.formatting.encodeQueryParameter(listServerRelativeUrl)}'`;
+            }
+            const requestBody = { "formValues": [{ "FieldName": "ComplianceAssetId", "FieldValue": options.assetId }] };
+            const requestOptions = {
+                url: requestUrl,
+                headers: {
+                    'accept': 'application/json;odata=nometadata'
+                },
+                data: requestBody,
+                responseType: 'json'
+            };
+            yield request_1.default.post(requestOptions);
+        });
+    }
 }
 _SpoListItemRetentionLabelEnsureCommand_instances = new WeakSet(), _SpoListItemRetentionLabelEnsureCommand_initTelemetry = function _SpoListItemRetentionLabelEnsureCommand_initTelemetry() {
     this.telemetry.push((args) => {
@@ -114,7 +145,8 @@ _SpoListItemRetentionLabelEnsureCommand_instances = new WeakSet(), _SpoListItemR
             listTitle: typeof args.options.listTitle !== 'undefined',
             listUrl: typeof args.options.listUrl !== 'undefined',
             name: typeof args.options.name !== 'undefined',
-            id: typeof args.options.id !== 'undefined'
+            id: typeof args.options.id !== 'undefined',
+            assetId: typeof args.options.assetId !== 'undefined'
         });
     });
 }, _SpoListItemRetentionLabelEnsureCommand_initOptions = function _SpoListItemRetentionLabelEnsureCommand_initOptions() {
@@ -132,6 +164,8 @@ _SpoListItemRetentionLabelEnsureCommand_instances = new WeakSet(), _SpoListItemR
         option: '-n, --name [name]'
     }, {
         option: '-i, --id [id]'
+    }, {
+        option: '-a, --assetId [assetId]'
     });
 }, _SpoListItemRetentionLabelEnsureCommand_initValidators = function _SpoListItemRetentionLabelEnsureCommand_initValidators() {
     this.validators.push((args) => __awaiter(this, void 0, void 0, function* () {

package/dist/m365/spo/commands/listitem/listitem-set.js

@@ -15,6 +15,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 };
 var _SpoListItemSetCommand_instances, _SpoListItemSetCommand_initTelemetry, _SpoListItemSetCommand_initOptions, _SpoListItemSetCommand_initValidators, _SpoListItemSetCommand_initTypes, _SpoListItemSetCommand_initOptionSets;
 Object.defineProperty(exports, "__esModule", { value: true });
+const os = require("os");
 const config_1 = require("../../../../config");
 const request_1 = require("../../../../request");
 const formatting_1 = require("../../../../utils/formatting");
@@ -185,13 +186,11 @@ class SpoListItemSetCommand extends SpoCommand_1.default {
                 }
                 else {
                     // Response is from /ValidateUpdateListItem POST call, perform get on updated item to get all field values
-                    const returnedData = response.value;
-                    if (!returnedData[0].ItemId) {
-                        throw `Item didn't update successfully`;
-                    }
-                    else {
-                        itemId = returnedData[0].ItemId;
+                    const fieldValues = response.value;
+                    if (fieldValues.some(f => f.HasException)) {
+                        throw `Updating the items has failed with the following errors: ${os.EOL}${fieldValues.filter(f => f.HasException).map(f => { return `- ${f.FieldName} - ${f.ErrorMessage}`; }).join(os.EOL)}`;
                     }
+                    itemId = fieldValues[0].ItemId;
                 }
                 const requestOptionsItems = {
                     url: `${requestUrl}/items(${itemId})`,

package/dist/m365/spo/commands/web/web-set.js

@@ -69,20 +69,37 @@ class SpoWebSetCommand extends SpoCommand_1.default {
                 const searchScope = args.options.searchScope.toLowerCase();
                 payload.SearchScope = SpoWebSetCommand.searchScopeOptions.indexOf(searchScope);
             }
-            const requestOptions = {
-                url: `${args.options.url}/_api/web`,
-                headers: {
-                    'content-type': 'application/json;odata=nometadata',
-                    accept: 'application/json;odata=nometadata'
-                },
-                responseType: 'json',
-                data: payload
-            };
-            if (this.verbose) {
-                logger.logToStderr(`Updating properties of subsite ${args.options.url}...`);
-            }
             try {
+                const requestOptions = {
+                    url: `${args.options.url}/_api/web`,
+                    headers: {
+                        'content-type': 'application/json;odata=nometadata',
+                        accept: 'application/json;odata=nometadata'
+                    },
+                    responseType: 'json',
+                    data: payload
+                };
+                if (this.verbose) {
+                    logger.logToStderr(`Updating properties of subsite ${args.options.url}...`);
+                }
                 yield request_1.default.patch(requestOptions);
+                if (typeof args.options.welcomePage !== 'undefined') {
+                    if (this.verbose) {
+                        logger.logToStderr(`Setting welcome page to: ${args.options.welcomePage}...`);
+                    }
+                    const requestOptions = {
+                        url: `${args.options.url}/_api/web/RootFolder`,
+                        headers: {
+                            'content-type': 'application/json;odata=nometadata',
+                            accept: 'application/json;odata=nometadata'
+                        },
+                        responseType: 'json',
+                        data: {
+                            WelcomePage: args.options.welcomePage
+                        }
+                    };
+                    yield request_1.default.patch(requestOptions);
+                }
             }
             catch (err) {
                 this.handleRejectedODataJsonPromise(err);
@@ -105,7 +122,8 @@ _SpoWebSetCommand_instances = new WeakSet(), _SpoWebSetCommand_initTelemetry = f
             quickLaunchEnabled: typeof args.options.quickLaunchEnabled !== 'undefined',
             footerEnabled: typeof args.options.footerEnabled !== 'undefined',
             navAudienceTargetingEnabled: typeof args.options.navAudienceTargetingEnabled !== 'undefined',
-            searchScope: args.options.searchScope !== 'undefined'
+            searchScope: typeof args.options.searchScope !== 'undefined',
+            welcomePage: typeof args.options.welcomePage !== 'undefined'
         });
         this.trackUnknownOptions(this.telemetryProperties, args.options);
     });
@@ -139,6 +157,8 @@ _SpoWebSetCommand_instances = new WeakSet(), _SpoWebSetCommand_initTelemetry = f
     }, {
         option: '--searchScope [searchScope]',
         autocomplete: SpoWebSetCommand.searchScopeOptions
+    }, {
+        option: '--welcomePage [welcomePage]'
     });
 }, _SpoWebSetCommand_initTypes = function _SpoWebSetCommand_initTypes() {
     this.types.boolean.push('megaMenuEnabled', 'footerEnabled', 'quickLaunchEnabled', 'navAudienceTargetingEnabled');

package/dist/settingsNames.js

@@ -15,7 +15,8 @@ const settingsNames = {
     output: 'output',
     printErrorsAsPlainText: 'printErrorsAsPlainText',
     prompt: 'prompt',
-    showHelpOnFailure: 'showHelpOnFailure'
+    showHelpOnFailure: 'showHelpOnFailure',
+    showSpinner: 'showSpinner'
 };
 exports.settingsNames = settingsNames;
 //# sourceMappingURL=settingsNames.js.map

package/dist/utils/fsUtil.js

@@ -42,7 +42,7 @@ const addFileCommands = {
         addFileCommand: 'cat > [FILEPATH] << EOF [FILECONTENT]EOF'
     },
     powershell: {
-        addFileCommand: `@"[FILECONTENT]"@ | Out-File -FilePath [FILEPATH]`
+        addFileCommand: `@'[FILECONTENT]'@ | Out-File -FilePath [FILEPATH]`
     },
     cmd: {
         addFileCommand: `echo [FILECONTENT] > [FILEPATH]`

package/docs/docs/_clisettings.md

@@ -18,3 +18,4 @@ Setting name|Definition|Default value
 `printErrorsAsPlainText`|When output mode is set to `json`, print error messages as plain-text rather than JSON|`true`
 `prompt`|Prompts for missing values in required options|`false`
 `showHelpOnFailure`|Automatically display help when executing a command failed|`true`
+`showSpinner`|Display spinner when executing commands|`true`

package/docs/docs/cmd/aad/o365group/o365group-add.md

@@ -48,7 +48,7 @@ m365 aad o365group add [options]
 ## Remarks
 
 When specifying the path to the logo image you can use both relative and absolute paths. Note, that ~ in the path, will not be resolved and will most likely result in an error.
-If an invalid user is provided in the comma-separated list or Owners or Members, the command operation will fail and the Micrsoft 365 Group will not be created.
+If an invalid user is provided in the comma-separated list of Owners or Members, the command operation will fail and the Microsoft 365 Group will not be created.
 
 ## Examples
 
@@ -76,13 +76,13 @@ Create a public Microsoft 365 Group and set specified users as its members
 m365 aad o365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --members "DebraB@contoso.onmicrosoft.com,DiegoS@contoso.onmicrosoft.com"
 ```
 
-Create a public Microsoft 365 Group and allows only group members to be able to post conversations to the group.
+Create a public Microsoft 365 Group and allow only group members to be able to post conversations to the group.
 
 ```sh
 m365 aad o365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --allowMembersToPost
 ```
 
-Create a public Microsoft 365 Group and hides it from the Outlook experiences (web and client).
+Create a public Microsoft 365 Group and hide it from the Outlook experiences (web and client).
 
 ```sh
 m365 aad o365group add --displayName Finance --description "This is the Contoso Finance Group. Please come here and check out the latest news, posts, files, and more." --mailNickname finance --hideGroupInOutlook

package/docs/docs/cmd/pa/app/app-export.md

@@ -0,0 +1,52 @@
+# pa app export
+
+Exports the specified Power App
+
+## Usage
+
+```sh
+m365 pa app export [options]
+```
+
+## Options
+
+`-i, --id <id>`
+: The id of the Power App to export
+
+`-e, --environment <environment>`
+: The name of the environment for which to export the app
+
+`-n, --packageDisplayName [packageDisplayName]`
+: The display name to use in the exported package
+
+`-d, --packageDescription [packageDescription]`
+: The description to use in the exported package
+
+`-c, --packageCreatedBy [packageCreatedBy]`
+: The name of the person to be used as the creator of the exported package
+
+`-s, --packageSourceEnvironment [packageSourceEnvironment]`
+: The name of the source environment from which the exported package was taken
+
+`-p, --path [path]`
+: The path to save the exported package to. If not specified the app will be exported in the current working directory
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Export the specified Power App as a ZIP file
+
+```sh
+m365 pa app export --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 3989cb59-ce1a-4a5c-bb78-257c5c39381d 
+```
+
+Export the specified Power App as a ZIP file with the package displayname, package description, the one who created it, the package source environment and the path
+
+```sh
+m365 pa app export --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 3989cb59-ce1a-4a5c-bb78-257c5c39381d --packageDisplayName "PowerApp" --packageDescription "Power App Description" --packageCreatedBy "John Doe" --packageSourceEnvironment "Contoso" --path "C:/Users/John/Documents"
+```
+
+## Response
+
+The command won't return a response on success.