@pnp/cli-microsoft365 6.7.0-beta.87c47df → 6.7.0-beta.f5f5666

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 (43) hide show
  1. package/.devcontainer/Dockerfile +1 -1
  2. package/README.md +1 -1
  3. package/csom.json +2 -0
  4. package/dist/Auth.js +75 -4
  5. package/dist/AuthServer.js +2 -1
  6. package/dist/m365/aad/commands/user/user-set.js +145 -30
  7. package/dist/m365/base/AzmgmtCommand.js +11 -0
  8. package/dist/m365/base/PowerAppsCommand.js +11 -0
  9. package/dist/m365/base/PowerPlatformCommand.js +11 -0
  10. package/dist/m365/commands/login.js +17 -1
  11. package/dist/m365/commands/status.js +4 -2
  12. package/dist/m365/spo/commands/applicationcustomizer/applicationcustomizer-get.js +144 -0
  13. package/dist/m365/spo/commands/list/list-add.js +7 -0
  14. package/dist/m365/spo/commands/list/list-set.js +7 -0
  15. package/dist/m365/spo/commands/listitem/listitem-list.js +113 -55
  16. package/dist/m365/spo/commands/site/site-recyclebinitem-clear.js +115 -0
  17. package/dist/m365/spo/commands.js +2 -0
  18. package/dist/m365/teams/commands/team/team-add.js +2 -2
  19. package/dist/request.js +7 -0
  20. package/dist/utils/misc.js +11 -0
  21. package/docs/docs/cmd/aad/user/user-set.md +53 -8
  22. package/docs/docs/cmd/login.md +5 -2
  23. package/docs/docs/cmd/pp/tenant/tenant-settings-list.md +25 -9
  24. package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-get.md +145 -0
  25. package/docs/docs/cmd/spo/list/list-add.md +3 -0
  26. package/docs/docs/cmd/spo/list/list-set.md +3 -0
  27. package/docs/docs/cmd/spo/listitem/listitem-list.md +22 -8
  28. package/docs/docs/cmd/spo/site/site-recyclebinitem-clear.md +45 -0
  29. package/docs/docs/cmd/tenant/id/id-get.md +6 -0
  30. package/docs/docs/cmd/tenant/report/report-activeusercounts.md +7 -0
  31. package/docs/docs/cmd/tenant/report/report-activeuserdetail.md +7 -0
  32. package/docs/docs/cmd/tenant/report/report-office365activationcounts.md +7 -0
  33. package/docs/docs/cmd/tenant/report/report-office365activationsusercounts.md +7 -0
  34. package/docs/docs/cmd/tenant/report/report-office365activationsuserdetail.md +7 -0
  35. package/docs/docs/cmd/tenant/report/report-servicesusercounts.md +7 -0
  36. package/docs/docs/cmd/tenant/security/security-alerts-list.md +23 -0
  37. package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-health-get.md +32 -0
  38. package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-health-list.md +32 -0
  39. package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-healthissue-get.md +26 -0
  40. package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-healthissue-list.md +26 -0
  41. package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-message-get.md +22 -0
  42. package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-message-list.md +22 -0
  43. package/package.json +2 -1
@@ -25,17 +25,56 @@ m365 aad user set [options]
25
25
  `--forceChangePasswordNextSignIn`
26
26
  : If specified, the user will have to change his password the next time they log in. Can only be set in combination with `resetPassword`.
27
27
 
28
+ `--forceChangePasswordNextSignInWithMfa`
29
+ : Whether the user should change his/her password on the next login and setup MFA. Can only be set in combination with `resetPassword`.
30
+
28
31
  `--currentPassword [currentPassword]`
29
32
  : Current password of the user that is signed in. If this parameter is set, `newPassword` is mandatory. Can't be combined with `resetPassword`.
30
33
 
31
34
  `--newPassword [newPassword]`
32
35
  : New password to be set. Must be set when specifying either `resetPassword` or `currentPassword`.
33
36
 
