@pnp/cli-microsoft365 10.10.0 → 10.11.0-beta.b1eeb91

package/dist/m365/todo/commands/list/list-get.js

@@ -6,9 +6,9 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var _TodoListGetCommand_instances, _TodoListGetCommand_initTelemetry, _TodoListGetCommand_initOptions, _TodoListGetCommand_initOptionSets;
 import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
-import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
+import GraphDelegatedCommand from '../../../base/GraphDelegatedCommand.js';
 import commands from '../../commands.js';
-class TodoListGetCommand extends DelegatedGraphCommand {
+class TodoListGetCommand extends GraphDelegatedCommand {
     get name() {
         return commands.LIST_GET;
     }

package/dist/m365/todo/commands/list/list-list.js

@@ -1,7 +1,7 @@
 import { odata } from '../../../../utils/odata.js';
-import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
+import GraphDelegatedCommand from '../../../base/GraphDelegatedCommand.js';
 import commands from '../../commands.js';
-class TodoListListCommand extends DelegatedGraphCommand {
+class TodoListListCommand extends GraphDelegatedCommand {
     get name() {
         return commands.LIST_LIST;
     }

package/dist/m365/todo/commands/list/list-remove.js

@@ -7,9 +7,9 @@ var _TodoListRemoveCommand_instances, _TodoListRemoveCommand_initTelemetry, _Tod
 import { cli } from '../../../../cli/cli.js';
 import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
-import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
+import GraphDelegatedCommand from '../../../base/GraphDelegatedCommand.js';
 import commands from '../../commands.js';
-class TodoListRemoveCommand extends DelegatedGraphCommand {
+class TodoListRemoveCommand extends GraphDelegatedCommand {
     get name() {
         return commands.LIST_REMOVE;
     }

package/dist/m365/todo/commands/list/list-set.js

@@ -6,9 +6,9 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var _TodoListSetCommand_instances, _TodoListSetCommand_initTelemetry, _TodoListSetCommand_initOptions, _TodoListSetCommand_initOptionSets;
 import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
-import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
+import GraphDelegatedCommand from '../../../base/GraphDelegatedCommand.js';
 import commands from '../../commands.js';
-class TodoListSetCommand extends DelegatedGraphCommand {
+class TodoListSetCommand extends GraphDelegatedCommand {
     get name() {
         return commands.LIST_SET;
     }

package/dist/m365/todo/commands/task/task-add.js

@@ -7,9 +7,9 @@ var _TodoTaskAddCommand_instances, _a, _TodoTaskAddCommand_initTelemetry, _TodoT
 import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
 import { validation } from '../../../../utils/validation.js';
-import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
+import GraphDelegatedCommand from '../../../base/GraphDelegatedCommand.js';
 import commands from '../../commands.js';
-class TodoTaskAddCommand extends DelegatedGraphCommand {
+class TodoTaskAddCommand extends GraphDelegatedCommand {
     get name() {
         return commands.TASK_ADD;
     }

package/dist/m365/todo/commands/task/task-get.js

@@ -7,9 +7,9 @@ var _TodoTaskGetCommand_instances, _TodoTaskGetCommand_initTelemetry, _TodoTaskG
 import { cli } from '../../../../cli/cli.js';
 import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
-import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
+import GraphDelegatedCommand from '../../../base/GraphDelegatedCommand.js';
 import commands from '../../commands.js';
-class TodoTaskGetCommand extends DelegatedGraphCommand {
+class TodoTaskGetCommand extends GraphDelegatedCommand {
     get name() {
         return commands.TASK_GET;
     }

package/dist/m365/todo/commands/task/task-list.js

@@ -8,9 +8,9 @@ import { cli } from '../../../../cli/cli.js';
 import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
 import { odata } from '../../../../utils/odata.js';
-import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
+import GraphDelegatedCommand from '../../../base/GraphDelegatedCommand.js';
 import commands from '../../commands.js';
-class TodoTaskListCommand extends DelegatedGraphCommand {
+class TodoTaskListCommand extends GraphDelegatedCommand {
     get name() {
         return commands.TASK_LIST;
     }

package/dist/m365/todo/commands/task/task-remove.js

@@ -7,9 +7,9 @@ var _TodoTaskRemoveCommand_instances, _TodoTaskRemoveCommand_initTelemetry, _Tod
 import { cli } from '../../../../cli/cli.js';
 import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
-import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
+import GraphDelegatedCommand from '../../../base/GraphDelegatedCommand.js';
 import commands from '../../commands.js';
-class TodoTaskRemoveCommand extends DelegatedGraphCommand {
+class TodoTaskRemoveCommand extends GraphDelegatedCommand {
     get name() {
         return commands.TASK_REMOVE;
     }

package/dist/m365/todo/commands/task/task-set.js

@@ -7,9 +7,9 @@ var _TodoTaskSetCommand_instances, _TodoTaskSetCommand_initTelemetry, _TodoTaskS
 import request from '../../../../request.js';
 import { formatting } from '../../../../utils/formatting.js';
 import { validation } from '../../../../utils/validation.js';
-import DelegatedGraphCommand from '../../../base/DelegatedGraphCommand.js';
+import GraphDelegatedCommand from '../../../base/GraphDelegatedCommand.js';
 import commands from '../../commands.js';
-class TodoTaskSetCommand extends DelegatedGraphCommand {
+class TodoTaskSetCommand extends GraphDelegatedCommand {
     get name() {
         return commands.TASK_SET;
     }

package/dist/utils/accessToken.js

@@ -84,17 +84,21 @@ export const accessToken = {
         return { header, payload };
     },
     /**
-     * Asserts the presence of a delegated access token.
+     * Asserts the presence of a delegated or application-only access token.
      * @throws {CommandError} Will throw an error if the access token is not available.
-     * @throws {CommandError} Will throw an error if the access token is an application-only access token.
+     * @throws {CommandError} Will throw an error if the access token type is not correct.
      */
-    assertDelegatedAccessToken() {
+    assertAccessTokenType(type) {
         const accessToken = auth?.connection?.accessTokens?.[auth.defaultResource]?.accessToken;
         if (!accessToken) {
             throw new CommandError('No access token found.');
         }
-        if (this.isAppOnlyAccessToken(accessToken)) {
-            throw new CommandError('This command does not support application-only permissions.');
+        const isAppAccessToken = this.isAppOnlyAccessToken(accessToken);
+        if (type === 'delegated' && isAppAccessToken) {
+            throw new CommandError('This command requires delegated permissions.');
+        }
+        if (type === 'application' && !isAppAccessToken) {
+            throw new CommandError('This command requires application-only permissions.');
         }
     }
 };

package/dist/utils/entraApp.js

@@ -308,6 +308,21 @@ export const entraApp = {
             return await cli.handleMultipleResultsFound(`Multiple apps with name '${appName}' found in Microsoft Entra ID.`, resultAsKeyValuePair);
         }
         return apps[0];
+    },
+    async getAppRegistrationByObjectId(objectId, properties) {
+        let url = `https://graph.microsoft.com/v1.0/applications/${objectId}`;
+        if (properties) {
+            url += `?$select=${properties.join(',')}`;
+        }
+        const requestOptions = {
+            url: url,
+            headers: {
+                accept: 'application/json;odata.metadata=none'
+            },
+            responseType: 'json'
+        };
+        const app = await request.get(requestOptions);
+        return app;
     }
 };
 //# sourceMappingURL=entraApp.js.map

package/docs/docs/cmd/cli/app/app-add.mdx

@@ -0,0 +1,50 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# cli app add
+
+Create a new app registration to use for the CLI for Microsoft 365
+
+## Usage
+
+```sh
+m365 cli app add [options]
+```
+
+## Options
+
+```md definition-list
+`-n, --name [name]`
+: Name of the app registration. Defaults to CLI for M365
+
+`-s, --scopes [scopes]`
+: Which scopes should be added? Valid values are: `minimal`, `all`, or a list of scopes. Defaults to `minimal`.
+
+`--saveToConfig`
+: Save the app registration info to the CLI config. This way the new app registration will be used as the default app registration to sign in.
+```
+
+<Global />
+
+## Examples
+
+Create a new app registration to use for CLI for Microsoft 365
+
+```sh
+m365 cli app add
+```
+
+Create a new app registration with all permission scopes and a custom name
+
+```sh
+m365 cli app add --name "Contoso CLI app" --scopes all
+```
+
+Create a new app registration with self-defined scopes
+
+```sh
+m365 cli app add --scopes "https://graph.microsoft.com/User.Read,https://graph.microsoft.com/Group.Read.All"
+```
+
+## Response
+
+The command won't return a response on success

package/docs/docs/cmd/spe/container/container-recyclebinitem-restore.mdx

@@ -0,0 +1,53 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# spe container recyclebinitem restore
+
+Restores a deleted container
+
+## Usage
+
+```sh
+m365 spe container recyclebinitem restore [options]
+```
+
+## Options
+
+```md definition-list
+`--id [id]`
+: The container id. Specify either `id` or `name` but not both.
+
+`--name [name]`
+: The display name of the Container. Specify either `id` or `name` but not both.
+
+`--containerTypeId [containerTypeId]`
+: The container type ID of the container instance. Use either `containerTypeId` or `containerTypeName` but not both.
+
+`--containerTypeName [containerTypeName]`
+: The container type name of the container instance. Use either `containerTypeId` or `containerTypeName` but not both.
+```
+
+<Global />
+
+## Examples
+
+Restore a deleted container by ID.
+
+```sh
+m365 spe container recyclebinitem restore --id "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z"
+```
+
+Restore a deleted container by using its name and container type ID.
+
+```sh
+m365 spe container recyclebinitem restore --containerTypeId "91710488-5756-407f-9046-fbe5f0b4de73" --name "Invoices"
+```
+
+Restore a deleted container by using its name and container type name.
+
+```sh
+m365 spe container recyclebinitem restore --containerTypeName "My container type name" --name "Invoices"
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/site/site-appcatalog-list.mdx

@@ -14,6 +14,11 @@ m365 spo site appcatalog list [options]
 
 ## Options
 
+```md definition-list
+`--excludeDeletedSites [excludeDeletedSites]`
+: Exclude site collections that are no longer active
+```
+
 <Global />
 
 ## Remarks
@@ -32,6 +37,12 @@ List all site collection app catalogs within the tenant
 m365 spo site appcatalog list
 ```
 
+List all site collection app catalogs within the tenant and exclude deleted sites.
+
+```sh
+m365 spo site appcatalog list --excludeDeletedSites
+```
+
 ## Response
 
 <Tabs>

package/docs/docs/cmd/spo/tenant/tenant-site-unarchive.mdx

@@ -34,7 +34,7 @@ To use this command, you must be a Global or SharePoint administrator.
 
 :::warning
 
-If a site remains archived for more than **seven days**, the reactivation fee will be calculated based on the entire storage capacity of the site.
+If a site has been archived for more than **seven days**, reactivating it triggers a 120-day cooldown period during which you can't archive the site again.
 
 :::
 

package/docs/docs/cmd/teams/callrecord/callrecord-list.mdx

@@ -0,0 +1,173 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# teams callrecord list
+
+Lists all Teams calls within the tenant
+
+## Usage
+
+```sh
+m365 teams callrecord list [options]
+```
+
+## Options
+
+```md definition-list
+`--userId [userId]`
+: Filters call records to only include those where the user participated. Use the Entra user ID of the user. Specify either `userId` or `userName` but not both.
+
+`--userName [userName]`
+: Filters call records to only include those where the user participated. Use the UPN of the user. Specify either `userId` or `userName` but not both.
+
+`--startDateTime [startDateTime]`
+: Only show calls that started after this time. Defaults to 30 days ago.
+
+`--endDateTime [endDateTime]`
+: Only show calls that started before this time (exclusive). Defaults to now.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+This command only supports application permissions. Use scope `CallRecords.Read.All`.
+
+:::
+
+:::note
+
+It is only possible to retrieve call records from the past 30 days.
+
+:::
+
+## Examples
+
+Get all call records from the past 30 days.
+
+```sh
+m365 teams callrecord list
+```
+
+Get all call records where a specific user participated in.
+
+```sh
+m365 teams callrecord list --userName "john.doe@contoso.com"
+```
+
+Get all call records that started within a specific timeframe.
+
+```sh
+m365 teams callrecord list --startDateTime "2025-05-1T00:00:00Z" --endDateTime "2025-05-14T00:00:00Z"
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "id": "145ae53b-7781-47c4-a5f7-b0e043012624",
+      "version": 1,
+      "type": "peerToPeer",
+      "modalities": [
+        "audio"
+      ],
+      "lastModifiedDateTime": "2025-05-29T17:41:33.5066667Z",
+      "startDateTime": "2025-05-29T17:27:20.428943Z",
+      "endDateTime": "2025-05-29T17:37:20.428943Z",
+      "joinWebUrl": "",
+      "organizer": {
+        "acsUser": null,
+        "spoolUser": null,
+        "phone": null,
+        "guest": null,
+        "encrypted": null,
+        "onPremises": null,
+        "acsApplicationInstance": null,
+        "spoolApplicationInstance": null,
+        "applicationInstance": null,
+        "application": null,
+        "device": null,
+        "user": {
+          "id": "b51efc8b-0adf-486c-ba54-b239ffa7c1f9",
+          "displayName": "John Doe",
+          "tenantId": "de5e90f2-9a07-4ed1-b903-f801afa7b1fd"
+        }
+      },
+      "participants": [],
+      "organizer_v2": {
+        "id": "b51efc8b-0adf-486c-ba54-b239ffa7c1f9",
+        "identity": {
+          "endpointType": null,
+          "acsUser": null,
+          "spoolUser": null,
+          "phone": null,
+          "guest": null,
+          "encrypted": null,
+          "onPremises": null,
+          "acsApplicationInstance": null,
+          "spoolApplicationInstance": null,
+          "applicationInstance": null,
+          "application": null,
+          "device": null,
+          "azureCommunicationServicesUser": null,
+          "assertedIdentity": null,
+          "user": {
+            "id": "b51efc8b-0adf-486c-ba54-b239ffa7c1f9",
+            "displayName": "John Doe",
+            "tenantId": "de5e90f2-9a07-4ed1-b903-f801afa7b1fd",
+            "userPrincipalName": "john.doe@contoso.com"
+          }
+        },
+        "administrativeUnitInfos": []
+      }
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  id                                    type        startDateTime                 endDateTime
+  ------------------------------------  ----------  ----------------------------  ----------------------------
+  145ae53b-7781-47c4-a5f7-b0e043012624  peerToPeer  2025-05-29T17:27:20.428943Z   2025-05-29T17:37:20.428943Z
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,version,type,lastModifiedDateTime,startDateTime,endDateTime,joinWebUrl
+  145ae53b-7781-47c4-a5f7-b0e043012624,1,peerToPeer,2025-05-29T17:41:33.5066667Z,2025-05-29T17:27:20.428943Z,2025-05-29T17:37:20.428943Z,
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # teams callrecord list
+
+  Date: 03/06/2025
+
+  ## 145ae53b-7781-47c4-a5f7-b0e043012624
+
+  Property | Value
+  ---------|-------
+  id | 145ae53b-7781-47c4-a5f7-b0e043012624
+  version | 1
+  type | peerToPeer
+  lastModifiedDateTime | 2025-05-29T17:41:33.5066667Z
+  startDateTime | 2025-05-29T17:27:20.428943Z
+  endDateTime | 2025-05-29T17:37:20.428943Z
+  joinWebUrl |
+  ```
+
+  </TabItem>
+</Tabs>