@pnp/cli-microsoft365 10.0.0-beta.787c5f1 → 10.0.0-beta.7be7794

package/docs/docs/cmd/teams/meeting/meeting-transcript-get.mdx

@@ -0,0 +1,132 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# teams meeting transcript get
+
+Downloads a transcript for a given meeting
+
+## Usage
+
+```sh
+m365 teams meeting transcript get [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --userId [userId]`
+: The id of the user, omit to get meeting transcript for the currently signed-in user. Use either `id`, `userName` or `email`, but not multiple.
+
+`-n, --userName [userName]`
+: The name of the user, omit to get the meeting transcript for the currently signed-in user. Use either `id`, `userName` or `email`, but not multiple.
+
+`--email [email]`
+: The email of the user, omit to get the meeting transcript for the currently signed-in user. Use either `id`, `userName` or `email`, but not multiple.
+
+`-m, --meetingId <meetingId>`
+: The Id of the meeting.
+
+`-i, --id <id>`
+: The Id of the transcript.
+
+`-f, --outputFile [outputFile]`
+: Destination path for the report file.
+```
+
+<Global />
+
+## Examples
+
+Gets the specified transcript made for the current signed in user and Microsoft Teams meeting with given id.
+
+```sh
+m365 teams meeting transcript get --meetingId MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ --id MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4
+```
+
+Saves the specified transcript made for a given user and Microsoft Teams meeting with the given id.
+
+```sh
+m365 teams meeting transcript get --userName garthf@contoso.com --meetingId MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ --id MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4 --outputFile c:/Transcript.vtt
+```
+
+## Remarks
+
+:::warning
+
+This command is based on a Microsoft Graph API that is currently in preview and is subject to change once the API reached general availability.
+
+:::
+
+:::warning
+
+To run this command with application permissions, tenant administrators must create an application access policy and grant it to a user. This authorizes the app configured in the policy to fetch online meetings and/or online meeting artifacts on behalf of that user. For more details, click [here](https://learn.microsoft.com/graph/cloud-communication-online-meeting-application-access-policy).
+
+:::
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "MSMjMCMjNmU2OTc2OTUtZWNmMC00MTE2LWEyNzYtYjcyOTE5NTBiNzRj",
+    "meetingId": "MSplMTI1MWIxMC0xYmE0LTQ5ZTMtYjM1YS05MzNlM2YyMTc3MmIqMCoqMTk6bWVldGluZ19OREJpWVROa05XVXRaakptWlMwMFl6QTRMVGd3TlRRdE16WTNaR014T1Rjek1tUTBAdGhyZWFkLnYy",
+    "meetingOrganizerId": "e1251b10-1ba4-49e3-b35a-933e3f21772b",
+    "transcriptContentUrl": "https://graph.microsoft.com/beta/users/e1251b10-1ba4-49e3-b35a-933e3f21772b/onlineMeetings/MSplMTI1MWIxMC0xYmE0LTQ5ZTMtYjM1YS05MzNlM2YyMTc3MmIqMCoqMTk6bWVldGluZ19OREJpWVROa05XVXRaakptWlMwMFl6QTRMVGd3TlRRdE16WTNaR014T1Rjek1tUTBAdGhyZWFkLnYy/transcripts/MSMjMCMjNmU2OTc2OTUtZWNmMC00MTE2LWEyNzYtYjcyOTE5NTBiNzRj/content",
+    "createdDateTime": "2024-04-08T05:26:21.1936844Z",
+    "meetingOrganizer": {
+      "application": null,
+      "device": null,
+      "user": {
+        "id": "e1251b10-1ba4-49e3-b35a-933e3f21772b",
+        "displayName": null,
+        "userIdentityType": "aadUser",
+        "tenantId": "de348bc7-1aeb-4406-8cb3-97db021cadb4"
+      }
+    }
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  createdDateTime     : 2024-04-08T05:26:21.1936844Z
+  id                  : MSMjMCMjNmU2OTc2OTUtZWNmMC00MTE2LWEyNzYtYjcyOTE5NTBiNzRj
+  meetingId           : MSplMTI1MWIxMC0xYmE0LTQ5ZTMtYjM1YS05MzNlM2YyMTc3MmIqMCoqMTk6bWVldGluZ19OREJpWVROa05XVXRaakptWlMwMFl6QTRMVGd3TlRRdE16WTNaR014T1Rjek1tUTBAdGhyZWFkLnYy
+  meetingOrganizer    : {"application":null,"device":null,"user":{"id":"e1251b10-1ba4-49e3-b35a-933e3f21772b","displayName":null,"userIdentityType":"aadUser","tenantId":"de348bc7-1aeb-4406-8cb3-97db021cadb4"}}
+  meetingOrganizerId  : e1251b10-1ba4-49e3-b35a-933e3f21772b
+  transcriptContentUrl: https://graph.microsoft.com/beta/users/e1251b10-1ba4-49e3-b35a-933e3f21772b/onlineMeetings/MSplMTI1MWIxMC0xYmE0LTQ5ZTMtYjM1YS05MzNlM2YyMTc3MmIqMCoqMTk6bWVldGluZ19OREJpWVROa05XVXRaakptWlMwMFl6QTRMVGd3TlRRdE16WTNaR014T1Rjek1tUTBAdGhyZWFkLnYy/transcripts/MSMjMCMjNmU2OTc2OTUtZWNmMC00MTE2LWEyNzYtYjcyOTE5NTBiNzRj/content
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,meetingId,meetingOrganizerId,transcriptContentUrl,createdDateTime
+  MSMjMCMjNmU2OTc2OTUtZWNmMC00MTE2LWEyNzYtYjcyOTE5NTBiNzRj,MSplMTI1MWIxMC0xYmE0LTQ5ZTMtYjM1YS05MzNlM2YyMTc3MmIqMCoqMTk6bWVldGluZ19OREJpWVROa05XVXRaakptWlMwMFl6QTRMVGd3TlRRdE16WTNaR014T1Rjek1tUTBAdGhyZWFkLnYy,e1251b10-1ba4-49e3-b35a-933e3f21772b,https://graph.microsoft.com/beta/users/e1251b10-1ba4-49e3-b35a-933e3f21772b/onlineMeetings/MSplMTI1MWIxMC0xYmE0LTQ5ZTMtYjM1YS05MzNlM2YyMTc3MmIqMCoqMTk6bWVldGluZ19OREJpWVROa05XVXRaakptWlMwMFl6QTRMVGd3TlRRdE16WTNaR014T1Rjek1tUTBAdGhyZWFkLnYy/transcripts/MSMjMCMjNmU2OTc2OTUtZWNmMC00MTE2LWEyNzYtYjcyOTE5NTBiNzRj/content,2024-04-08T05:26:21.1936844Z
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # teams meeting transcript get --meetingId "MSplMTI1MWIxMC0xYmE0LTQ5ZTMtYjM1YS05MzNlM2YyMTc3MmIqMCoqMTk6bWVldGluZ19OREJpWVROa05XVXRaakptWlMwMFl6QTRMVGd3TlRRdE16WTNaR014T1Rjek1tUTBAdGhyZWFkLnYy" --id "MSMjMCMjNmU2OTc2OTUtZWNmMC00MTE2LWEyNzYtYjcyOTE5NTBiNzRj"
+
+  Date: 4/9/2024
+
+  ## MSMjMCMjNmU2OTc2OTUtZWNmMC00MTE2LWEyNzYtYjcyOTE5NTBiNzRj
+
+  Property | Value
+  ---------|-------
+  id | MSMjMCMjNmU2OTc2OTUtZWNmMC00MTE2LWEyNzYtYjcyOTE5NTBiNzRj
+  meetingId | MSplMTI1MWIxMC0xYmE0LTQ5ZTMtYjM1YS05MzNlM2YyMTc3MmIqMCoqMTk6bWVldGluZ19OREJpWVROa05XVXRaakptWlMwMFl6QTRMVGd3TlRRdE16WTNaR014T1Rjek1tUTBAdGhyZWFkLnYy
+  meetingOrganizerId | e1251b10-1ba4-49e3-b35a-933e3f21772b
+  transcriptContentUrl | https://graph.microsoft.com/beta/users/e1251b10-1ba4-49e3-b35a-933e3f21772b/onlineMeetings/MSplMTI1MWIxMC0xYmE0LTQ5ZTMtYjM1YS05MzNlM2YyMTc3MmIqMCoqMTk6bWVldGluZ19OREJpWVROa05XVXRaakptWlMwMFl6QTRMVGd3TlRRdE16WTNaR014T1Rjek1tUTBAdGhyZWFkLnYy/transcripts/MSMjMCMjNmU2OTc2OTUtZWNmMC00MTE2LWEyNzYtYjcyOTE5NTBiNzRj/content
+  createdDateTime | 2024-04-08T05:26:21.1936844Z
+  ```
+
+  </TabItem>
+</Tabs>

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

