@pnp/cli-microsoft365 10.11.0-beta.5e075e5 → 10.11.0-beta.b1eeb91

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/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/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>