Adds command 'teams meeting transcript get'. Closes pnp#3908

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 [email protected] --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>

docs/src/config/sidebars.ts

@@ -4142,6 +4142,11 @@ const sidebars: SidebarsConfig = {
               label: 'meeting attendancereport list',
               id: 'cmd/teams/meeting/meeting-attendancereport-list'
             },
+            {
+              type: 'doc',
+              label: 'meeting transcript get',
+              id: 'cmd/teams/meeting/meeting-transcript-get'
+            },
             {
               type: 'doc',
               label: 'meeting transcript list',

src/m365/teams/MeetingTranscript.ts

@@ -0,0 +1,7 @@
+export interface MeetingTranscript {
+  id: string;
+  meetingId: string;
+  meetingOrganizerId: string;
+  transcriptContentUrl: string;
+  createdDateTime: Date;
+}

src/m365/teams/commands.ts

@@ -33,6 +33,7 @@ export default {
   MEETING_LIST: `${prefix} meeting list`,
   MEETING_ATTENDANCEREPORT_GET: `${prefix} meeting attendancereport get`,
   MEETING_ATTENDANCEREPORT_LIST: `${prefix} meeting attendancereport list`,
+  MEETING_TRANSCRIPT_GET: `${prefix} meeting transcript get`,
   MEETING_TRANSCRIPT_LIST: `${prefix} meeting transcript list`,
   MEMBERSETTINGS_LIST: `${prefix} membersettings list`,
   MEMBERSETTINGS_SET: `${prefix} membersettings set`,