@pnp/cli-microsoft365 11.9.0-beta.69c1186 → 11.9.0-beta.87e70e2

package/dist/m365/pp/commands/aibuildermodel/aibuildermodel-get.js

@@ -16,7 +16,7 @@ class PpAiBuilderModelGetCommand extends PowerPlatformCommand {
         return commands.AIBUILDERMODEL_GET;
     }
     get description() {
-        return 'Get an AI builder model in the specified Power Platform environment.';
+        return 'Gets a specific AI builder model in the specified Power Platform environment';
     }
     constructor() {
         super();

package/dist/m365/pp/commands/aibuildermodel/aibuildermodel-list.js

@@ -13,7 +13,7 @@ class PpAiBuilderModelListCommand extends PowerPlatformCommand {
         return commands.AIBUILDERMODEL_LIST;
     }
     get description() {
-        return 'List available AI builder models in the specified Power Platform environment.';
+        return 'Lists available AI builder models in the specified Power Platform environment.';
     }
     defaultProperties() {
         return ['msdyn_name', 'msdyn_aimodelid', 'createdon', 'modifiedon'];

package/dist/m365/pp/commands/copilot/copilot-get.js

@@ -16,7 +16,7 @@ class PpCopilotGetCommand extends PowerPlatformCommand {
         return commands.COPILOT_GET;
     }
     get description() {
-        return 'Get information about the specified copilot';
+        return 'Gets information about the specified copilot';
     }
     constructor() {
         super();

package/dist/m365/pp/commands/gateway/gateway-get.js

@@ -14,7 +14,7 @@ class PpGatewayGetCommand extends PowerBICommand {
         return commands.GATEWAY_GET;
     }
     get description() {
-        return "Get information about the specified gateway.";
+        return "Gets information about the specified gateway.";
     }
     constructor() {
         super();

package/dist/m365/pp/commands/managementapp/managementapp-add.js

@@ -14,7 +14,7 @@ class PpManagementAppAddCommand extends PowerPlatformCommand {
         return commands.MANAGEMENTAPP_ADD;
     }
     get description() {
-        return 'Register management application for Power Platform';
+        return 'Registers management application for Power Platform';
     }
     constructor() {
         super();

package/dist/m365/pp/commands/solution/solution-publisher-get.js

@@ -14,7 +14,7 @@ class PpSolutionPublisherGetCommand extends PowerPlatformCommand {
         return commands.SOLUTION_PUBLISHER_GET;
     }
     get description() {
-        return 'Get information about the specified publisher in a given environment.';
+        return 'Gets information about the specified publisher in a given environment.';
     }
     constructor() {
         super();

package/dist/m365/purview/commands/auditlog/auditlog-list.js

@@ -15,7 +15,7 @@ class PurviewAuditLogListCommand extends O365MgmtCommand {
         return commands.AUDITLOG_LIST;
     }
     get description() {
-        return 'List audit logs within your tenant';
+        return 'Lists audit logs within your tenant';
     }
     defaultProperties() {
         return ['CreationTime', 'UserId', 'Operation', 'ObjectId'];

package/dist/m365/purview/commands/retentionevent/retentionevent-add.js

@@ -14,7 +14,7 @@ class PurviewRetentionEventAddCommand extends GraphCommand {
         return commands.RETENTIONEVENT_ADD;
     }
     get description() {
-        return 'Create a retention event';
+        return 'Creates a retention event';
     }
     constructor() {
         super();

package/dist/m365/purview/commands/retentionevent/retentionevent-get.js

@@ -13,7 +13,7 @@ class PurviewRetentionEventGetCommand extends GraphCommand {
         return commands.RETENTIONEVENT_GET;
     }
     get description() {
-        return 'Retrieve the specified retention event';
+        return 'Gets a retention event';
     }
     constructor() {
         super();

package/dist/m365/purview/commands/retentionevent/retentionevent-list.js

@@ -9,7 +9,7 @@ class PurviewRetentionEventListCommand extends GraphCommand {
         return commands.RETENTIONEVENT_LIST;
     }
     get description() {
-        return 'Get a list of retention events';
+        return 'Gets a list of retention events';
     }
     get schema() {
         return options;

package/dist/m365/purview/commands/retentionevent/retentionevent-remove.js

@@ -14,7 +14,7 @@ class PurviewRetentionEventRemoveCommand extends GraphCommand {
         return commands.RETENTIONEVENT_REMOVE;
     }
     get description() {
-        return 'Delete a retention event';
+        return 'Deletes a retention event';
     }
     constructor() {
         super();

package/dist/m365/purview/commands/retentioneventtype/retentioneventtype-add.js

@@ -12,7 +12,7 @@ class PurviewRetentionEventTypeAddCommand extends GraphCommand {
         return commands.RETENTIONEVENTTYPE_ADD;
     }
     get description() {
-        return 'Create a retention event type';
+        return 'Creates a retention event type';
     }
     constructor() {
         super();

package/dist/m365/purview/commands/retentioneventtype/retentioneventtype-get.js

@@ -13,7 +13,7 @@ class PurviewRetentionEventTypeGetCommand extends GraphCommand {
         return commands.RETENTIONEVENTTYPE_GET;
     }
     get description() {
-        return 'Retrieve the specified retention event type';
+        return 'Gets a retention event type';
     }
     constructor() {
         super();

package/dist/m365/purview/commands/retentioneventtype/retentioneventtype-list.js

@@ -8,7 +8,7 @@ class PurviewRetentionEventTypeListCommand extends GraphCommand {
         return commands.RETENTIONEVENTTYPE_LIST;
     }
     get description() {
-        return 'Get a list of retention event types';
+        return 'Gets a list of retention event types';
     }
     get schema() {
         return options;

package/dist/m365/purview/commands/retentioneventtype/retentioneventtype-remove.js

@@ -14,7 +14,7 @@ class PurviewRetentionEventTypeRemoveCommand extends GraphCommand {
         return commands.RETENTIONEVENTTYPE_REMOVE;
     }
     get description() {
-        return 'Delete a retention event type';
+        return 'Deletes a retention event type';
     }
     constructor() {
         super();

package/dist/m365/purview/commands/retentioneventtype/retentioneventtype-set.js

@@ -13,7 +13,7 @@ class PurviewRetentionEventTypeSetCommand extends GraphCommand {
         return commands.RETENTIONEVENTTYPE_SET;
     }
     get description() {
-        return 'Update a retention event type';
+        return 'Updates a retention event type';
     }
     constructor() {
         super();

package/dist/m365/purview/commands/retentionlabel/retentionlabel-add.js

@@ -13,7 +13,7 @@ class PurviewRetentionLabelAddCommand extends GraphCommand {
         return commands.RETENTIONLABEL_ADD;
     }
     get description() {
-        return 'Create a retention label';
+        return 'Creates a retention label';
     }
     constructor() {
         super();

package/dist/m365/purview/commands/retentionlabel/retentionlabel-get.js

@@ -13,7 +13,7 @@ class PurviewRetentionLabelGetCommand extends GraphCommand {
         return commands.RETENTIONLABEL_GET;
     }
     get description() {
-        return 'Retrieve the specified retention label';
+        return 'Gets a retention label';
     }
     constructor() {
         super();

package/dist/m365/purview/commands/retentionlabel/retentionlabel-list.js

@@ -8,7 +8,7 @@ class PurviewRetentionLabelListCommand extends GraphCommand {
         return commands.RETENTIONLABEL_LIST;
     }
     get description() {
-        return 'Get a list of retention labels';
+        return 'Gets a list of retention labels';
     }
     get schema() {
         return options;

package/dist/m365/purview/commands/retentionlabel/retentionlabel-remove.js

@@ -14,7 +14,7 @@ class PurviewRetentionLabelRemoveCommand extends GraphCommand {
         return commands.RETENTIONLABEL_REMOVE;
     }
     get description() {
-        return 'Delete a retention label';
+        return 'Deletes a retention label';
     }
     constructor() {
         super();

package/dist/m365/purview/commands/retentionlabel/retentionlabel-set.js

@@ -13,7 +13,7 @@ class PurviewRetentionLabelSetCommand extends GraphCommand {
         return commands.RETENTIONLABEL_SET;
     }
     get description() {
-        return 'Update a retention label';
+        return 'Updates a retention label';
     }
     constructor() {
         super();

package/dist/m365/purview/commands/sensitivitylabel/sensitivitylabel-get.js

@@ -15,7 +15,7 @@ class PurviewSensitivityLabelGetCommand extends GraphCommand {
         return commands.SENSITIVITYLABEL_GET;
     }
     get description() {
-        return 'Retrieve the specified sensitivity label';
+        return 'Retrieves the specified sensitivity label';
     }
     constructor() {
         super();

package/dist/m365/purview/commands/sensitivitylabel/sensitivitylabel-list.js

@@ -15,7 +15,7 @@ class PurviewSensitivityLabelListCommand extends GraphCommand {
         return commands.SENSITIVITYLABEL_LIST;
     }
     get description() {
-        return 'Get a list of sensitivity labels';
+        return 'Gets a list of sensitivity labels';
     }
     constructor() {
         super();

package/dist/m365/purview/commands/sensitivitylabel/sensitivitylabel-policysettings-list.js

@@ -15,7 +15,7 @@ class PurviewSensitivityLabelPolicySettingsListCommand extends GraphCommand {
         return commands.SENSITIVITYLABEL_POLICYSETTINGS_LIST;
     }
     get description() {
-        return 'Get a list of policy settings for a sensitivity label';
+        return 'Gets a list of policy settings for a sensitivity label';
     }
     constructor() {
         super();

package/dist/m365/purview/commands/threatassessment/threatassessment-add.js

@@ -16,7 +16,7 @@ class PurviewThreatAssessmentAddCommand extends GraphCommand {
         return commands.THREATASSESSMENT_ADD;
     }
     get description() {
-        return 'Create a threat assessment';
+        return 'Creates a threat assessment';
     }
     constructor() {
         super();

package/dist/m365/purview/commands/threatassessment/threatassessment-get.js

@@ -13,7 +13,7 @@ class PurviewThreatAssessmentGetCommand extends GraphCommand {
         return commands.THREATASSESSMENT_GET;
     }
     get description() {
-        return 'Get a threat assessment';
+        return 'Gets a threat assessment';
     }
     constructor() {
         super();

package/dist/m365/purview/commands/threatassessment/threatassessment-list.js

@@ -12,7 +12,7 @@ class PurviewThreatAssessmentListCommand extends GraphCommand {
         return commands.THREATASSESSMENT_LIST;
     }
     get description() {
-        return 'Get a list of threat assessments';
+        return 'Gets a list of threat assessments';
     }
     defaultProperties() {
         return ['id', 'type', 'category'];

package/dist/m365/spe/commands/container/container-permission-list.js

@@ -1,13 +1,17 @@
 import { cli } from '../../../../cli/cli.js';
 import { z } from 'zod';
-import { globalOptionsZod } from '../../../../Command.js';
+import { CommandError, globalOptionsZod } from '../../../../Command.js';
 import commands from '../../commands.js';
 import GraphCommand from '../../../base/GraphCommand.js';
 import { odata } from '../../../../utils/odata.js';
 import { formatting } from '../../../../utils/formatting.js';
+import { spe } from '../../../../utils/spe.js';
 export const options = z.strictObject({
     ...globalOptionsZod.shape,
-    containerId: z.string().alias('i')
+    containerId: z.string().alias('i').optional(),
+    containerName: z.string().alias('n').optional(),
+    containerTypeId: z.uuid().optional(),
+    containerTypeName: z.string().optional()
 });
 class SpeContainerPermissionListCommand extends GraphCommand {
     get name() {
@@ -22,12 +26,25 @@ class SpeContainerPermissionListCommand extends GraphCommand {
     get schema() {
         return options;
     }
+    getRefinedSchema(schema) {
+        return schema
+            .refine((opts) => [opts.containerId, opts.containerName].filter(value => value !== undefined).length === 1, {
+            message: 'Specify either id or name, but not both.'
+        })
+            .refine((options) => !options.containerName || [options.containerTypeId, options.containerTypeName].filter(o => o !== undefined).length === 1, {
+            error: 'Use one of the following options when specifying the container name: containerTypeId or containerTypeName.'
+        })
+            .refine((options) => options.containerName || [options.containerTypeId, options.containerTypeName].filter(o => o !== undefined).length === 0, {
+            error: 'Options containerTypeId and containerTypeName are only required when retrieving a container by name.'
+        });
+    }
     async commandAction(logger, args) {
         try {
+            const containerId = await this.resolveContainerId(args.options, logger);
             if (this.verbose) {
-                await logger.logToStderr(`Retrieving permissions of a SharePoint Embedded Container with id '${args.options.containerId}'...`);
+                await logger.logToStderr(`Retrieving permissions of a SharePoint Embedded Container with id '${containerId}'...`);
             }
-            const containerPermission = await odata.getAllItems(`${this.resource}/v1.0/storage/fileStorage/containers/${formatting.encodeQueryParameter(args.options.containerId)}/permissions`);
+            const containerPermission = await odata.getAllItems(`${this.resource}/v1.0/storage/fileStorage/containers/${formatting.encodeQueryParameter(containerId)}/permissions`);
             if (!cli.shouldTrimOutput(args.options.output)) {
                 await logger.log(containerPermission);
             }
@@ -42,9 +59,31 @@ class SpeContainerPermissionListCommand extends GraphCommand {
             }
         }
         catch (err) {
+            if (err instanceof CommandError) {
+                throw err;
+            }
             this.handleRejectedODataJsonPromise(err);
         }
     }
+    async resolveContainerId(options, logger) {
+        if (options.containerId) {
+            return options.containerId;
+        }
+        if (this.verbose) {
+            await logger.logToStderr(`Resolving container id from name '${options.containerName}'...`);
+        }
+        const containerTypeId = await this.getContainerTypeId(options, logger);
+        return spe.getContainerIdByName(containerTypeId, options.containerName);
+    }
+    async getContainerTypeId(options, logger) {
+        if (options.containerTypeId) {
+            return options.containerTypeId;
+        }
+        if (this.verbose) {
+            await logger.logToStderr(`Getting container type with name '${options.containerTypeName}'...`);
+        }
+        return spe.getContainerTypeIdByName(options.containerTypeName);
+    }
 }
 export default new SpeContainerPermissionListCommand();
 //# sourceMappingURL=container-permission-list.js.map

package/dist/m365/spe/commands/containertype/containertype-remove.js

@@ -18,7 +18,7 @@ class SpeContainerTypeRemoveCommand extends SpoCommand {
         return commands.CONTAINERTYPE_REMOVE;
     }
     get description() {
-        return 'Remove a specific container type';
+        return 'Removes a specific container type';
     }
     get schema() {
         return options;

package/dist/m365/spfx/commands/project/project-permissions-grant.js

@@ -10,7 +10,7 @@ class SpfxProjectPermissionSGrantCommand extends BaseProjectCommand {
         return commands.PROJECT_PERMISSIONS_GRANT;
     }
     get description() {
-        return 'Grant API permissions defined in the current SPFx project';
+        return 'Grants API permissions defined in the current SPFx project';
     }
     constructor() {
         super();

package/dist/m365/spo/commands/app/app-instance-list.js

@@ -13,7 +13,7 @@ class SpoAppInStanceListCommand extends SpoAppBaseCommand {
         return commands.APP_INSTANCE_LIST;
     }
     get description() {
-        return 'Retrieve apps installed in a site';
+        return 'Retrieves apps installed in a site';
     }
     defaultProperties() {
         return [`Title`, `AppId`];

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

@@ -13,7 +13,7 @@ class SpoApplicationCustomizerAddCommand extends SpoCommand {
         return commands.APPLICATIONCUSTOMIZER_ADD;
     }
     get description() {
-        return 'Add an application customizer to a site.';
+        return 'Adds an application customizer to a site.';
     }
     constructor() {
         super();

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

@@ -15,7 +15,7 @@ class SpoApplicationCustomizerGetCommand extends SpoCommand {
         return commands.APPLICATIONCUSTOMIZER_GET;
     }
     get description() {
-        return 'Get an application customizer that is added to a site.';
+        return 'Gets an application customizer that is added to a site.';
     }
     constructor() {
         super();

package/dist/m365/spo/commands/applicationcustomizer/applicationcustomizer-list.js

@@ -13,7 +13,7 @@ class SpoApplicationCustomizerListCommand extends SpoCommand {
         return commands.APPLICATIONCUSTOMIZER_LIST;
     }
     get description() {
-        return 'Get a list of application customizers that are added to a site.';
+        return 'Gets a list of application customizers that are added to a site.';
     }
     defaultProperties() {
         return ['Name', 'Location', 'Scope', 'Id'];

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

@@ -14,7 +14,7 @@ class SpoCdnGetCommand extends SpoCommand {
         return commands.CDN_GET;
     }
     get description() {
-        return 'View current status of the specified Microsoft 365 CDN';
+        return 'Views current status of the specified Microsoft 365 CDN';
     }
     constructor() {
         super();

package/dist/m365/spo/commands/cdn/cdn-origin-list.js

@@ -14,7 +14,7 @@ class SpoCdnOriginListCommand extends SpoCommand {
         return commands.CDN_ORIGIN_LIST;
     }
     get description() {
-        return 'List CDN origins settings for the current SharePoint Online tenant';
+        return 'Lists CDN origins settings for the current SharePoint Online tenant';
     }
     constructor() {
         super();

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

@@ -14,7 +14,7 @@ class SpoCdnSetCommand extends SpoCommand {
         return commands.CDN_SET;
     }
     get description() {
-        return 'Enable or disable the specified Microsoft 365 CDN';
+        return 'Enables or disables the specified Microsoft 365 CDN';
     }
     constructor() {
         super();

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

@@ -13,7 +13,7 @@ class SpoCommandSetAddCommand extends SpoCommand {
         return commands.COMMANDSET_ADD;
     }
     get description() {
-        return 'Add a ListView Command Set to a site.';
+        return 'Adds a ListView Command Set to a site.';
     }
     constructor() {
         super();

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

@@ -15,7 +15,7 @@ class SpoCommandSetGetCommand extends SpoCommand {
         return commands.COMMANDSET_GET;
     }
     get description() {
-        return 'Get a ListView Command Set that is added to a site.';
+        return 'Gets a ListView Command Set that is added to a site.';
     }
     constructor() {
         super();

package/dist/m365/spo/commands/commandset/commandset-list.js

@@ -13,7 +13,7 @@ class SpoCommandSetListCommand extends SpoCommand {
         return commands.COMMANDSET_LIST;
     }
     get description() {
-        return 'Get a list of ListView Command Sets that are added to a site.';
+        return 'Gets a list of ListView Command Sets that are added to a site.';
     }
     defaultProperties() {
         return ['Name', 'Location', 'Scope', 'Id'];

package/dist/m365/spo/commands/commandset/commandset-remove.js

@@ -16,7 +16,7 @@ class SpoCommandSetRemoveCommand extends SpoCommand {
         return commands.COMMANDSET_REMOVE;
     }
     get description() {
-        return 'Remove a ListView Command Set that is added to a site.';
+        return 'Removes a ListView Command Set that is added to a site.';
     }
     constructor() {
         super();

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

@@ -17,7 +17,7 @@ class SpoContentTypeSetCommand extends SpoCommand {
         return commands.CONTENTTYPE_SET;
     }
     get description() {
-        return 'Update an existing content type';
+        return 'Updates an existing content type';
     }
     constructor() {
         super();

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

@@ -16,7 +16,7 @@ class SpoFileRetentionLabelEnsureCommand extends SpoCommand {
         return commands.FILE_RETENTIONLABEL_ENSURE;
     }
     get description() {
-        return 'Apply a retention label to a file';
+        return 'Applies a retention label to a file';
     }
     constructor() {
         super();

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

@@ -17,7 +17,7 @@ class SpoFileRetentionLabelRemoveCommand extends SpoCommand {
         return commands.FILE_RETENTIONLABEL_REMOVE;
     }
     get description() {
-        return 'Clear the retention label from a file';
+        return 'Clears the retention label from a file';
     }
     constructor() {
         super();

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

@@ -0,0 +1,83 @@
+import commands from '../../commands.js';
+import SpoCommand from '../../../base/SpoCommand.js';
+import { globalOptionsZod } from '../../../../Command.js';
+import { z } from 'zod';
+import { validation } from '../../../../utils/validation.js';
+import { cli } from '../../../../cli/cli.js';
+import { urlUtil } from '../../../../utils/urlUtil.js';
+import request from '../../../../request.js';
+import { formatting } from '../../../../utils/formatting.js';
+export const options = z.strictObject({
+    ...globalOptionsZod.shape,
+    webUrl: z.string()
+        .refine(url => validation.isValidSharePointUrl(url) === true, {
+        error: e => `'${e.input}' is not a valid SharePoint Online site URL.`
+    })
+        .alias('u'),
+    url: z.string().optional(),
+    id: z.uuid().optional().alias('i'),
+    force: z.boolean().optional().alias('f')
+});
+class SpoFileUnarchiveCommand extends SpoCommand {
+    get name() {
+        return commands.FILE_UNARCHIVE;
+    }
+    get description() {
+        return 'Unarchives a file';
+    }
+    get schema() {
+        return options;
+    }
+    getRefinedSchema(schema) {
+        return schema
+            .refine(options => [options.url, options.id].filter(o => o !== undefined).length === 1, {
+            error: `Specify 'url' or 'id', but not both.`
+        });
+    }
+    getExcludedOptionsWithUrls() {
+        return ['url'];
+    }
+    async commandAction(logger, args) {
+        const { webUrl, url, id, force, verbose } = args.options;
+        if (!force) {
+            const result = await cli.promptForConfirmation({ message: `Reactivation could take up to 24 hours. Files that are reactivated cannot be archived again for 30 days. Are you sure you would like to unarchive this item?` });
+            if (!result) {
+                return;
+            }
+        }
+        try {
+            if (verbose) {
+                await logger.logToStderr(`Unarchiving file '${url || id}' at site '${webUrl}'...`);
+            }
+            let requestUrl = `${webUrl}/_api/web`;
+            if (id) {
+                requestUrl += `/GetFileById('${formatting.encodeQueryParameter(id)}')`;
+            }
+            else if (url) {
+                const serverRelativePath = urlUtil.getServerRelativePath(webUrl, url);
+                requestUrl += `/GetFileByServerRelativePath(DecodedUrl='${formatting.encodeQueryParameter(serverRelativePath)}')`;
+            }
+            requestUrl += '?$select=ListId,ListItemAllFields/Id&$expand=ListItemAllFields';
+            const fileInfo = await request.get({
+                url: requestUrl,
+                headers: {
+                    accept: 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            });
+            const requestOptions = {
+                url: `${webUrl}/_api/Lists(guid'${fileInfo.ListId}')/items(${fileInfo.ListItemAllFields.Id})/UnArchive`,
+                headers: {
+                    accept: 'application/json;odata=nometadata'
+                },
+                responseType: 'json'
+            };
+            await request.post(requestOptions);
+        }
+        catch (err) {
+            this.handleRejectedODataJsonPromise(err);
+        }
+    }
+}
+export default new SpoFileUnarchiveCommand();
+//# sourceMappingURL=file-unarchive.js.map

package/dist/m365/spo/commands/file/file-version-get.js

@@ -15,7 +15,7 @@ class SpoFileVersionGetCommand extends SpoCommand {
         return commands.FILE_VERSION_GET;
     }
     get description() {
-        return 'Get a specific version of a file in a SharePoint Document library';
+        return 'Gets information about a specific version of a specified file';
     }
     constructor() {
         super();

package/dist/m365/spo/commands/file/file-version-keep.js

@@ -23,7 +23,7 @@ class SpoFileVersionKeepCommand extends SpoCommand {
         return commands.FILE_VERSION_KEEP;
     }
     get description() {
-        return 'Ensure that a specific file version will never expire';
+        return 'Ensures that a specific file version will never expire';
     }
     get schema() {
         return options;