37
+ `--displayName [displayName]`
38
+ : The name to display in the address book for the user.
39
+
40
+ `--firstName [firstName]`
41
+ : The given name (first name) of the user. Maximum length is 64 characters.
42
+
43
+ `--lastName [lastName]`
44
+ : The user's surname (family name or last name). Maximum length is 64 characters.
45
+
46
+ `--usageLocation [usageLocation]`
47
+ : A two letter [country code](https://learn.microsoft.com/en-us/partner-center/commercial-marketplace-co-sell-location-codes#country-and-region-codes) (ISO standard 3166). Required for users that will be assigned licenses.
48
+
49
+ `--officeLocation [officeLocation]`
50
+ : The office location in the user's place of business.
51
+
52
+ `--jobTitle [jobTitle]`
53
+ : The user's job title. Maximum length is 128 characters.
54
+
55
+ `--companyName [companyName]`
56
+ : The company name which the user is associated. The maximum length is 64 characters.
57
+
58
+ `--department [department]`
59
+ : The name for the department in which the user works. Maximum length is 64 characters.
60
+
61
+ `--preferredLanguage [preferredLanguage]`
62
+ : The preferred language for the user. Should follow [ISO 639-1 Code](https://learn.microsoft.com/en-us/openspecs/office_standards/ms-oe376/6c085406-a698-4e12-9d4d-c3b0ee3dbc4a). Example: `en-US`.
63
+
64
+ `--managerUserId [managerUserId]`
65
+ : User ID of the user's manager. Specify `managerUserId`, `managerUserName` or `removeManager` but not both.
66
+
67
+ `--managerUserName [managerUserName]`
68
+ : User principal name of the manager. Specify `managerUserId`, `managerUserName` or `removeManager` but not both.
69
+
70
+ `--removeManager`
71
+ : Remove currently set manager. The user will have no manager when this flag is set. Specify `managerUserId`, `managerUserName` or `removeManager` but not both.
72
+
34
73
  --8<-- "docs/cmd/_global.md"
35
74
 
36
75
  ## Remarks
37
76
 
38
- You can update information of a user, either by specifying that user's id (`objectId`) or user name (`userPrincipalName`), but not both.
77
+ This command allows using unknown options.
39
78
 
40
79
  If the user with the specified id or user name doesn't exist, you will get a `Resource 'xyz' does not exist or one of its queried reference-property objects are not present.` error.
41
80
 
@@ -50,7 +89,7 @@ m365 aad user set --objectId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --Department I
50
89
  Update multiple properties of user with name _steve@contoso.onmicrosoft.com_
51
90
 
52
91
  ```sh
53
- m365 aad user set --userPrincipalName steve@contoso.onmicrosoft.com --Department "Sales & Marketing" --CompanyName Contoso
92
+ m365 aad user set --userPrincipalName steve@contoso.onmicrosoft.com --firstName John --lastName Doe --jobTitle "Sales Manager" --companyName Contoso --department Sales --officeLocation "New York"
54
93
  ```
55
94
 
56
95
  Enable user with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_
@@ -65,12 +104,6 @@ Disable user with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_
65
104
  m365 aad user set --objectId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --accountEnabled false
66
105
  ```
67
106
 
68
- Enable user with id _1caf7dcd-7e83-4c3a-94f7-932a1299c844_
69
-
70
- ```sh
71
- m365 aad user set --objectId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --accountEnabled true
72
- ```
73
-
74
107
  Reset password of a given user by userPrincipalName and require the user to change the password on the next sign in
75
108
 
76
109
  ```sh
@@ -83,6 +116,18 @@ Change password of the currently logged in user
83
116
  m365 aad user set --objectId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --currentPassword SLBF5gnRtyYc --newPassword 6NLUId79Lc24
84
117
  ```
85
118
 
119
+ Updates a user with a manager
120
+
121
+ ```sh
122
+ m365 aad user set --displayName "John Doe" --userName "john.doe@contoso.com" --managerUserName "adele@contoso.com"
123
+ ```
124
+
125
+ Updates a user by removing its manager
126
+
127
+ ```sh
128
+ m365 aad user set --userName "john.doe@contoso.com" --removeManager
129
+ ```
130
+
86
131
  ## Response
87
132
 
88
133
  The command won't return a response on success.
@@ -37,6 +37,9 @@ m365 login [options]
37
37
  `--tenant [tenant]`
38
38
  : ID of the tenant from which accounts should be able to authenticate. Use `common` or `organization` if the app is multitenant. If not specified, use the tenant specified in the `CLIMICROSOFT365_TENANT` environment variable. If the environment variable is not defined, use `common` as the tenant identifier
39
39
 
40
+ `--cloud [cloud]`
41
+ : Cloud to connect to. Allowed values `Public`, `USGov`, `USGovHigh`, `USGovDoD` and `China`. Default `Public`
42
+
40
43
  --8<-- "docs/cmd/_global.md"
41
44
 
42
45
  ## Remarks
@@ -45,8 +48,6 @@ Using the `login` command you can log in to Microsoft 365.
45
48
 
46
49
  By default, the `login` command uses device code OAuth flow to log in to Microsoft 365. Alternatively, you can authenticate using a user name and password or certificate, which are convenient for CI/CD scenarios, but which come with their own [limitations](../user-guide/connecting-office-365.md).
47
50
 
48
- When logging in to Microsoft 365, the `login` command stores in memory the access token and the refresh token. Both tokens are cleared from memory after exiting the CLI or by calling the [logout](logout.md) command.
49
-
50
51
  When logging in to Microsoft 365 using the user name and password, next to the access and refresh token, the CLI for Microsoft 365 will store the user credentials so that it can automatically re-authenticate if necessary. Similarly to the tokens, the credentials are removed by re-authenticating using the device code or by calling the [logout](logout.md) command.
51
52
 
52
53
  When logging in to Microsoft 365 using a certificate, the CLI for Microsoft 365 will store the contents of the certificate so that it can automatically re-authenticate if necessary. The contents of the certificate are removed by re-authenticating using the device code or by calling the [logout](logout.md) command.
@@ -55,6 +56,8 @@ To log in to Microsoft 365 using a certificate or secret, you will typically [cr
55
56
 
56
57
  Managed identity in Azure Cloud Shell is the identity of the user. It is neither system- nor user-assigned and it can't be configured. To log in to Microsoft 365 using managed identity in Azure Cloud Shell, set `authType` to `identity` and don't specify the `userName` option.
57
58
 
59
+ When connecting to clouds other than `Public`, you'll need to use an Azure AD application registered in a directory provisioned in that cloud. If you try to login using the default Azure AD application, login will fail.
60
+
58
61
  ## Examples
59
62
 
60
63
  Log in to Microsoft 365 using the device code
@@ -52,17 +52,34 @@ m365 pp tenant settings list
52
52
  "powerApps": {
53
53
  "disableShareWithEveryone": false,
54
54
  "enableGuestsToMake": false,
55
- "disableMembersIndicator": false
55
+ "disableMembersIndicator": false,
56
+ "disableMakerMatch": false,
57
+ "disableUnusedLicenseAssignment": false
58
+ },
59
+ "environments": {
60
+ "disablePreferredDataLocationForTeamsEnvironment": false
56
61
  },
57
- "environments": {},
58
62
  "governance": {
59
- "disableAdminDigest": false,
60
- "allowDeveloperEnvironmentProvisioning": false
63
+ "disableAdminDigest": true,
64
+ "disableDeveloperEnvironmentCreationByNonAdminUsers": false,
65
+ "enableDefaultEnvironmentRouting": false
61
66
  },
62
67
  "licensing": {
63
- "disableBillingPolicyCreationByNonAdminUsers": false
68
+ "disableBillingPolicyCreationByNonAdminUsers": false,
69
+ "storageCapacityConsumptionWarningThreshold": 85
70
+ },
71
+ "powerPages": {},
72
+ "champions": {
73
+ "disableChampionsInvitationReachout": false,
74
+ "disableSkillsMatchInvitationReachout": false
75
+ },
76
+ "intelligence": {
77
+ "disableCopilot": false,
78
+ "enableOpenAiBotPublishing": false
64
79
  },
65
- "powerPages": {}
80
+ "modelExperimentation": {
81
+ "enableModelDataSharing": false
82
+ }
66
83
  }
67
84
  }
68
85
  ```
@@ -83,8 +100,8 @@ m365 pp tenant settings list
83
100
  === "CSV"
84
101
 
85
102
  ```csv
86
- disableCapacityAllocationByEnvironmentAdmins,disableEnvironmentCreationByNonAdminUsers,disableNPSCommentsReachout,disablePortalsCreationByNonAdminUsers,disableSupportTicketsVisibleByAllUsers,disableSurveyFeedback,disableTrialEnvironmentCreationByNonAdminUsers,walkMeOptOut
87
- false,false,false,false,false,false,false,false
103
+ walkMeOptOut,disableNPSCommentsReachout,disableNewsletterSendout,disableEnvironmentCreationByNonAdminUsers,disablePortalsCreationByNonAdminUsers,disableSurveyFeedback,disableTrialEnvironmentCreationByNonAdminUsers,disableCapacityAllocationByEnvironmentAdmins,disableSupportTicketsVisibleByAllUsers
104
+ ,,,,,,,,
88
105
  ```
89
106
 
90
107
  === "Markdown"
@@ -105,5 +122,4 @@ m365 pp tenant settings list
105
122
  disableTrialEnvironmentCreationByNonAdminUsers | false
106
123
  disableCapacityAllocationByEnvironmentAdmins | false
107
124
  disableSupportTicketsVisibleByAllUsers | false
108
- powerPlatform | {"search":{"disableDocsSearch":false,"disableCommunitySearch":false,"disableBingVideoSearch":false},"teamsIntegration":{"shareWithColleaguesUserLimit":10000},"powerApps":{"disableShareWithEveryone":false,"enableGuestsToMake":false,"disableMembersIndicator":false},"environments":{},"governance":{"disableAdminDigest":false,"disableDeveloperEnvironmentCreationByNonAdminUsers":false},"licensing":{"disableBillingPolicyCreationByNonAdminUsers":false},"powerPages":{}}
109
125
  ```
@@ -0,0 +1,145 @@
1
+ # spo applicationcustomizer get
2
+
3
+ Get an application customizer that is added to a site.
4
+
5
+ ## Usage
6
+
7
+ ```sh
8
+ m365 spo applicationcustomizer get [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ `-u, --webUrl <webUrl>`
14
+ : URL of the site.
15
+
16
+ `-t, --title [title]`
17
+ : The title of the Application Customizer. Specify either `title`, `id`, or `clientSideComponentId`.
18
+
19
+ `-i, --id [id]`
20
+ : The id of the Application Customizer. Specify either `title`, `id`, or `clientSideComponentId`.
21
+
22
+ `-c, --clientSideComponentId [clientSideComponentId]`
23
+ : The Client Side Component Id (GUID) of the application customizer. Specify either `title`, `id`, or `clientSideComponentId`.
24
+
25
+ `-s, --scope [scope]`
26
+ : Scope of the application customizer. Allowed values: `Site`, `Web`, `All`. Defaults to `All`.
27
+
28
+ --8<-- "docs/cmd/_global.md"
29
+
30
+ ## Examples
31
+
32
+ Retrieves an application customizer by title.
33
+
34
+ ```sh
35
+ m365 spo applicationcustomizer get --title "Some customizer" --webUrl https://contoso.sharepoint.com/sites/sales
36
+ ```
37
+
38
+ Retrieves an application customizer by id.
39
+
40
+ ```sh
41
+ m365 spo applicationcustomizer get --id 14125658-a9bc-4ddf-9c75-1b5767c9a337 --webUrl https://contoso.sharepoint.com/sites/sales
42
+ ```
43
+
44
+ Retrieves an application customizer by clientSideComponentId.
45
+
46
+ ```sh
47
+ m365 spo applicationcustomizer get --clientSideComponentId 7096cded-b83d-4eab-96f0-df477ed7c0bc --webUrl https://contoso.sharepoint.com/sites/sales
48
+ ```
49
+
50
+ Retrieves an application customizer by title available at the site scope.
51
+
52
+ ```sh
53
+ m365 spo applicationcustomizer get --title "Some customizer" --webUrl https://contoso.sharepoint.com/sites/sales --scope site
54
+ ```
55
+
56
+ ## Response
57
+
58
+ === "JSON"
59
+
60
+ ```json
61
+ {
62
+ "ClientSideComponentId": "7096cded-b83d-4eab-96f0-df477ed7c0bc",
63
+ "ClientSideComponentProperties": "",
64
+ "CommandUIExtension": null,
65
+ "Description": null,
66
+ "Group": null,
67
+ "Id": "14125658-a9bc-4ddf-9c75-1b5767c9a337",
68
+ "ImageUrl": null,
69
+ "Location": "ClientSideExtension.ApplicationCustomizer",
70
+ "Name": "Some customizer",
71
+ "RegistrationId": null,
72
+ "RegistrationType": 0,
73
+ "Rights": "{\"High\":0,\"Low\":0}",
74
+ "Scope": "Web",
75
+ "ScriptBlock": null,
76
+ "ScriptSrc": null,
77
+ "Sequence": 0,
78
+ "Title": "Some customizer",
79
+ "Url": null,
80
+ "VersionOfUserCustomAction": "16.0.1.0"
81
+ }
82
+ ```
83
+
84
+ === "Text"
85
+
86
+ ```text
87
+ ClientSideComponentId : 7096cded-b83d-4eab-96f0-df477ed7c0bc
88
+ ClientSideComponentProperties:
89
+ CommandUIExtension : null
90
+ Description : null
91
+ Group : null
92
+ Id : 14125658-a9bc-4ddf-9c75-1b5767c9a337
93
+ ImageUrl : null
94
+ Location : ClientSideExtension.ApplicationCustomizer
95
+ Name : Some customizer
96
+ RegistrationId : null
97
+ RegistrationType : 0
98
+ Rights : {"High":0,"Low":0}
99
+ Scope : Web
100
+ ScriptBlock : null
101
+ ScriptSrc : null
102
+ Sequence : 0
103
+ Title : Some customizer
104
+ Url : null
105
+ VersionOfUserCustomAction : 16.0.1.0
106
+ ```
107
+
108
+ === "CSV"
109
+
110
+ ```csv
111
+ ClientSideComponentId,ClientSideComponentProperties,CommandUIExtension,Description,Group,Id,ImageUrl,Location,Name,RegistrationId,RegistrationType,Rights,Scope,ScriptBlock,ScriptSrc,Sequence,Title,Url,VersionOfUserCustomAction
112
+ 7096cded-b83d-4eab-96f0-df477ed7c0bc,,,,,14125658-a9bc-4ddf-9c75-1b5767c9a337,,ClientSideExtension.ApplicationCustomizer,Some customizer,,0,"{""High"":0,""Low"":0}",Web,,,0,Some customizer,,16.0.1.0
113
+ ```
114
+
115
+ === "Markdown"
116
+
117
+ ```md
118
+ # spo applicationcustomizer get --title "Some customizer" --webUrl "https://nachan365.sharepoint.com/sites/spdemo" --scope "Web"
119
+
120
+ Date: 3/6/2023
121
+
122
+ ## Some customizer (14125658-a9bc-4ddf-9c75-1b5767c9a337)
123
+
124
+ Property | Value
125
+ ---------|-------
126
+ ClientSideComponentId | 7096cded-b83d-4eab-96f0-df477ed7c0bc
127
+ ClientSideComponentProperties |
128
+ CommandUIExtension | null
129
+ Description | null
130
+ Group | null
131
+ Id | 14125658-a9bc-4ddf-9c75-1b5767c9a337
132
+ ImageUrl | null
133
+ Location | ClientSideExtension.ApplicationCustomizer
134
+ Name | Some customizer
135
+ RegistrationId | null
136
+ RegistrationType | 0
137
+ Rights | {"High":0,"Low":0}
138
+ Scope | Web
139
+ ScriptBlock | null
140
+ ScriptSrc | null
141
+ Sequence | 0
142
+ Title | Some customizer
143
+ Url | null
144
+ VersionOfUserCustomAction | 16.0.1.0
145
+ ```
@@ -52,6 +52,9 @@ m365 spo list add [options]
52
52
  `--direction [direction]`
53
53
  : Value that specifies the reading order of the list. Valid values are `NONE`, `LTR`, `RTL`.
54
54
 
55
+ `--disableCommenting [disableCommenting]`
56
+ : Property for enabling or disabling commenting on the list. Valid values are `true`, `false`.
57
+
55
58
  `--disableGridEditing [disableGridEditing]`
56
59
  : Property for assigning or retrieving grid editing on the list. Valid values are `true`, `false`.
57
60
 
@@ -55,6 +55,9 @@ m365 spo list set [options]
55
55
  `--direction [direction]`
56
56
  : Value that specifies the reading order of the list. Valid values are `NONE`, `LTR`, `RTL`.
57
57
 
58
+ `--disableCommenting [disableCommenting]`
59
+ : Property for enabling or disabling commenting on the list. Valid values are `true`, `false`.
60
+
58
61
  `--disableGridEditing [disableGridEditing]`
59
62
  : Property for assigning or retrieving grid editing on the list. Valid values are `true`, `false`.
60
63
 
@@ -32,7 +32,7 @@ m365 spo listitem list [options]
32
32
  : OData filter to use to query the list of items with. Specify `camlQuery` or `filter` but not both.
33
33
 
34
34
  `-p, --pageSize [pageSize]`
35
- : Number of list items to return. Specify `camlQuery` or `pageSize` but not both.
35
+ : Number of list items to return. Specify `camlQuery` or `pageSize` but not both. The default value is 5000.
36
36
 
37
37
  `-n, --pageNumber [pageNumber]`
38
38
  : Page number to return if `pageSize` is specified (first page is indexed as value of 0).
@@ -41,6 +41,8 @@ m365 spo listitem list [options]
41
41
 
42
42
  ## Remarks
43
43
 
44
+ This command retrieves all items in the list, even if there are more than 5000. Use the `pageSize` and `pageNumber` options if you only want a specific amount of items. When using a CAML query, include a `RowLimit`-node to get all items. If you run into list view threshold exceptions, remove any Query-conditions or filters and also include a `RowLimit`-node.
45
+
44
46
  `pageNumber` is specified as a 0-based index. A value of `2` returns the third page of items.
45
47
 
46
48
  If you want to specify a lookup type in the `properties` option, define which columns from the related list should be returned.
@@ -53,12 +55,6 @@ Get all items from a list named Demo List
53
55
  m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x
54
56
  ```
55
57
 
56
- From a list named _Demo List_ get all items with title _Demo list item_ using a CAML query
57
-
58
- ```sh
59
- m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --camlQuery "<View><Query><Where><Eq><FieldRef Name='Title' /><Value Type='Text'>Demo list item</Value></Eq></Where></Query></View>"
60
- ```
61
-
62
58
  Get all items from a list with ID _935c13a0-cc53-4103-8b48-c1d0828eaa7f_
63
59
 
64
60
  ```sh
@@ -83,10 +79,16 @@ From a list named _Demo List_ get all items with title _Demo list item_ using an
83
79
  m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --filter "Title eq 'Demo list item'"
84
80
  ```
85
81
 
82
+ From a list named _Demo List_ get the first 100 items
83
+
84
+ ```sh
85
+ m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --pageSize 100 --pageNumber 0
86
+ ```
87
+
86
88
  From a list named _Demo List_ get the second batch of 10 items
87
89
 
88
90
  ```sh
89
- m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --pageSize 10 --pageNumber 2
91
+ m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --pageSize 10 --pageNumber 1
90
92
  ```
91
93
 
92
94
  Get all items from a list by server-relative URL
@@ -95,6 +97,18 @@ Get all items from a list by server-relative URL
95
97
  m365 spo listitem list --listUrl /sites/project-x/documents --webUrl https://contoso.sharepoint.com/sites/project-x
96
98
  ```
97
99
 
100
+ From a list named _Demo List_ get all items with title _Demo list item_ using a CAML query
101
+
102
+ ```sh
103
+ m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --camlQuery "<View><Query><Where><Eq><FieldRef Name='Title' /><Value Type='Text'>Demo list item</Value></Eq></Where></Query><RowLimit Paged='TRUE'>5000</RowLimit></View>"
104
+ ```
105
+
106
+ From a library named _Demo Library_ with 5000+ files and folders, get all items recursively without running into a list view threshold exception, using a CAML query
107
+
108
+ ```sh
109
+ m365 spo listitem list --listTitle "Demo List" --webUrl https://contoso.sharepoint.com/sites/project-x --camlQuery "<View Scope='RecursiveAll'><Query></Query><ViewFields><FieldRef Name='Title'/></ViewFields><RowLimit Paged='TRUE'>5000</RowLimit></View>"
110
+ ```
111
+
98
112
  ## Response
99
113
 
100
114
  === "JSON"
@@ -0,0 +1,45 @@
1
+ # spo site recyclebinitem clear
2
+
3
+ Permanently removes all items in a site recycle bin
4
+
5
+ ## Usage
6
+
7
+ ```sh
8
+ m365 spo site recyclebinitem clear [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ `-u, --siteUrl <siteUrl>`
14
+ : URL of the site where the recycle bin is located.
15
+
16
+ `--secondary`
17
+ : Remove all items from the second-stage recycle bin. When not specified, items from the first-stage recycle bin will be cleared.
18
+
19
+ `--confirm`
20
+ : Don't prompt for confirmation.
21
+
22
+ --8<-- "docs/cmd/_global.md"
23
+
24
+ ## Remarks
25
+
26
+ !!! warning
27
+ Items in the recycle bin will be permanently removed without the ability to restore them.
28
+
29
+ ## Examples
30
+
31
+ Clear all items from the first-stage recycle bin
32
+
33
+ ```sh
34
+ m365 spo site recyclebinitem clear --siteUrl https://contoso.sharepoint.com/sites/sales
35
+ ```
36
+
37
+ Clear all items from the second-stage recycle bin
38
+
39
+ ```sh
40
+ m365 spo site recyclebinitem clear --siteUrl https://contoso.sharepoint.com/sites/sales --secondary
41
+ ```
42
+
43
+ ## Response
44
+
45
+ The command won't return a response on success.
@@ -52,3 +52,9 @@ m365 tenant id get
52
52
  ```csv
53
53
  e65b162c-6f87-4eb1-a24e-1b37d3504663
54
54
  ```
55
+
56
+ === "Markdown"
57
+
58
+ ```md
59
+ e65b162c-6f87-4eb1-a24e-1b37d3504663
60
+ ```
@@ -72,3 +72,10 @@ m365 tenant report activeusercounts --period D7 --output json > "activeusercount
72
72
  Report Refresh Date,Office 365,Exchange,OneDrive,SharePoint,Skype For Business,Yammer,Teams,Report Date,Report Period
73
73
  2022-10-25,1,5,4,3,2,3,1,2022-10-19,7
74
74
  ```
75
+
76
+ === "Markdown"
77
+
78
+ ```md
79
+ Report Refresh Date,Office 365,Exchange,OneDrive,SharePoint,Skype For Business,Yammer,Teams,Report Date,Report Period
80
+ 2022-10-25,1,5,4,3,2,3,1,2022-10-19,7
81
+ ```
@@ -99,3 +99,10 @@ m365 tenant report activeuserdetail --period D7 --output json > "activeuserdetai
99
99
  Report Refresh Date,User Principal Name,Display Name,Is Deleted,Deleted Date,Has Exchange License,Has OneDrive License,Has SharePoint License,Has Skype For Business License,Has Yammer License,Has Teams License,Exchange Last Activity Date,OneDrive Last Activity Date,SharePoint Last Activity Date,Skype For Business Last Activity Date,Yammer Last Activity Date,Teams Last Activity Date,Exchange License Assign Date,OneDrive License Assign Date,SharePoint License Assign Date,Skype For Business License Assign Date,Yammer License Assign Date,Teams License Assign Date,Assigned Products
100
100
  2022-10-23,77E5979DD60BA6EAA53E814DBEEEFA5F,4291DA7C39EE3263E97336B42734A667,False,,True,True,True,True,True,True,,2022-09-12,2020-09-12,2022-09-12,2021-10-30,2020-10-30,2019-04-21,2017-09-20,2021-01-10,2021-01-10,2021-01-10,2021-01-10,2021-01-10,2021-01-10,MICROSOFT 365 E5 DEVELOPER (WITHOUT WINDOWS AND AUDIO CONFERENCING)
101
101
  ```
102
+
103
+ === "Markdown"
104
+
105
+ ```md
106
+ Report Refresh Date,User Principal Name,Display Name,Is Deleted,Deleted Date,Has Exchange License,Has OneDrive License,Has SharePoint License,Has Skype For Business License,Has Yammer License,Has Teams License,Exchange Last Activity Date,OneDrive Last Activity Date,SharePoint Last Activity Date,Skype For Business Last Activity Date,Yammer Last Activity Date,Teams Last Activity Date,Exchange License Assign Date,OneDrive License Assign Date,SharePoint License Assign Date,Skype For Business License Assign Date,Yammer License Assign Date,Teams License Assign Date,Assigned Products
107
+ 2022-10-23,77E5979DD60BA6EAA53E814DBEEEFA5F,4291DA7C39EE3263E97336B42734A667,False,,True,True,True,True,True,True,,2022-09-12,2020-09-12,2022-09-12,2021-10-30,2020-10-30,2019-04-21,2017-09-20,2021-01-10,2021-01-10,2021-01-10,2021-01-10,2021-01-10,2021-01-10,MICROSOFT 365 E5 DEVELOPER (WITHOUT WINDOWS AND AUDIO CONFERENCING)
108
+ ```
@@ -51,3 +51,10 @@ m365 tenant report office365activationcounts
51
51
  Report Refresh Date,Product Type,Windows,Mac,Android,iOS,Windows 10 Mobile
52
52
  2022-10-25,MICROSOFT 365 APPS FOR ENTERPRISE,5,0,0,0,0
53
53
  ```
54
+
55
+ === "Markdown"
56
+
57
+ ```md
58
+ Report Refresh Date,Product Type,Windows,Mac,Android,iOS,Windows 10 Mobile
59
+ 2022-10-25,MICROSOFT 365 APPS FOR ENTERPRISE,5,0,0,0,0
60
+ ```
@@ -49,3 +49,10 @@ m365 tenant report office365activationsusercounts
49
49
  Report Refresh Date,Product Type,Assigned,Activated,Shared Computer Activation
50
50
  2022-10-25,MICROSOFT 365 APPS FOR ENTERPRISE,24,5,0
51
51
  ```
52
+
53
+ === "Markdown"
54
+
55
+ ```md
56
+ Report Refresh Date,Product Type,Assigned,Activated,Shared Computer Activation
57
+ 2022-10-25,MICROSOFT 365 APPS FOR ENTERPRISE,24,5,0
58
+ ```
@@ -55,3 +55,10 @@ m365 tenant report office365activationsuserdetail
55
55
  Report Refresh Date,User Principal Name,Display Name,Product Type,Last Activated Date,Windows,Mac,Windows 10 Mobile,iOS,Android,Activated On Shared Computer
56
56
  2022-10-25,77E5979DD60BA6EAA53E814DBEEEFA5F,4291DA7C39EE3263E97336B42734A667,MICROSOFT 365 APPS FOR ENTERPRISE,2021-01-10,1,0,0,0,0,False
57
57
  ```
58
+
59
+ === "Markdown"
60
+
61
+ ```md
62
+ Report Refresh Date,User Principal Name,Display Name,Product Type,Last Activated Date,Windows,Mac,Windows 10 Mobile,iOS,Android,Activated On Shared Computer
63
+ 2022-10-25,77E5979DD60BA6EAA53E814DBEEEFA5F,4291DA7C39EE3263E97336B42734A667,MICROSOFT 365 APPS FOR ENTERPRISE,2021-01-10,1,0,0,0,0,False
64
+ ```
@@ -78,3 +78,10 @@ m365 tenant report servicesusercounts --period D7 --output json > "servicesuserc
78
78
  Report Refresh Date,Exchange Active,Exchange Inactive,OneDrive Active,OneDrive Inactive,SharePoint Active,SharePoint Inactive,Skype For Business Active,Skype For Business Inactive,Yammer Active,Yammer Inactive,Teams Active,Teams Inactive,Office 365 Active,Office 365 Inactive,Report Period
79
79
  2022-10-23,1,23,1,23,1,23,0,24,0,24,1,23,2,22,7
80
80
  ```
81
+
82
+ === "Markdown"
83
+
84
+ ```md
85
+ Report Refresh Date,Exchange Active,Exchange Inactive,OneDrive Active,OneDrive Inactive,SharePoint Active,SharePoint Inactive,Skype For Business Active,Skype For Business Inactive,Yammer Active,Yammer Inactive,Teams Active,Teams Inactive,Office 365 Active,Office 365 Inactive,Report Period
86
+ 2022-10-23,1,23,1,23,1,23,0,24,0,24,1,23,2,22,7
87
+ ```
@@ -133,3 +133,26 @@ m365 tenant security alerts list --vendor "Azure Sentinel"
133
133
  id,title,severity
134
134
  4ece2cf8-cbc0-5a42-92c3-e23f96006907,SharePoint Bulk Edit Items,medium
135
135
  ```
136
+
137
+ === "Markdown"
138
+
139
+ ```md
140
+ # tenant security alerts list
141
+
142
+ Date: 3/20/2022
143
+
144
+ ## Unfamiliar sign-in properties (2517536653831539999_658fa695-a5e6-4b60-ac7c-b2c1396df384)
145
+
146
+ Property | Value
147
+ ---------|-------
148
+ id | 2517536653831539999_658fa695-a5e6-4b60-ac7c-b2c1396df384
149
+ azureTenantId | b8e1599d-b418-4be9-8f39-df03c3abe27a
150
+ category | Storage.Blob_GeoAnomaly
151
+ createdDateTime | 2022-03-30T13:19:15.8039138Z
152
+ description | The following properties of this sign-in are unfamiliar for the given user: ASN, Browser, Device, IP, Location, EASId, TenantIPsubnet
153
+ eventDateTime | 2022-03-30T10:16:56.846Z
154
+ lastModifiedDateTime | 2022-03-30T13:19:48.5196488Z
155
+ severity | low
156
+ status | newAlert
157
+ title | Access from an unusual location to a storage blob container
158
+ ```
@@ -61,6 +61,22 @@ m365 tenant serviceannouncement health get --serviceName "Exchange Online" --iss
61
61
  Exchange,serviceDegradation,Exchange Online
62
62
  ```
63
63
 
64
+ === "Markdown"
65
+
66
+ ```md
67
+ # tenant serviceannouncement health get --serviceName "Exchange Online"
68
+
69
+ Date: 4/19/2023
70
+
71
+ ## Exchange
72
+
73
+ Property | Value
74
+ ---------|-------
75
+ service | Exchange Online
76
+ status | serviceDegradation
77
+ id | Exchange
78
+ ```
79
+
64
80
  ### `issues` response
65
81
 
66
82
  When we make use of the option `issues` the response will differ.
@@ -118,3 +134,19 @@ When we make use of the option `issues` the response will differ.
118
134
  id,status,service
119
135
  Exchange,serviceDegradation,Exchange Online
120
136
  ```
137
+
138
+ === "Markdown"
139
+
140
+ ```md
141
+ # tenant serviceannouncement health get --serviceName "Exchange Online" --issues "true"
142
+
143
+ Date: 4/19/2023
144
+
145
+ ## Exchange
146
+
147
+ Property | Value
148
+ ---------|-------
149
+ service | Exchange Online
150
+ status | serviceDegradation
151
+ id | Exchange
152
+ ```
@@ -60,6 +60,22 @@ m365 tenant serviceannouncement health list --issues
60
60
  Exchange,serviceDegradation,Exchange Online
61
61
  ```
62
62
 
63
+ === "Markdown"
64
+
65
+ ```md
66
+ # tenant serviceannouncement health list
67
+
68
+ Date: 4/19/2023
69
+
70
+ ## Exchange
71
+
72
+ Property | Value
73
+ ---------|-------
74
+ service | Exchange Online
75
+ status | serviceDegradation
76
+ id | Exchange
77
+ ```
78
+
63
79
  ### `issues` response
64
80
 
65
81
  When we make use of the option `issues` the response will differ.
@@ -119,3 +135,19 @@ When we make use of the option `issues` the response will differ.
119
135
  id,status,service
120
136
  Exchange,serviceDegradation,Exchange Online
121
137
  ```
138
+
139
+ === "Markdown"
140
+
141
+ ```md
142
+ # tenant serviceannouncement health list --issues "true"
143
+
144
+ Date: 4/19/2023
145
+
146
+ ## Exchange
147
+
148
+ Property | Value
149
+ ---------|-------
150
+ service | Exchange Online
151
+ status | serviceDegradation
152
+ id | Exchange
153
+ ```