cli-microsoft365 icon indicating copy to clipboard operation
cli-microsoft365 copied to clipboard

New command: `m365 teams meeting transcript get`

Open appieschot opened this issue 3 years ago • 6 comments

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 [email protected] and Microsoft Teams meeting with given id

m365 teams meeting transcript get --userName [email protected] --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

appieschot avatar Oct 25 '22 10:10 appieschot

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.

Jwaegebaert avatar Oct 25 '22 13:10 Jwaegebaert

Done, opening up

appieschot avatar Oct 28 '22 10:10 appieschot

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

waldekmastykarz avatar Oct 28 '22 18:10 waldekmastykarz

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

appieschot avatar Oct 28 '22 18:10 appieschot

Can I work on it?

nanddeepn avatar Apr 06 '24 15:04 nanddeepn

Can I work on it?

All yours 👍👏

Adam-it avatar Apr 06 '24 16:04 Adam-it

@appieschot I have a follow up question. What is the difference between userName and email

if we specify it like this in the example ... --userName [email protected] ... it seems that there is no difference between userName and email 🤷‍♂️? Maybe we could leave just one property. As I saw in @nanddeepn PR we are even validating this the same way.

@pnp/cli-for-microsoft-365-maintainers any feed on the above 👆. Am I missing something here?

Adam-it avatar Sep 17 '24 07:09 Adam-it

We have a few commands where we make the distinction between userName and e-mail. But in most, we don't. For me it doesn't matter that much, I can live with it whether we add it or not. I can imagine that in some use cases, email might be useful, for example for guests, where the email is [email protected] and the UPN is something like john.doe_hotmail_com#EXT#@contoso.onmicrosoft.com. But personally, if I were to write a script, I'd use UPNs.

milanholemans avatar Sep 17 '24 08:09 milanholemans

ok. thanks @milanholemans for the ASAP answer 👍. Lets leave it then 👍

Adam-it avatar Sep 17 '24 08:09 Adam-it

Indeed, the rationale was to make life a little bit easier for guests with weird UPN's.

appieschot avatar Sep 18 '24 06:09 appieschot