@pnp/cli-microsoft365 5.0.0-beta.e93174a → 5.0.0-beta.ef2dfe7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (47) hide show
  1. package/.devcontainer/devcontainer.json +12 -9
  2. package/.eslintrc.js +1 -0
  3. package/.mocharc.json +9 -0
  4. package/README.md +2 -2
  5. package/dist/Command.js +1 -1
  6. package/dist/api.d.ts +11 -0
  7. package/dist/api.js +17 -0
  8. package/dist/cli/Cli.js +19 -4
  9. package/dist/m365/aad/commands/app/app-add.js +43 -7
  10. package/dist/m365/aad/commands/app/app-delete.js +123 -0
  11. package/dist/m365/aad/commands/app/app-get.js +56 -11
  12. package/dist/m365/aad/commands/app/app-set.js +98 -3
  13. package/dist/m365/aad/commands/group/group-list.js +14 -1
  14. package/dist/m365/aad/commands/o365group/o365group-conversation-list.js +41 -0
  15. package/dist/m365/aad/commands.js +2 -0
  16. package/dist/m365/outlook/commands/room/room-list.js +43 -0
  17. package/dist/m365/outlook/commands/roomlist/roomlist-list.js +25 -0
  18. package/dist/m365/outlook/commands.js +2 -0
  19. package/dist/m365/planner/commands/task/task-get.js +1 -1
  20. package/dist/m365/planner/commands/task/task-list.js +37 -7
  21. package/dist/m365/spfx/commands/project/project-upgrade/{upgrade-1.14.0-beta.5.js → upgrade-1.14.0.js} +25 -25
  22. package/dist/m365/spfx/commands/project/project-upgrade.js +13 -15
  23. package/dist/m365/spfx/commands/spfx-doctor.js +25 -6
  24. package/dist/m365/spo/commands/group/group-user-add.js +15 -8
  25. package/dist/m365/teams/commands/app/app-install.js +75 -21
  26. package/dist/m365/teams/commands/app/app-update.js +55 -12
  27. package/dist/m365/teams/commands/channel/channel-get.js +29 -7
  28. package/dist/m365/teams/commands/chat/chat-message-send.js +225 -0
  29. package/dist/m365/teams/commands.js +1 -0
  30. package/docs/docs/cmd/aad/app/app-delete.md +51 -0
  31. package/docs/docs/cmd/aad/app/app-get.md +12 -1
  32. package/docs/docs/cmd/aad/app/app-set.md +21 -0
  33. package/docs/docs/cmd/aad/group/group-list.md +9 -0
  34. package/docs/docs/cmd/aad/o365group/o365group-conversation-list.md +24 -0
  35. package/docs/docs/cmd/outlook/room/room-list.md +30 -0
  36. package/docs/docs/cmd/outlook/roomlist/roomlist-list.md +21 -0
  37. package/docs/docs/cmd/planner/task/task-get.md +5 -0
  38. package/docs/docs/cmd/planner/task/task-list.md +5 -0
  39. package/docs/docs/cmd/search/externalconnection/externalconnection-add.md +3 -3
  40. package/docs/docs/cmd/spfx/project/project-upgrade.md +8 -8
  41. package/docs/docs/cmd/spo/group/group-user-add.md +4 -0
  42. package/docs/docs/cmd/teams/app/app-install.md +22 -4
  43. package/docs/docs/cmd/teams/app/app-update.md +12 -3
  44. package/docs/docs/cmd/teams/channel/channel-get.md +10 -1
  45. package/docs/docs/cmd/teams/chat/chat-message-send.md +55 -0
  46. package/npm-shrinkwrap.json +838 -767
  47. package/package.json +23 -18
@@ -1,6 +1,6 @@
1
1
  # teams app install
2
2
 
3
- Installs an app from the catalog to a Microsoft Teams team
3
+ Installs a Microsoft Teams team app from the catalog in the specified team or for the specified user
4
4
 
5
5
  ## Usage
6
6
 
@@ -13,14 +13,20 @@ m365 teams app install [options]
13
13
  `--appId <appId>`
14
14
  : The ID of the app to install
15
15
 
16
- `--teamId <teamId>`
16
+ `--teamId [teamId]`
17
17
  : The ID of the Microsoft Teams team to which to install the app
18
18
 
19
+ `--userId [userId]`
20
+ : The ID of the user for who to install the app. Specify either `userId` or `userName` to install a personal app for a user.
21
+
22
+ `--userName [userName]`
23
+ : The UPN of the user for who to install the app. Specify either `userId` or `userName` to install a personal app for a user.
24
+
19
25
  --8<-- "docs/cmd/_global.md"
20
26
 
21
27
  ## Remarks
22
28
 
23
- The `appId` has to be the ID of the app from the Microsoft Teams App Catalog. Do not use the ID from the manifest of the zip app package. Use the [teams app list](./app-list.md) command to get this ID.
29
+ The `appId` has to be the ID of the app from the Microsoft Teams App Catalog. Do not use the ID from the manifest of the zip app package. Use the [teams app list](./app-list.md) command to get this ID instead.
24
30
 