@@ -67,8 +67,7 @@ m365 teams tab list --teamId 00000000-0000-0000-0000-000000000000 --channelId 19
         "externalId": null,
         "displayName": "My Contoso Tab",
         "distributionMethod": "store"
-      },
-      "teamsAppTabId": "1542629c-01b3-4a6d-8f76-1938b779e48d"
+      }
     }
   ]
   ```

package/docs/docs/cmd/viva/engage/engage-community-list.mdx

@@ -0,0 +1,81 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# viva engage community list
+
+Lists all Viva Engage communities
+
+## Usage
+
+```sh
+m365 viva engage community list [options]
+```
+
+## Options
+
+<Global />
+
+## Examples
+
+Lists all Viva Engage communities
+
+```sh
+m365 viva engage community list
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "id": "eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI0NzY5MTM1ODIwOSJ9",
+      "displayName": "All Company",
+      "description": "This is the default group for everyone in the network",
+      "privacy": "public",
+      "groupId": "7c99afd7-9f3a-49e2-b105-4ee36314350c"
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  id                                                displayName  privacy
+  ------------------------------------------------  -----------  -------
+  eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI0NzY5MTM1ODIwOSJ9  All Company  public
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,displayName,description,privacy,groupId
+  eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI0NzY5MTM1ODIwOSJ9,All Company,This is the default group for everyone in the network,public,7c99afd7-9f3a-49e2-b105-4ee36314350c
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # viva engage community list
+
+  Date: 8/29/2024
+
+  ## All Company (eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI0NzY5MTM1ODIwOSJ9)
+
+  Property | Value
+  ---------|-------
+  id | eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiI0NzY5MTM1ODIwOSJ9
+  displayName | All Company
+  description | This is the default group for everyone in the network
+  privacy | public
+  groupId | 7c99afd7-9f3a-49e2-b105-4ee36314350c
+  ```
+  
+  </TabItem>
+</Tabs>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "10.0.0-beta.787c5f1",
+  "version": "10.0.0-beta.7be7794",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",

package/dist/m365/cli/commands/cli-reconsent.js

@@ -1,29 +0,0 @@
-import { cli } from '../../../cli/cli.js';
-import { settingsNames } from '../../../settingsNames.js';
-import { browserUtil } from '../../../utils/browserUtil.js';
-import AnonymousCommand from '../../base/AnonymousCommand.js';
-import commands from '../commands.js';
-class CliReconsentCommand extends AnonymousCommand {
-    get name() {
-        return commands.RECONSENT;
-    }
-    get description() {
-        return 'Returns URL to open in the browser to re-consent CLI for Microsoft 365 Microsoft Entra permissions';
-    }
-    async commandAction(logger) {
-        const url = `https://login.microsoftonline.com/${cli.getTenant()}/oauth2/authorize?client_id=${cli.getClientId()}&response_type=code&prompt=admin_consent`;
-        if (cli.getSettingWithDefaultValue(settingsNames.autoOpenLinksInBrowser, false) === false) {
-            await logger.log(`To re-consent your Microsoft Entra application, navigate in your web browser to ${url}.`);
-            return;
-        }
-        await logger.log(`Opening the following page in your browser: ${url}`);
-        try {
-            await browserUtil.open(url);
-        }
-        catch (err) {
-            this.handleRejectedODataJsonPromise(err);
-        }
-    }
-}
-export default new CliReconsentCommand();
-//# sourceMappingURL=cli-reconsent.js.map

