@pnp/cli-microsoft365 6.0.0-beta.a0a813f → 6.0.0-beta.a2ec37b

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 (146) hide show
  1. package/dist/Command.js +16 -2
  2. package/dist/m365/aad/commands/app/app-list.js +38 -0
  3. package/dist/m365/aad/commands/user/user-guest-add.js +103 -0
  4. package/dist/m365/aad/commands.js +2 -0
  5. package/dist/m365/commands/status.js +6 -1
  6. package/dist/m365/outlook/commands/mail/mail-send.js +54 -30
  7. package/dist/m365/outlook/commands/message/message-get.js +97 -0
  8. package/dist/m365/outlook/commands.js +1 -0
  9. package/dist/m365/planner/commands/plan/plan-get.js +5 -20
  10. package/dist/m365/pp/commands/card/card-get.js +110 -0
  11. package/dist/m365/pp/commands/card/card-remove.js +130 -0
  12. package/dist/m365/pp/commands/gateway/gateway-get.js +70 -0
  13. package/dist/m365/pp/commands/solution/solution-get.js +117 -0
  14. package/dist/m365/pp/commands.js +4 -0
  15. package/dist/m365/spfx/commands/project/project-doctor.js +4 -1
  16. package/dist/m365/spfx/commands/project/project-externalize.js +4 -1
  17. package/dist/m365/spfx/commands/project/project-upgrade/rules/FN010001_YORC_version.js +2 -1
  18. package/dist/m365/spfx/commands/project/project-upgrade/rules/FN010002_YORC_isCreatingSolution.js +2 -1
  19. package/dist/m365/spfx/commands/project/project-upgrade/rules/FN010003_YORC_packageManager.js +2 -1
  20. package/dist/m365/spfx/commands/project/project-upgrade/rules/FN010004_YORC_componentType.js +2 -1
  21. package/dist/m365/spfx/commands/project/project-upgrade/rules/FN010005_YORC_environment.js +2 -1
  22. package/dist/m365/spfx/commands/project/project-upgrade/rules/FN010006_YORC_framework.js +3 -2
  23. package/dist/m365/spfx/commands/project/project-upgrade/rules/FN010007_YORC_isDomainIsolated.js +2 -1
  24. package/dist/m365/spfx/commands/project/project-upgrade/rules/FN010008_YORC_nodeVersion.js +2 -1
  25. package/dist/m365/spfx/commands/project/project-upgrade/rules/FN010009_YORC_sdkVersions_microsoft_graph_client.js +56 -0
  26. package/dist/m365/spfx/commands/project/project-upgrade/rules/FN010010_YORC_sdkVersions_teams_js.js +56 -0
  27. package/dist/m365/spfx/commands/project/project-upgrade/{upgrade-1.16.0-beta.1.js → upgrade-1.16.0-beta.2.js} +44 -28
  28. package/dist/m365/spfx/commands/project/project-upgrade.js +1 -1
  29. package/dist/m365/spfx/commands/spfx-doctor.js +3 -3
  30. package/dist/m365/spo/commands/contenttype/contenttype-add.js +82 -43
  31. package/dist/m365/spo/commands/contenttype/contenttype-field-remove.js +53 -21
  32. package/dist/m365/spo/commands/contenttype/contenttype-get.js +35 -14
  33. package/dist/m365/spo/commands/field/field-add.js +26 -1
  34. package/dist/m365/spo/commands/field/field-set.js +23 -13
  35. package/dist/m365/spo/commands/folder/folder-list.js +35 -12
  36. package/dist/m365/spo/commands/folder/folder-roleinheritance-break.js +11 -1
  37. package/dist/m365/spo/commands/folder/folder-roleinheritance-reset.js +12 -1
  38. package/dist/m365/spo/commands/list/list-roleassignment-add.js +1 -1
  39. package/dist/m365/spo/commands/list/list-webhook-get.js +2 -3
  40. package/dist/m365/spo/commands/list/list-webhook-list.js +4 -28
  41. package/dist/m365/spo/commands/list/list-webhook-set.js +11 -12
  42. package/dist/m365/spo/commands/listitem/listitem-add.js +24 -14
  43. package/dist/m365/spo/commands/listitem/listitem-attachment-list.js +18 -8
  44. package/dist/m365/spo/commands/listitem/listitem-get.js +18 -8
  45. package/dist/m365/spo/commands/listitem/listitem-isrecord.js +20 -10
  46. package/dist/m365/spo/commands/listitem/listitem-list.js +21 -11
  47. package/dist/m365/spo/commands/listitem/listitem-record-declare.js +19 -12
  48. package/dist/m365/spo/commands/listitem/listitem-record-undeclare.js +24 -21
  49. package/dist/m365/spo/commands/listitem/listitem-remove.js +19 -11
  50. package/dist/m365/spo/commands/listitem/listitem-roleassignment-add.js +239 -0
  51. package/dist/m365/spo/commands/listitem/listitem-roleinheritance-break.js +13 -5
  52. package/dist/m365/spo/commands/listitem/listitem-roleinheritance-reset.js +13 -5
  53. package/dist/m365/spo/commands/listitem/listitem-set.js +52 -44
  54. package/dist/m365/spo/commands/roledefinition/roledefinition-list.js +15 -2
  55. package/dist/m365/spo/commands/site/site-add.js +4 -11
  56. package/dist/m365/spo/commands/{hubsite/hubsite-connect.js → site/site-hubsite-connect.js} +10 -10
  57. package/dist/m365/spo/commands/{hubsite/hubsite-disconnect.js → site/site-hubsite-disconnect.js} +13 -13
  58. package/dist/m365/spo/commands/{hubsite/hubsite-theme-sync.js → site/site-hubsite-theme-sync.js} +11 -11
  59. package/dist/m365/spo/commands/web/web-roleinheritance-break.js +100 -0
  60. package/dist/m365/spo/commands.js +5 -3
  61. package/dist/m365/teams/commands/team/team-set.js +0 -7
  62. package/dist/m365/todo/commands/list/list-get.js +89 -0
  63. package/dist/m365/todo/commands/task/task-add.js +55 -3
  64. package/dist/m365/todo/commands/task/task-get.js +108 -0
  65. package/dist/m365/todo/commands.js +2 -0
  66. package/docs/docs/_clisettings.md +18 -0
  67. package/docs/docs/cmd/aad/app/app-list.md +149 -0
  68. package/docs/docs/cmd/aad/user/user-guest-add.md +107 -0
  69. package/docs/docs/cmd/adaptivecard/adaptivecard-send.md +3 -0
  70. package/docs/docs/cmd/graph/schemaextension/schemaextension-add.md +4 -11
  71. package/docs/docs/cmd/graph/schemaextension/schemaextension-set.md +4 -10
  72. package/docs/docs/cmd/outlook/mail/mail-send.md +13 -0
  73. package/docs/docs/cmd/outlook/message/message-get.md +48 -0
  74. package/docs/docs/cmd/planner/bucket/bucket-add.md +29 -0
  75. package/docs/docs/cmd/planner/bucket/bucket-get.md +29 -0
  76. package/docs/docs/cmd/planner/bucket/bucket-list.md +30 -0
  77. package/docs/docs/cmd/planner/bucket/bucket-remove.md +4 -0
  78. package/docs/docs/cmd/planner/bucket/bucket-set.md +4 -0
  79. package/docs/docs/cmd/planner/plan/plan-add.md +123 -0
  80. package/docs/docs/cmd/planner/plan/plan-get.md +75 -6
  81. package/docs/docs/cmd/planner/plan/plan-list.md +45 -0
  82. package/docs/docs/cmd/planner/plan/plan-remove.md +4 -0
  83. package/docs/docs/cmd/planner/task/task-get.md +0 -3
  84. package/docs/docs/cmd/pp/card/card-get.md +51 -0
  85. package/docs/docs/cmd/pp/card/card-remove.md +82 -0
  86. package/docs/docs/cmd/pp/gateway/gateway-get.md +24 -0
  87. package/docs/docs/cmd/pp/solution/solution-get.md +51 -0
  88. package/docs/docs/cmd/spfx/project/project-rename.md +1 -14
  89. package/docs/docs/cmd/spfx/project/project-upgrade.md +1 -1
  90. package/docs/docs/cmd/spo/contenttype/contenttype-add.md +20 -2
  91. package/docs/docs/cmd/spo/contenttype/contenttype-field-remove.md +22 -4
  92. package/docs/docs/cmd/spo/contenttype/contenttype-get.md +21 -3
  93. package/docs/docs/cmd/spo/customaction/customaction-add.md +3 -0
  94. package/docs/docs/cmd/spo/customaction/customaction-set.md +3 -2
  95. package/docs/docs/cmd/spo/field/field-add.md +20 -2
  96. package/docs/docs/cmd/spo/field/field-set.md +15 -3
  97. package/docs/docs/cmd/spo/folder/folder-list.md +45 -0
  98. package/docs/docs/cmd/spo/folder/folder-roleinheritance-break.md +6 -0
  99. package/docs/docs/cmd/spo/folder/folder-roleinheritance-reset.md +6 -0
  100. package/docs/docs/cmd/spo/hubsite/hubsite-register.md +2 -2
  101. package/docs/docs/cmd/spo/hubsite/hubsite-unregister.md +2 -2
  102. package/docs/docs/cmd/spo/list/list-view-set.md +14 -3
  103. package/docs/docs/cmd/spo/list/list-webhook-get.md +1 -1
  104. package/docs/docs/cmd/spo/list/list-webhook-list.md +3 -9
  105. package/docs/docs/cmd/spo/list/list-webhook-set.md +11 -4
  106. package/docs/docs/cmd/spo/listitem/listitem-add.md +11 -2
  107. package/docs/docs/cmd/spo/listitem/listitem-attachment-list.md +11 -2
  108. package/docs/docs/cmd/spo/listitem/listitem-get.md +11 -2
  109. package/docs/docs/cmd/spo/listitem/listitem-isrecord.md +12 -2
  110. package/docs/docs/cmd/spo/listitem/listitem-list.md +10 -1
  111. package/docs/docs/cmd/spo/listitem/listitem-record-declare.md +7 -4
  112. package/docs/docs/cmd/spo/listitem/listitem-record-undeclare.md +11 -2
  113. package/docs/docs/cmd/spo/listitem/listitem-remove.md +11 -2
  114. package/docs/docs/cmd/spo/listitem/listitem-roleassignment-add.md +81 -0
  115. package/docs/docs/cmd/spo/listitem/listitem-roleinheritance-break.md +7 -4
  116. package/docs/docs/cmd/spo/listitem/listitem-roleinheritance-reset.md +8 -5
  117. package/docs/docs/cmd/spo/listitem/listitem-set.md +7 -4
  118. package/docs/docs/cmd/spo/page/page-clientsidewebpart-add.md +5 -10
  119. package/docs/docs/cmd/spo/page/page-control-set.md +2 -1
  120. package/docs/docs/cmd/spo/site/site-add.md +0 -3
  121. package/docs/docs/cmd/spo/{hubsite/hubsite-connect.md → site/site-hubsite-connect.md} +4 -4
  122. package/docs/docs/cmd/spo/{hubsite/hubsite-disconnect.md → site/site-hubsite-disconnect.md} +7 -7
  123. package/docs/docs/cmd/spo/{hubsite/hubsite-theme-sync.md → site/site-hubsite-theme-sync.md} +5 -5
  124. package/docs/docs/cmd/spo/term/term-add.md +5 -0
  125. package/docs/docs/cmd/spo/term/term-set-add.md +6 -1
  126. package/docs/docs/cmd/spo/web/web-roleinheritance-break.md +44 -0
  127. package/docs/docs/cmd/teams/team/team-clone.md +0 -3
  128. package/docs/docs/cmd/teams/team/team-set.md +0 -3
  129. package/docs/docs/cmd/tenant/id/id-get.md +20 -0
  130. package/docs/docs/cmd/tenant/report/report-activeusercounts.md +35 -0
  131. package/docs/docs/cmd/tenant/report/report-activeuserdetail.md +49 -0
  132. package/docs/docs/cmd/tenant/report/report-office365activationcounts.md +32 -0
  133. package/docs/docs/cmd/tenant/report/report-office365activationsusercounts.md +30 -0
  134. package/docs/docs/cmd/tenant/report/report-office365activationsuserdetail.md +36 -0
  135. package/docs/docs/cmd/tenant/report/report-servicesusercounts.md +41 -0
  136. package/docs/docs/cmd/tenant/security/security-alerts-list.md +105 -0
  137. package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-health-get.md +87 -0
  138. package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-health-list.md +91 -0
  139. package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-healthissue-get.md +62 -0
  140. package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-healthissue-list.md +51 -0
  141. package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-message-get.md +64 -0
  142. package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-message-list.md +52 -0
  143. package/docs/docs/cmd/todo/list/list-get.md +61 -0
  144. package/docs/docs/cmd/todo/task/task-add.md +32 -5
  145. package/docs/docs/cmd/todo/task/task-get.md +75 -0
  146. package/package.json +12 -6