25
31
  ## Examples
26
32
 
@@ -28,4 +34,16 @@ Install an app from the catalog in a Microsoft Teams team
28
34
 
29
35
  ```sh
30
36
  m365 teams app install --appId 4440558e-8c73-4597-abc7-3644a64c4bce --teamId 2609af39-7775-4f94-a3dc-0dd67657e900
31
- ```
37
+ ```
38
+
39
+ Install a personal app for the user specified using their user name
40
+
41
+ ```sh
42
+ m365 teams app install --appId 4440558e-8c73-4597-abc7-3644a64c4bce --userName steve@contoso.com
43
+ ```
44
+
45
+ Install a personal app for the user specified using their ID
46
+
47
+ ```sh
48
+ m365 teams app install --appId 4440558e-8c73-4597-abc7-3644a64c4bce --userId 2609af39-7775-4f94-a3dc-0dd67657e900
49
+ ```
@@ -10,8 +10,11 @@ m365 teams app update [options]
10
10
 
11
11
  ## Options
12
12
 
13
- `-i, --id <id>`
14
- : ID of the app to update
13
+ `-i, --id [id]`
14
+ : ID of the app to update. Specify either id or name, but not both
15
+
16
+ `-n, --name [name]`
17
+ : The display name of the app to update. Specify either id or name, but not both
15
18
 
16
19
  `-p, --filePath <filePath>`
17
20
  : Absolute or relative path to the Teams manifest zip file to update in the app catalog
@@ -28,4 +31,10 @@ Update the Teams app with ID _83cece1e-938d-44a1-8b86-918cf6151957_ from file _t
28
31
 
29
32
  ```sh
30
33
  m365 teams app update --id 83cece1e-938d-44a1-8b86-918cf6151957 --filePath ./teams-manifest.zip
31
- ```
34
+ ```
35
+
36
+ Update the Teams app with name _Test app_ from file _teams-manifest.zip_
37
+
38
+ ```sh
39
+ m365 teams app update --name "Test app" --filePath ./teams-manifest.zip
40
+ ```
@@ -22,6 +22,9 @@ m365 teams channel get [options]
22
22
  `--channelName [channelName]`
23
23
  : The display name of the channel for which to retrieve more information. Specify either channelId or channelName but not both
24
24
 
25
+ `--primary`
26
+ : Gets the default channel, General, of a team. If specified, channelId or channelName are not needed
27
+
25
28
  --8<-- "docs/cmd/_global.md"
26
29
 
27
30
  ## Examples
@@ -36,4 +39,10 @@ Get information about Microsoft Teams team channel with name _Channel Name_
36
39
 
37
40
  ```sh
38
41
  m365 teams channel get --teamName "Team Name" --channelName "Channel Name"
39
- ```
42
+ ```
43
+
44
+ Get information about Microsoft Teams team primary channel , i.e. General
45
+
46
+ ```sh
47
+ m365 teams channel get --teamName "Team Name" --primary
48
+ ```
@@ -0,0 +1,55 @@
1
+ # teams chat message send
2
+
3
+ Sends a chat message to a Microsoft Teams chat conversation.
4
+
5
+ ## Usage
6
+
7
+ ```sh
8
+ m365 teams chat message send [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ `--chatId [chatId]`
14
+ : The ID of the chat conversation. Specify either `chatId`, `chatName` or `userEmails`, but not multiple.
15
+
16
+ `--chatName [chatName]`
17
+ : The display name of the chat conversation. Specify either `chatId`, `chatName` or `userEmails`, but not multiple.
18
+
19
+ `-e, --userEmails [userEmails]`
20
+ : A comma-separated list of one or more e-mail addresses. Specify either `chatId`, `chatName` or `userEmails`, but not multiple.
21
+
22
+ `-m, --message <message>`
23
+ : The message to send
24
+
25
+ --8<-- "docs/cmd/_global.md"
26
+
27
+ ## Remarks
28
+
29
+ A new chat conversation will be created if no existing conversation with the participants specified with emails is found.
30
+
31
+ ## Examples
32
+
33
+ Send a message to a Microsoft Teams chat conversation by id
34
+
35
+ ```sh
36
+ m365 teams chat message send --chatId 19:2da4c29f6d7041eca70b638b43d45437@thread.v2
37
+ ```
38
+
39
+ Send a message to a single person
40
+
41
+ ```sh
42
+ m365 teams chat message send --userEmails alexw@contoso.com
43
+ ```
44
+
45
+ Send a message to a group of people
46
+
47
+ ```sh
48
+ m365 teams chat message send --userEmails alexw@contoso.com,meganb@contoso.com
49
+ ```
50
+
51
+ Send a message to a chat conversation finding it by display name
52
+
53
+ ```sh
54
+ m365 teams chat message send --chatName "Just a conversation"
55
+ ```