pnp / cli-microsoft365

Manage Microsoft 365 and SharePoint Framework projects on any platform
https://aka.ms/cli-m365
MIT License
896 stars 318 forks source link

New command: `m365 teams meeting transcript get` #3908

Open appieschot opened 1 year ago

appieschot commented 1 year ago

Usage

m365 teams meeting transcript get

Description

Download a transcript for a meeting

Options

Option Description
-u, --userId [userId] The id of the user, omit to get meeting transcript for current signed in user. Use either id, userName or email, not all.
-n, --userName [userName] The name of the user, omit to get meeting transcript for current signed in user. Use either id, userName or email, not all.
--email [email] The email of the user, omit to get meeting transcript reports for current signed in user. Use either id, userName or email, not all.
-m, --meetingId <meetingId> The Id of the meeting
-i, --id <id> The Id of the transcript
-f, --outputFile [outputFile] Path to the file where the report should be stored in

Examples

Gets the specified transcript made for the current signed in user and Microsoft Teams meeting with given id

m365 teams meeting transcript get --meetingId MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ --transcriptId MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4

Gets the specified transcript made for the garthf@contoso.com and Microsoft Teams meeting with given id

m365 teams meeting transcript get --userName garthf@contoso.com --meetingId MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ --transcriptId MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4

Additional Info

https://learn.microsoft.com/en-us/graph/api/calltranscript-get?view=graph-rest-beta&tabs=http

We will need a check to make sure userName is required when they are signed in with app permissions.

See m365 spo file get for saving of local files.

⚠️ Uses additional permissions, make sure to list them in PR OnlineMeetingArtifact.Read.All, OnlineMeetings.Read.All ⚠️ Add remark that the beta endpoint is subject to change

Jwaegebaert commented 1 year ago

I think we can change the option --transcriptId to -i, --id <id> and here the same remark about the beta endpoint 😄 Could we maybe combine --asFile with --path because, if I'm reading it correctly, they will always go together and asFile doen't require any input.

appieschot commented 1 year ago

Done, opening up

waldekmastykarz commented 1 year ago

What's the difference between email and userName? Aren't they the same?

appieschot commented 1 year ago

You can have several aliases for a upn or at least I assume is the way we inplantend it in Aad user get, will validate when back behind a desktop

nanddeepn commented 4 months ago

Can I work on it?

Adam-it commented 4 months ago

Can I work on it?

All yours 👍👏