@@ -3,10 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
3
3
  const prefix = 'todo';
4
4
  exports.default = {
5
5
  LIST_ADD: `${prefix} list add`,
6
+ LIST_GET: `${prefix} list get`,
6
7
  LIST_LIST: `${prefix} list list`,
7
8
  LIST_REMOVE: `${prefix} list remove`,
8
9
  LIST_SET: `${prefix} list set`,
9
10
  TASK_ADD: `${prefix} task add`,
11
+ TASK_GET: `${prefix} task get`,
10
12
  TASK_LIST: `${prefix} task list`,
11
13
  TASK_REMOVE: `${prefix} task remove`,
12
14
  TASK_SET: `${prefix} task set`
@@ -0,0 +1,18 @@
1
+ ## Available settings
2
+
3
+ Following is the list of configuration settings available in CLI for Microsoft 365.
4
+
5
+ Setting name|Definition|Default value
6
+ ------------|----------|-------------
7
+ `autoOpenLinksInBrowser`|Automatically open the browser for all commands which return a url and expect the user to copy paste this to the browser. For example when logging in, using `m365 login` in device code mode.|`false`
8
+ `copyDeviceCodeToClipboard`|Automatically copy the device code to the clipboard when running `m365 login` command in device code mode|`false`
9
+ `csvEscape`|Single character used for escaping; only apply to characters matching the quote and the escape options|`"`
10
+ `csvHeader`|Display the column names on the first line|`true`
11
+ `csvQuote`|The quote characters surrounding a field. An empty quote value will preserve the original field, whether it contains quotation marks or not.|` `
12
+ `csvQuoted`|Quote all the non-empty fields even if not required|`false`
13
+ `csvQuotedEmpty`|Quote empty strings and overrides quoted_string on empty strings when defined|`false`
14
+ `errorOutput`|Defines if errors should be written to `stdout` or `stderr`|`stderr`
15
+ `output`|Defines the default output when issuing a command|`json`
16
+ `printErrorsAsPlainText`|When output mode is set to `json`, print error messages as plain-text rather than JSON|`true`
17
+ `prompt`|Prompts for missing values in required options|`false`
18
+ `showHelpOnFailure`|Automatically display help when executing a command failed|`true`
@@ -0,0 +1,149 @@
1
+ # aad app list
2
+
3
+ Retrieves a list of Azure AD app registrations
4
+
5
+ ## Usage
6
+
7
+ ```sh
8
+ m365 aad app list [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ --8<-- "docs/cmd/_global.md"
14
+
15
+ ## Examples
16
+
17
+ Retrieve a list of Azure AD app registrations
18
+
19
+ ```sh
20
+ m365 aad app list
21
+ ```
22
+
23
+ ## Response
24
+
25
+ === "JSON"
26
+ ```json
27
+ [
28
+ {
29
+ "id": "ff2798f7-1c7a-4607-8a7b-3d5e0c18c756",
30
+ "deletedDateTime": null,
31
+ "appId": "61ed4fab-a861-4307-bb87-a6a53dbe39f5",
32
+ "applicationTemplateId": null,
33
+ "disabledByMicrosoftStatus": null,
34
+ "createdDateTime": "2021-03-16T14:51:28Z",
35
+ "displayName": "TestAppPermissions",
36
+ "description": null,
37
+ "groupMembershipClaims": null,
38
+ "identifierUris": [],
39
+ "isDeviceOnlyAuthSupported": null,
40
+ "isFallbackPublicClient": null,
41
+ "notes": null,
42
+ "publisherDomain": "Contoso.onmicrosoft.com",
43
+ "serviceManagementReference": null,
44
+ "signInAudience": "AzureADMyOrg",
45
+ "tags": [],
46
+ "tokenEncryptionKeyId": null,
47
+ "samlMetadataUrl": null,
48
+ "defaultRedirectUri": null,
49
+ "certification": null,
50
+ "optionalClaims": null,
51
+ "addIns": [],
52
+ "api": {
53
+ "acceptMappedClaims": null,
54
+ "knownClientApplications": [],
55
+ "requestedAccessTokenVersion": null,
56
+ "oauth2PermissionScopes": [],
57
+ "preAuthorizedApplications": []
58
+ },
59
+ "appRoles": [],
60
+ "info": {
61
+ "logoUrl": null,
62
+ "marketingUrl": null,
63
+ "privacyStatementUrl": null,
64
+ "supportUrl": null,
65
+ "termsOfServiceUrl": null
66
+ },
67
+ "keyCredentials": [
68
+ {
69
+ "customKeyIdentifier": "7D20AB8DD09B653E9A3880F9046314B76917EF62",
70
+ "displayName": "CN=TestCertificate",
71
+ "endDateTime": "2022-01-01T00:00:00Z",
72
+ "key": null,
73
+ "keyId": "8928a06f-fa2d-4d92-98c3-b0f544804f64",
74
+ "startDateTime": "2020-01-01T00:00:00Z",
75
+ "type": "AsymmetricX509Cert",
76
+ "usage": "Verify"
77
+ }
78
+ ],
79
+ "parentalControlSettings": {
80
+ "countriesBlockedForMinors": [],
81
+ "legalAgeGroupRule": "Allow"
82
+ },
83
+ "passwordCredentials": [
84
+ {
85
+ "customKeyIdentifier": null,
86
+ "displayName": "TestSecret",
87
+ "endDateTime": "2022-03-16T14:58:45.602Z",
88
+ "hint": "~03",
89
+ "keyId": "714c9628-4bb8-4f08-84b4-7fd8d7a7b8c5",
90
+ "secretText": null,
91
+ "startDateTime": "2021-03-16T14:59:07.642Z"
92
+ }
93
+ ],
94
+ "publicClient": {
95
+ "redirectUris": []
96
+ },
97
+ "requiredResourceAccess": [
98
+ {
99
+ "resourceAppId": "00000003-0000-0000-c000-000000000000",
100
+ "resourceAccess": [
101
+ {
102
+ "id": "e1fe6dd8-ba31-4d61-89e7-88639da4683d",
103
+ "type": "Scope"
104
+ },
105
+ {
106
+ "id": "18228521-a591-40f1-b215-5fad4488c117",
107
+ "type": "Role"
108
+ },
109
+ {
110
+ "id": "09850681-111b-4a89-9bed-3f2cae46d706",
111
+ "type": "Role"
112
+ }
113
+ ]
114
+ }
115
+ ],
116
+ "verifiedPublisher": {
117
+ "displayName": null,
118
+ "verifiedPublisherId": null,
119
+ "addedDateTime": null
120
+ },
121
+ "web": {
122
+ "homePageUrl": null,
123
+ "logoutUrl": null,
124
+ "redirectUris": [],
125
+ "implicitGrantSettings": {
126
+ "enableAccessTokenIssuance": false,
127
+ "enableIdTokenIssuance": false
128
+ },
129
+ "redirectUriSettings": []
130
+ },
131
+ "spa": {
132
+ "redirectUris": []
133
+ }
134
+ }
135
+ ]
136
+ ```
137
+
138
+ === "Text"
139
+ ```text
140
+ appId id displayName signInAudience
141
+ ------------------------------------ ------------------------------------ ----------------------------------------------------------------------- ----------------------------------
142
+ 61ed4fab-a861-4307-bb87-a6a53dbe39f5 ff2798f7-1c7a-4607-8a7b-3d5e0c18c756 TestAppPermissions AzureADMyOrg
143
+ ```
144
+
145
+ === "CSV"
146
+ ```csv
147
+ appId,id,displayName,signInAudience
148
+ 61ed4fab-a861-4307-bb87-a6a53dbe39f5,ff2798f7-1c7a-4607-8a7b-3d5e0c18c756,TestAppPermissions,AzureADMyOrg
149
+ ```
@@ -0,0 +1,107 @@
1
+ # aad user guest add
2
+
3
+ Invite an external user to the organization
4
+
5
+ ## Usage
6
+
7
+ ```sh
8
+ m365 aad user guest add [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ `--emailAddress <emailAddress>`
14
+ : The email address of the user.
15
+
16
+ `--displayName [displayName]`
17
+ : The display name of the user.
18
+
19
+ `--inviteRedirectUrl [inviteRedirectUrl]`
20
+ : The URL the user should be redirected to once the invitation is redeemed. If not specified, default URL https://myapplications.microsoft.com will be set.
21
+
22
+ `--welcomeMessage [welcomeMessage]`
23
+ : Personal welcome message which will be added to the email along with the default email.
24
+
25
+ `--ccRecipients [ccRecipients]`
26
+ : Additional recipients the invitation message should be sent to. Currently only 1 additional recipient is supported.
27
+
28
+ `--messageLanguage [messageLanguage]`
29
+ : The language you want to send the default message in. The language format should be in [ISO 639](https://learn.microsoft.com/en-us/openspecs/office_standards/ms-oi29500/ed06cf15-306c-43be-9053-ca81ca51e656). The default is `en-US`.
30
+
31
+ `--sendInvitationMessage`
32
+ : Indicates whether an email should be sent to the user.
33
+
34
+ --8<-- "docs/cmd/_global.md"
35
+
36
+ ## Examples
37
+
38
+ Invite a user via email and set the display name
39
+
40
+ ```sh
41
+ m365 aad user guest add --emailAddress john.doe@contoso.com --displayName "John Doe" --sendInvitationMessage
42
+ ```
43
+
44
+ Invite a user with a custom email and custom redirect url
45
+
46
+ ```sh
47
+ m365 aad user guest add --emailAddress john.doe@contoso.com --welcomeMessage "Hi John, welcome to the organization!" --sendInvitationMessage
48
+ ```
49
+
50
+ Invite a user and send an invitation mail in Dutch
51
+
52
+ ```sh
53
+ m365 aad user guest add --emailAddress john.doe@contoso.com --messageLanguage nl-BE --sendInvitationMessage
54
+ ```
55
+
56
+ ## Response
57
+
58
+ === "JSON"
59
+
60
+ ```json
61
+ {
62
+ "id": "35f7f726-c541-4aef-a64e-a7b6868fe47f",
63
+ "inviteRedeemUrl": "https://login.microsoftonline.com/redeem?rd=https%3a%2f%2finvitations.microsoft.com%2fredeem%2f%3ftenant%3db373bc30-03b3-49bc-be72-9dd3e9027da8%26user%3d35f7f726-c541-4aef-a64e-a7b6868fe47f%26ticket%3dCjO3u3ZpQF2uthfZETfZ8gURzod5egvYI0uhaSN1Loo%25253d%26ver%3d2.0",
64
+ "invitedUserDisplayName": "John Doe",
65
+ "invitedUserType": "Guest",
66
+ "invitedUserEmailAddress": "john.doe@contoso.com",
67
+ "sendInvitationMessage": true,
68
+ "resetRedemption": false,
69
+ "inviteRedirectUrl": "https://myapplications.microsoft.com/",
70
+ "status": "PendingAcceptance",
71
+ "invitedUserMessageInfo": {
72
+ "messageLanguage": "en-US",
73
+ "customizedMessageBody": "Hi John, welcome to the organization!",
74
+ "ccRecipients": [
75
+ {
76
+ "emailAddress": {
77
+ "name": null,
78
+ "address": "maria.jones@contoso.com"
79
+ }
80
+ }
81
+ ]
82
+ },
83
+ "invitedUser": {
84
+ "id": "5257b5b2-4056-4a45-a05e-df5c92d53e6e"
85
+ }
86
+ }
87
+ ```
88
+
89
+ === "Text"
90
+
91
+ ```text
92
+ id : 35f7f726-c541-4aef-a64e-a7b6868fe47f
93
+ inviteRedeemUrl : https://login.microsoftonline.com/redeem?rd=https%3a%2f%2finvitations.microsoft.com%2fredeem%2f%3ftenant%3db373bc30-03b3-49bc-be72-9dd3e9027da8%26user%3d35f7f726-c541-4aef-a64e-a7b6868fe47f%26ticket%3dCjO3u3ZpQF2uthfZETfZ8gURzod5egvYI0uhaSN1Loo%25253d%26ver%3d2.0
94
+ invitedUserDisplayName : John Doe
95
+ invitedUserEmailAddress: liwidit556@adroh.com
96
+ invitedUserType : Guest
97
+ resetRedemption : false
98
+ sendInvitationMessage : true
99
+ status : PendingAcceptance
100
+ ```
101
+
102
+ === "CSV"
103
+
104
+ ```csv
105
+ id,inviteRedeemUrl,invitedUserDisplayName,invitedUserEmailAddress,invitedUserType,resetRedemption,sendInvitationMessage,status
106
+ 35f7f726-c541-4aef-a64e-a7b6868fe47f,https://login.microsoftonline.com/redeem?rd=https%3a%2f%2finvitations.microsoft.com%2fredeem%2f%3ftenant%3db373bc30-03b3-49bc-be72-9dd3e9027da8%26user%3d35f7f726-c541-4aef-a64e-a7b6868fe47f%26ticket%3dCjO3u3ZpQF2uthfZETfZ8gURzod5egvYI0uhaSN1Loo%25253d%26ver%3d2.0,John Doe,liwidit556@adroh.com,Guest,,1,PendingAcceptance
107
+ ```
@@ -43,6 +43,9 @@ The predefined card is automatically adjusted based on which options have been s
43
43
 
44
44
  If your custom card is a card template (card with placeholders like `${title}`), you can fill it with data either by specifying the complete data object using the `cardData` option, or by passing any number of arbitrary options that will be mapped onto the card. The arbitrary properties should not match any of the global options like `output`, `query`, `debug`, etc. Data options like `title`, `description`, `imageUrl` and `actionUrl` will be mapped onto the card as well.
45
45
 
46
+ !!! warning "Escaping JSON in PowerShell"
47
+ When using the `--card` and `--cardData` options it's possible to enter a JSON string. In PowerShell 5 to 7.2 [specific escaping rules](./../../user-guide/using-cli.md#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../user-guide/using-cli.md#passing-complex-content-into-cli-options) instead.
48
+
46
49
  ## Examples
47
50
 
48
51
  Send a predefined adaptive card with just title
@@ -43,26 +43,19 @@ The schema extension owner is the ID of the Azure AD application that is the own
43
43
 
44
44
  The target types are the set of Microsoft Graph resource types (that support schema extensions) that this schema extension definition can be applied to. This option is specified as a comma-separated list
45
45
 
46
- When specifying the JSON string of properties on Windows, you have to escape double quotes in a specific way. Considering the following value for the _properties_ option: `{"Foo":"Bar"}`,
47
- you should specify the value as <code>\`"{""Foo"":""Bar""}"\`</code>.
48
- In addition, when using PowerShell, you should use the `--%` argument.
46
+ !!! warning "Escaping JSON in PowerShell"
47
+ When using the `--properties` option it's possible to enter a JSON string. In PowerShell 5 to 7.2 [specific escaping rules](./../../user-guide/using-cli.md#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../user-guide/using-cli.md#passing-complex-content-into-cli-options) instead.
49
48
 
50
49
  ## Examples
51
50
 
52
51
  Create a schema extension
53
52
 
54
53
  ```sh
55
- m365 graph schemaextension add --id MySchemaExtension --description "My Schema Extension" --targetTypes Group --owner 62375ab9-6b52-47ed-826b-58e47e0e304b --properties \`"[{""name"":""myProp1"",""type"":""Integer""},{""name"":""myProp2"",""type"":""String""}]\`
54
+ m365 graph schemaextension add --id MySchemaExtension --description "My Schema Extension" --targetTypes Group --owner 62375ab9-6b52-47ed-826b-58e47e0e304b --properties '[{"name":"myProp1","type":"Integer"},{"name":"myProp2","type":"String"}]'
56
55
  ```
57
56
 
58
57
  Create a schema extension with a verified domain
59
58
 
60
59
  ```sh
61
- m365 graph schemaextension add --id contoso_MySchemaExtension --description "My Schema Extension" --targetTypes Group --owner 62375ab9-6b52-47ed-826b-58e47e0e304b --properties \`"[{""name"":""myProp1"",""type"":""Integer""},{""name"":""myProp2"",""type"":""String""}]\`
62
- ```
63
-
64
- Create a schema extension in PowerShell
65
-
66
- ```PowerShell
67
- graph schemaextension add --id contoso_MySchemaExtension --description "My Schema Extension" --targetTypes Group --owner "62375ab9-6b52-47ed-826b-58e47e0e304b" --properties --% \`"[{""name"":""myProp1"",""type"":""Integer""},{""name"":""myProp2"",""type"":""String""}]\`
60
+ m365 graph schemaextension add --id contoso_MySchemaExtension --description "My Schema Extension" --targetTypes Group --owner 62375ab9-6b52-47ed-826b-58e47e0e304b --properties '[{"name":"myProp1","type":"Integer"},{"name":"myProp2","type":"String"}]'
68
61
  ```
@@ -35,9 +35,9 @@ m365 graph schemaextension set [options]
35
35
  The lifecycle state of the schema extension. The initial state upon creation is `InDevelopment`.
36
36
  Possible states transitions are from `InDevelopment` to `Available` and `Available` to `Deprecated`.
37
37
  The target types are the set of Microsoft Graph resource types (that support schema extensions) that this schema extension definition can be applied to. This option is specified as a comma-separated list.
38
- When specifying the JSON string of properties on Windows, you have to escape double quotes in a specific way. Considering the following value for the _properties_ option: `{"Foo":"Bar"}`,
39
- you should specify the value as <code>\`"{""Foo"":""Bar""}"\`</code>.
40
- In addition, when using PowerShell, you should use the `--%` argument.
38
+
39
+ !!! warning "Escaping JSON in PowerShell"
40
+ When using the `--properties` option it's possible to enter a JSON string. In PowerShell 5 to 7.2 [specific escaping rules](./../../user-guide/using-cli.md#escaping-double-quotes-in-powershell) apply due to an issue. Remember that you can also use [file tokens](./../../user-guide/using-cli.md#passing-complex-content-into-cli-options) instead.
41
41
 
42
42
  ## Examples
43
43
 
@@ -50,13 +50,7 @@ m365 graph schemaextension set --id MySchemaExtension --owner 62375ab9-6b52-47ed
50
50
  Update the target types and properties of a schema extension
51
51
 
52
52
  ```sh
53
- m365 graph schemaextension set --id contoso_MySchemaExtension --owner 62375ab9-6b52-47ed-826b-58e47e0e304b --targetTypes "Group,User" --properties \`"[{""name"":""myProp1"",""type"":""Integer""},{""name"":""myProp2"",""type"":""String""}]\`
54
- ```
55
-
56
- Update the properties of a schema extension in PowerShell
57
-
58
- ```PowerShell
59
- graph schemaextension set --id contoso_MySchemaExtension --owner 62375ab9-6b52-47ed-826b-58e47e0e304b --properties --% \`"[{""name"":""myProp1"",""type"":""Integer""},{""name"":""myProp2"",""type"":""String""}]\`
53
+ m365 graph schemaextension set --id contoso_MySchemaExtension --owner 62375ab9-6b52-47ed-826b-58e47e0e304b --targetTypes "Group,User" --properties '[{"name":"myProp1","type":"Integer"},{"name":"myProp2","type":"String"}]'
60
54
  ```
61
55
 
62
56
  Change the status of a schema extension to 'Available'
@@ -37,6 +37,9 @@ m365 outlook mail send [options]
37
37
  `--importance [importance]`
38
38
  : The importance of the message. Available options: `low`, `normal` or `high`. Default is `normal`.
39
39
 
40
+ `--attachment [attachment]`
41
+ : Path to the file that will be added as attachment to the email. This option can be used multiple times to attach multiple attachments.
42
+
40
43
  `--saveToSentItems [saveToSentItems]`
41
44
  : Save email in the sent items folder. Default `true`.
42
45
 
@@ -44,6 +47,10 @@ m365 outlook mail send [options]
44
47
 
45
48
  ## Remarks
46
49
 
50
+ ### Attachments
51
+
52
+ When using the `attachment` option, note that the total size of all attachment files cannot exceed 3 MB.
53
+
47
54
  ### If you are connected using app only authentication
48
55
 
49
56
  - Always specify a user id or upn in the `--sender` option. The email will be sent as if it came from the specified user, and can optionally be saved in the sent folder of that user account.
@@ -110,3 +117,9 @@ Send an email with cc and bcc recipients marked as important
110
117
  ```sh
111
118
  m365 outlook mail send --to chris@contoso.com --cc claire@contoso.com --bcc randy@contoso.com --subject "DG2000 Data Sheets" --bodyContents "The latest data sheets are in the team site" --importance high
112
119
  ```
120
+
121
+ Send an email with multiple attachments
122
+
123
+ ```sh
124
+ m365 outlook mail send --to chris@contoso.com --subject "Monthly reports" --bodyContents "Here are the reports of this month." --attachment "C:/Reports/File1.jpg" --attachment "C:/Reports/File2.docx" --attachment "C:/Reports/File3.xlsx"
125
+ ```
@@ -0,0 +1,48 @@
1
+ # outlook message get
2
+
3
+ Retrieves specified message
4
+
5
+ ## Usage
6
+
7
+ ```sh
8
+ m365 outlook message get [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ `-i, --id <id>`
14
+ : ID of the message
15
+
16
+ `--userId [userId]`
17
+ : ID of the user from which to retrieve the message. Specify either `userId` or `userPrincipalName`, but not both. This option is required when using application permissions.
18
+
19
+ `--userPrincipalName [userPrincipalName]`
20
+ : UPN of the user from which to retrieve the message Specify either `userId` or `userPrincipalName`, but not both. This option is required when using application permissions.
21
+
22
+ --8<-- "docs/cmd/_global.md"
23
+
24
+ ## Examples
25
+
26
+ Get a specific message using delegated permissions
27
+
28
+ ```sh
29
+ m365 outlook message get --id AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OABGAAAAAAAiQ8W967B7TKBjgx9rVEURBwAiIsqMbYjsT5e-T7KzowPTAAAAAAEMAAAiIsqMbYjsT5e-T7KzowPTAALvuv07AAA=
30
+ ```
31
+
32
+ Get a specific message using delegated permissions from a shared mailbox
33
+
34
+ ```sh
35
+ m365 outlook message get --id AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OABGAAAAAAAiQ8W967B7TKBjgx9rVEURBwAiIsqMbYjsT5e-T7KzowPTAAAAAAEMAAAiIsqMbYjsT5e-T7KzowPTAALvuv07AAA= --userPrincipalName sharedmailbox@tenant.com
36
+ ```
37
+
38
+ Get a specific message from a specific user retrieved by user ID using application permissions
39
+
40
+ ```sh
41
+ m365 outlook message get --id AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OABGAAAAAAAiQ8W967B7TKBjgx9rVEURBwAiIsqMbYjsT5e-T7KzowPTAAAAAAEMAAAiIsqMbYjsT5e-T7KzowPTAALvuv07AAA= --userId 6799fd1a-723b-4eb7-8e52-41ae530274ca
42
+ ```
43
+
44
+ Get a specific message from a specific user retrieved by user principal name using application permissions
45
+
46
+ ```sh
47
+ m365 outlook message get --id AAMkAGVmMDEzMTM4LTZmYWUtNDdkNC1hMDZiLTU1OGY5OTZhYmY4OABGAAAAAAAiQ8W967B7TKBjgx9rVEURBwAiIsqMbYjsT5e-T7KzowPTAAAAAAEMAAAiIsqMbYjsT5e-T7KzowPTAALvuv07AAA= --userPrincipalName user@tenant.com
48
+ ```
@@ -43,3 +43,32 @@ Adds a Microsoft Planner bucket with the name _My Planner Bucket_ for plan with
43
43
  ```sh
44
44
  m365 planner bucket add --name "My Planner Bucket" --planTitle "My Planner Plan" --ownerGroupName "My Planner Group"
45
45
  ```
46
+
47
+ ## Response
48
+
49
+ === "JSON"
50
+
51
+ ```json
52
+ {
53
+ "name": "My Planner Bucket",
54
+ "planId": "xqQg5FS2LkCp935s-FIFm2QAFkHM",
55
+ "orderHint": "8585363889524958496",
56
+ "id": "ttEB_Uj690STdR3GC1MIDZgANq1U"
57
+ }
58
+ ```
59
+
60
+ === "Text"
61
+
62
+ ```text
63
+ id : ttEB_Uj690STdR3GC1MIDZgANq1U
64
+ name : My Planner Bucket
65
+ orderHint: 8585363889524958496
66
+ planId : xqQg5FS2LkCp935s-FIFm2QAFkHM
67
+ ```
68
+
69
+ === "CSV"
70
+
71
+ ```csv
72
+ id,name,planId,orderHint
73
+ ttEB_Uj690STdR3GC1MIDZgANq1U,My Planner Bucket,xqQg5FS2LkCp935s-FIFm2QAFkHM,8585363889524958496
74
+ ```
@@ -55,3 +55,32 @@ Gets the Microsoft Planner bucket in the Plan _My Plan_ owned by groupId ee0f40f
55
55
  ```sh
56
56
  m365 planner bucket get --name "Planner Bucket A" --planTitle "My Plan" --ownerGroupId "ee0f40fc-b2f7-45c7-b62d-11b90dd2ea8e"
57
57
  ```
58
+
59
+ ## Response
60
+
61
+ === "JSON"
62
+
63
+ ```json
64
+ {
65
+ "name": "My Planner Bucket",
66
+ "planId": "xqQg5FS2LkCp935s-FIFm2QAFkHM",
67
+ "orderHint": "8585363889524958496",
68
+ "id": "ttEB_Uj690STdR3GC1MIDZgANq1U"
69
+ }
70
+ ```
71
+
72
+ === "Text"
73
+
74
+ ```text
75
+ id : ttEB_Uj690STdR3GC1MIDZgANq1U
76
+ name : My Planner Bucket
77
+ orderHint: 8585363889524958496
78
+ planId : xqQg5FS2LkCp935s-FIFm2QAFkHM
79
+ ```
80
+
81
+ === "CSV"
82
+
83
+ ```csv
84
+ id,name,planId,orderHint
85
+ ttEB_Uj690STdR3GC1MIDZgANq1U,My Planner Bucket,xqQg5FS2LkCp935s-FIFm2QAFkHM,8585363889524958496
86
+ ```
@@ -37,3 +37,33 @@ Lists the Microsoft Planner buckets in the Plan _My Plan_ owned by group _My Gro
37
37
  ```sh
38
38
  m365 planner bucket list --planTitle "My Plan" --ownerGroupName "My Group"
39
39
  ```
40
+
41
+ ## Response
42
+
43
+ === "JSON"
44
+
45
+ ```json
46
+ [
47
+ {
48
+ "name": "My Planner Bucket",
49
+ "planId": "xqQg5FS2LkCp935s-FIFm2QAFkHM",
50
+ "orderHint": "8585363889524958496",
51
+ "id": "ttEB_Uj690STdR3GC1MIDZgANq1U"
52
+ }
53
+ ]
54
+ ```
55
+
56
+ === "Text"
57
+
58
+ ```text
59
+ id name planId orderHint
60
+ ---------------------------- ----------------- ---------------------------- -------------------
61
+ ttEB_Uj690STdR3GC1MIDZgANq1U My Planner Bucket xqQg5FS2LkCp935s-FIFm2QAFkHM 8585363889524958496
62
+ ```
63
+
64
+ === "CSV"
65
+
66
+ ```csv
67
+ id,name,planId,orderHint
68
+ ttEB_Uj690STdR3GC1MIDZgANq1U,My Planner Bucket,xqQg5FS2LkCp935s-FIFm2QAFkHM,8585363889524958496
69
+ ```
@@ -58,3 +58,7 @@ Removes the Microsoft Planner bucket with name _My Bucket_ in the Plan _My Plan_
58
58
  ```sh
59
59
  m365 planner bucket remove --name "My Bucket" --planTitle "My Plan" --ownerGroupName "My Group"
60
60
  ```
61
+
62
+ ## Response
63
+
64
+ The command won't return a response on success.
@@ -55,3 +55,7 @@ Updates the Microsoft Planner bucket named _My Bucket_ in the Plan _My Plan_ own
55
55
  ```sh
56
56
  m365 planner bucket set --name "My Bucket" --planTitle "My Plan" --ownerGroupId 00000000-0000-0000-0000-000000000000 --newName "New bucket name"
57
57
  ```
58
+
59
+ ## Response
60
+
61
+ The command won't return a response on success.