@pnp/cli-microsoft365 4.1.0-beta.ad0d160 → 4.2.0-beta.5746637

package/dist/m365/spo/commands/listitem/listitem-attachment-list.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const request_1 = require("../../../../request");
+const Utils_1 = require("../../../../Utils");
+const SpoCommand_1 = require("../../../base/SpoCommand");
+const commands_1 = require("../../commands");
+class SpoListItemAttachmentListCommand extends SpoCommand_1.default {
+    get name() {
+        return commands_1.default.LISTITEM_ATTACHMENT_LIST;
+    }
+    get description() {
+        return 'Gets the attachments associated to a list item';
+    }
+    getTelemetryProperties(args) {
+        const telemetryProps = super.getTelemetryProperties(args);
+        telemetryProps.listId = typeof args.options.listId !== 'undefined';
+        telemetryProps.listTitle = typeof args.options.listTitle !== 'undefined';
+        return telemetryProps;
+    }
+    defaultProperties() {
+        return ['FileName', 'ServerRelativeUrl'];
+    }
+    commandAction(logger, args, cb) {
+        const listIdArgument = args.options.listId || '';
+        const listTitleArgument = args.options.listTitle || '';
+        const listRestUrl = (args.options.listId ?
+            `${args.options.webUrl}/_api/web/lists(guid'${encodeURIComponent(listIdArgument)}')`
+            : `${args.options.webUrl}/_api/web/lists/getByTitle('${encodeURIComponent(listTitleArgument)}')`);
+        const requestOptions = {
+            url: `${listRestUrl}/items(${args.options.itemId})?$select=AttachmentFiles&$expand=AttachmentFiles`,
+            method: 'GET',
+            headers: {
+                'accept': 'application/json;odata=nometadata'
+            },
+            responseType: 'json'
+        };
+        request_1.default
+            .get(requestOptions)
+            .then((attachmentFiles) => {
+            if (attachmentFiles.AttachmentFiles && attachmentFiles.AttachmentFiles.length > 0) {
+                logger.log(attachmentFiles.AttachmentFiles);
+            }
+            else {
+                if (this.verbose) {
+                    logger.logToStderr('No attachments found');
+                }
+            }
+            cb();
+        }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
+    }
+    options() {
+        const options = [
+            {
+                option: '-u, --webUrl <webUrl>'
+            },
+            {
+                option: '--itemId <itemId>'
+            },
+            {
+                option: '--listId [listId]'
+            },
+            {
+                option: '--listTitle [listTitle]'
+            }
+        ];
+        const parentOptions = super.options();
+        return options.concat(parentOptions);
+    }
+    validate(args) {
+        const isValidSharePointUrl = SpoCommand_1.default.isValidSharePointUrl(args.options.webUrl);
+        if (isValidSharePointUrl !== true) {
+            return isValidSharePointUrl;
+        }
+        if (!args.options.listId && !args.options.listTitle) {
+            return `Specify listId or listTitle`;
+        }
+        if (args.options.listId && args.options.listTitle) {
+            return `Specify listId or listTitle but not both`;
+        }
+        if (args.options.listId && !Utils_1.default.isValidGuid(args.options.listId)) {
+            return `${args.options.listId} in option listId is not a valid GUID`;
+        }
+        if (isNaN(parseInt(args.options.itemId))) {
+            return `${args.options.itemId} is not a number`;
+        }
+        return true;
+    }
+}
+module.exports = new SpoListItemAttachmentListCommand();
+//# sourceMappingURL=listitem-attachment-list.js.map

package/dist/m365/spo/commands.js

@@ -107,6 +107,7 @@ exports.default = {
     LIST_WEBHOOK_REMOVE: `${prefix} list webhook remove`,
     LIST_WEBHOOK_SET: `${prefix} list webhook set`,
     LISTITEM_ADD: `${prefix} listitem add`,
+    LISTITEM_ATTACHMENT_LIST: `${prefix} listitem attachment list`,
     LISTITEM_GET: `${prefix} listitem get`,
     LISTITEM_ISRECORD: `${prefix} listitem isrecord`,
     LISTITEM_LIST: `${prefix} listitem list`,

package/dist/m365/teams/commands/user/user-app-list.js

@@ -23,7 +23,7 @@ class TeamsUserAppListCommand extends GraphItemsListCommand_1.GraphItemsListComm
             .getUserId(args)
             .then((_userId) => {
             userId = _userId.value;
-            const endpoint = `${this.resource}/v1.0/users/${encodeURIComponent(userId)}/teamwork/installedApps`;
+            const endpoint = `${this.resource}/v1.0/users/${encodeURIComponent(userId)}/teamwork/installedApps?$expand=teamsAppDefinition`;
             return this.getAllItems(endpoint, logger, true);
         })
             .then(() => {
@@ -39,7 +39,9 @@ class TeamsUserAppListCommand extends GraphItemsListCommand_1.GraphItemsListComm
                 logger.log(this.items.map(i => {
                     return {
                         id: i.id,
-                        appId: i.appId
+                        appId: i.appId,
+                        displayName: i.teamsAppDefinition.displayName,
+                        version: i.teamsAppDefinition.version
                     };
                 }));
             }
@@ -62,10 +64,10 @@ class TeamsUserAppListCommand extends GraphItemsListCommand_1.GraphItemsListComm
     options() {
         const options = [
             {
-                option: '--userId'
+                option: '--userId [userId]'
             },
             {
-                option: '--userName'
+                option: '--userName [userName]'
             }
         ];
         const parentOptions = super.options();
@@ -73,10 +75,10 @@ class TeamsUserAppListCommand extends GraphItemsListCommand_1.GraphItemsListComm
     }
     validate(args) {
         if (!args.options.userId && !args.options.userName) {
-            return `--userId or --userName need to be provided`;
+            return `userId or userName need to be provided`;
         }
         if (args.options.userId && args.options.userName) {
-            return `Please specify either --userId or --userName, not both`;
+            return `Please specify either userId or userName, not both`;
         }
         if (args.options.userId && !Utils_1.default.isValidGuid(args.options.userId)) {
             return `${args.options.userId} is not a valid GUID`;

package/docs/docs/cmd/aad/o365group/{o365group-restore.md → o365group-recyclebinitem-restore.md}

@@ -4,6 +4,12 @@ Restores a deleted Microsoft 365 Group
 
 ## Usage
 
+```sh
+m365 aad o365group recyclebinitem restore [options]
+```
+
+## Alias
+
 ```sh
 m365 aad o365group restore [options]
 ```
@@ -20,5 +26,5 @@ m365 aad o365group restore [options]
 Restores the Microsoft 365 Group with id _28beab62-7540-4db1-a23f-29a6018a3848_
 
 ```sh
-m365 aad o365group restore --id 28beab62-7540-4db1-a23f-29a6018a3848
+m365 aad o365group recyclebinitem restore --id 28beab62-7540-4db1-a23f-29a6018a3848
 ```

package/docs/docs/cmd/aad/oauth2grant/oauth2grant-remove.md

@@ -35,4 +35,5 @@ m365 aad oauth2grant remove --grantId YgA60KYa4UOPSdc-lpxYEnQkr8KVLDpCsOXkiV8i-e
 
 ## More information
 
-- Application and service principal objects in Azure Active Directory (Azure AD): [https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-application-objects](https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-application-objects)
+- Application and service principal objects in Azure Active Directory (Azure AD): [https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-application-objects](https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-application-objects)
+- Delete a delegated permission grant (oAuth2PermissionGrant): [https://docs.microsoft.com/en-us/graph/api/oauth2permissiongrant-delete?view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/oauth2permissiongrant-delete?view=graph-rest-1.0)

package/docs/docs/cmd/aad/oauth2grant/oauth2grant-set.md

@@ -22,7 +22,7 @@ m365 aad oauth2grant set [options]
 
 Before you can update service principal's OAuth2 permissions, you need to get the `objectId` of the permissions grant to update. You can retrieve it using the [aad oauth2grant list](./oauth2grant-list.md) command.
 
-If the `objectId` listed when using the [aad oauth2grant list](./oauth2grant-list.md) command has a minus sign ('-') prefix, you may receive an error indicating `--grantId` is missing.  To resolve this issue simply escape the leading '-'.  
+If the `objectId` listed when using the [aad oauth2grant list](./oauth2grant-list.md) command has a minus sign ('-') prefix, you may receive an error indicating `--grantId` is missing. To resolve this issue simply escape the leading '-'.  
 
 ```sh
 m365 aad oauth2grant set --grantId \\-Zc1JRY8REeLxmXz5KtixAYU3Q6noCBPlhwGiX7pxmU
@@ -38,4 +38,5 @@ m365 aad oauth2grant set --grantId YgA60KYa4UOPSdc-lpxYEnQkr8KVLDpCsOXkiV8i-ek -
 
 ## More information
 
-- Application and service principal objects in Azure Active Directory (Azure AD): [https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-application-objects](https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-application-objects)
+- Application and service principal objects in Azure Active Directory (Azure AD): [https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-application-objects](https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-application-objects)
+- Update a delegated permission grant (oAuth2PermissionGrant): [https://docs.microsoft.com/en-us/graph/api/oauth2permissiongrant-update?view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/oauth2permissiongrant-update?view=graph-rest-1.0)

package/docs/docs/cmd/aad/sp/sp-get.md

@@ -47,4 +47,5 @@ m365 aad sp get --objectId b2307a39-e878-458b-bc90-03bc578531dd
 
 ## More information
 
-- Application and service principal objects in Azure Active Directory (Azure AD): [https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-application-objects](https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-application-objects)
+- Application and service principal objects in Azure Active Directory (Azure AD): [https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-application-objects](https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-application-objects)
+- Get servicePrincipal: [https://docs.microsoft.com/en-us/graph/api/serviceprincipal-get?view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/serviceprincipal-get?view=graph-rest-1.0)

package/docs/docs/cmd/spfx/project/project-upgrade.md

@@ -32,7 +32,7 @@ m365 spfx project upgrade [options]
 
 ## Remarks
 
-The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.12.1). If you specify the `preview` option without a specific version, the command will upgrade your project to the latest preview version v1.13.0-beta.20.
+The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.13.0).
 
 This command doesn't change your project files. Instead, it gives you a report with all steps necessary to upgrade your project to the specified version of the SharePoint Framework. Changing project files is error-prone, especially when it comes to updating your solution's code. This is why at this moment, this command produces a report that you can use yourself to perform the necessary updates and verify that everything is working as expected.
 

package/docs/docs/cmd/spo/listitem/listitem-attachment-list.md

@@ -0,0 +1,39 @@
+# spo listitem attachment list
+
+Gets the attachments associated to a list item
+
+## Usage
+
+```sh
+m365 spo listitem attachment list [options]
+```
+
+## Options
+
+`-u, --webUrl <webUrl>`
+URL of the site from which the item should be retrieved
+
+`--listId [listId]`
+: ID of the list from which to retrieve the item. Specify listId or listTitle but not both
+
+`--listTitle [listTitle]`
+: Title of the list from which to retrieve the item. Specify listId or listTitle but not both
+
+`--itemId <itemId>`
+ID of the list item to in question
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Gets the attachments from list item with itemId _147_ in list with title _Demo List_ in site _https://contoso.sharepoint.com/sites/project-x_
+
+```sh
+m365 spo listitem attachment list --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle "Demo List" --itemId 147
+```
+
+Gets the attachments from list item with itemId _147_ in list with id _0cd891ef-afce-4e55-b836-fce03286cccf_ in site _https://contoso.sharepoint.com/sites/project-x_
+
+```sh
+m365 spo listitem attachment list --webUrl https://contoso.sharepoint.com/sites/project-x --listId 0cd891ef-afce-4e55-b836-fce03286cccf --itemId 147
+```