package/docs/docs/cmd/cli/cli-reconsent.mdx

@@ -1,62 +0,0 @@
-import Global from '/docs/cmd/_global.mdx';
-import Tabs from '@theme/Tabs';
-import TabItem from '@theme/TabItem';
-
-# cli reconsent
-
-Returns URL to open in the browser to re-consent CLI for Microsoft 365 Microsoft Entra permissions
-
-## Usage
-
-```sh
-m365 cli reconsent [options]
-```
-
-## Options
-
-<Global />
-
-## Examples
-
-Get the URL to open in the browser to re-consent CLI for Microsoft 365 permissions
-
-```sh
-m365 cli reconsent
-```
-
-## Response
-
-<Tabs>
-  <TabItem value="JSON">
-
-  ```json
-  "To re-consent the PnP Microsoft 365 Management Shell Microsoft Entra application navigate in your web browser to https://login.microsoftonline.com/common/oauth2/authorize?client_id=31359c7f-bd7e-475c-86db-fdb8c937548e&response_type=code&prompt=admin_consent"
-  ```
-
-  </TabItem>
-  <TabItem value="Text">
-
-  ```text
-  To re-consent the PnP Microsoft 365 Management Shell Microsoft Entra application navigate in your web browser to https://login.microsoftonline.com/common/oauth2/authorize?client_id=31359c7f-bd7e-475c-86db-fdb8c937548e&response_type=code&prompt=admin_consent
-  ```
-
-  </TabItem>
-  <TabItem value="CSV">
-
-  ```csv
-  To re-consent the PnP Microsoft 365 Management Shell Microsoft Entra application navigate in your web browser to https://login.microsoftonline.com/common/oauth2/authorize?client_id=31359c7f-bd7e-475c-86db-fdb8c937548e&response_type=code&prompt=admin_consent
-  ```
-
-  </TabItem>
-  <TabItem value="Markdown">
-
-  ```md
-  To re-consent the PnP Microsoft 365 Management Shell Microsoft Entra application navigate in your web browser to https://login.microsoftonline.com/common/oauth2/authorize?client_id=31359c7f-bd7e-475c-86db-fdb8c937548e&response_type=code&prompt=admin_consent
-  ```
-
-  </TabItem>
-</Tabs>
-
-## More information
-
-- Re-consent the PnP Microsoft 365 Management Shell Microsoft Entra application: [https://pnp.github.io/cli-microsoft365/user-guide/connecting-microsoft-365/#re-consent-the-pnp-microsoft-365-management-shell-azure-ad-application](https://pnp.github.io/cli-microsoft365/user-guide/connecting-microsoft-365/#re-consent-the-pnp-microsoft-365-management-shell-azure-ad-application)

package/docs/docs/cmd/entra/group/group-user-add.mdx

@@ -1,62 +0,0 @@
-import Global from '/docs/cmd/_global.mdx';
-
-# entra group user add
-
-Adds a user to a Microsoft Entra ID group
-
-## Usage
-
-```sh
-m365 entra group user add [options]
-```
-
-## Options
-
-```md definition-list
-`-i, --groupId [groupId]`
-: The ID of the Microsoft Entra group. Specify `groupId` or `groupDisplayName` but not both.
-
-`-n, --groupDisplayName [groupDisplayName]`
-: The display name of the Microsoft Entra group. Specify `groupId` or `groupDisplayName` but not both.
-
-`--ids [ids]`
-: Microsoft Entra IDs of users. You can also pass a comma-separated list of IDs. Specify either `ids` or `userNames` but not both.
-
-`--userNames [userNames]`
-: The user principal names of users. You can also pass a comma-separated list of UPNs. Specify either `ids` or `userNames` but not both.
-
-`-r, --role <role>`
-: The role to be assigned to the new users. Valid values: `Owner`, `Member`.
-```
-
-<Global />
-
-## Examples
-
-Add a single user specified by ID as a member to a group specified by display name.
-
-```sh
-m365 entra group user add --groupDisplayName Developers --ids 098b9f52-f48c-4401-819f-29c33794c3f5 --role Member
-```
-
-Add multiple users specified by ID as members to a group specified by ID.
-
-```sh
-m365 entra group user add --groupId a03c0c35-ef9a-419b-8cab-f89e0a8d2d2a --ids "098b9f52-f48c-4401-819f-29c33794c3f5,f1e06e31-3abf-4746-83c2-1513d71f38b8" --role Member
-```
-
-Add a single user specified by UPN as an owner to a group specified by display name.
-
-```sh
-m365 entra group user add --groupDisplayName Developers --userNames john.doe@contoso.com --role Owner
-```
-
-Adds multiple users specified by UPN as owners to a group specified by ID.
-
-```sh
-m365 entra group user add --groupId a03c0c35-ef9a-419b-8cab-f89e0a8d2d2a --userNames "john.doe@contoso.com,adele.vance@contoso.com" --role Owner
-```
-
-## Response
-
-The command won't return a response on success.

package/docs/docs/cmd/entra/group/group-user-set.mdx

@@ -1,62 +0,0 @@
-import Global from '/docs/cmd/_global.mdx';
-
-# entra group user set
-
-Updates role of users in a Microsoft Entra ID group
-
-## Usage
-
-```sh
-m365 entra group user set [options]
-```
-
-## Options
-
-```md definition-list
-`-i, --groupId [groupId]`
-: The ID of the Entra ID group. Specify `groupId` or `groupDisplayName` but not both.
-
-`-n, --groupDisplayName [groupDisplayName]`
-: The display name of the Entra ID group. Specify `groupId` or `groupDisplayName` but not both.
-
-`--ids [ids]`
-: Comma-separated list of user IDs. Specify either `ids` or `userNames` but not both.
-
-`--userNames [userNames]`
-: The user principal names of users. You can also pass a comma-separated list of UPNs. Specify either `ids` or `userNames` but not both.
-
-`-r, --role <role>`
-: The new role to be assigned to the users. Valid values: `Owner`, `Member`.
-```
-
-<Global />
-
-## Examples
-
-Update a single user specified by ID to a member of a group specified by display name
-
-```sh
-m365 entra group user set --groupDisplayName Developers --ids 098b9f52-f48c-4401-819f-29c33794c3f5 --role Member
-```
-
-Update multiple users specified by ID to members of a group specified by ID
-
-```sh
-m365 entra group user set --groupId a03c0c35-ef9a-419b-8cab-f89e0a8d2d2a --ids "098b9f52-f48c-4401-819f-29c33794c3f5,f1e06e31-3abf-4746-83c2-1513d71f38b8" --role Member
-```
-
-Update a single user specified by UPN to an owner of a group specified by display name
-
-```sh
-m365 entra group user set --groupDisplayName Developers --userNames john.doe@contoso.com --role Owner
-```
-
-Update multiple users specified by UPN to owners of a group specified by ID
-
-```sh
-m365 entra group user set --groupId a03c0c35-ef9a-419b-8cab-f89e0a8d2d2a --userNames "john.doe@contoso.com,adele.vance@contoso.com" --role Owner
-```
-
-## Response
-
-The command won't return a response on success.