@pnp/cli-microsoft365 4.2.0-beta.b126b71 → 4.3.0-beta.014ebf5

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 (42) hide show
  1. package/.devcontainer/Dockerfile +1 -1
  2. package/.eslintrc.js +1 -0
  3. package/dist/appInsights.js +2 -0
  4. package/dist/cli/Cli.js +4 -1
  5. package/dist/m365/aad/commands/app/app-add.js +58 -5
  6. package/dist/m365/aad/commands/app/app-get.js +97 -0
  7. package/dist/m365/aad/commands/o365group/o365group-add.js +56 -50
  8. package/dist/m365/aad/commands/sp/sp-add.js +107 -0
  9. package/dist/m365/aad/commands.js +2 -0
  10. package/dist/m365/base/M365RcJson.js +3 -0
  11. package/dist/m365/file/commands/file-list.js +181 -0
  12. package/dist/m365/file/commands.js +2 -1
  13. package/dist/m365/search/commands/externalconnection/externalconnection-add.js +99 -0
  14. package/dist/m365/search/commands.js +7 -0
  15. package/dist/m365/spfx/commands/project/project-upgrade/upgrade-1.13.1.js +53 -0
  16. package/dist/m365/spfx/commands/project/project-upgrade.js +2 -1
  17. package/dist/m365/spfx/commands/spfx-doctor.js +176 -62
  18. package/dist/m365/spo/commands/contenttype/contenttype-list.js +52 -0
  19. package/dist/m365/spo/commands/list/list-get.js +6 -2
  20. package/dist/m365/spo/commands/page/Page.js +3 -1
  21. package/dist/m365/spo/commands/page/page-add.js +7 -10
  22. package/dist/m365/spo/commands/page/page-set.js +7 -10
  23. package/dist/m365/spo/commands/site/site-remove.js +98 -30
  24. package/dist/m365/spo/commands/web/web-installedlanguage-list.js +48 -0
  25. package/dist/m365/spo/commands.js +3 -1
  26. package/dist/m365/teams/commands/report/report-directroutingcalls.js +1 -1
  27. package/docs/docs/cmd/aad/app/app-add.md +11 -0
  28. package/docs/docs/cmd/aad/app/app-get.md +48 -0
  29. package/docs/docs/cmd/aad/o365group/o365group-add.md +1 -0
  30. package/docs/docs/cmd/aad/sp/sp-add.md +53 -0
  31. package/docs/docs/cmd/file/file-list.md +46 -0
  32. package/docs/docs/cmd/search/externalconnection/externalconnection-add.md +43 -0
  33. package/docs/docs/cmd/spfx/project/project-upgrade.md +1 -1
  34. package/docs/docs/cmd/spo/contenttype/contenttype-list.md +33 -0
  35. package/docs/docs/cmd/spo/list/list-get.md +9 -0
  36. package/docs/docs/cmd/spo/page/page-add.md +2 -2
  37. package/docs/docs/cmd/spo/page/page-set.md +3 -3
  38. package/docs/docs/cmd/spo/site/site-remove.md +3 -1
  39. package/docs/docs/cmd/spo/web/web-installedlanguage-list.md +24 -0
  40. package/docs/docs/cmd/teams/report/report-directroutingcalls.md +0 -3
  41. package/npm-shrinkwrap.json +510 -888
  42. package/package.json +19 -17
@@ -25,26 +25,65 @@ class SpoSiteRemoveCommand extends SpoCommand_1.default {
25
25
  commandAction(logger, args, cb) {
26
26
  const removeSite = () => {
27
27
  this.dots = '';
28
- this
29
- .getSiteGroupId(args.options.url, logger)
30
- .then((_groupId) => {
31
- if (_groupId === '00000000-0000-0000-0000-000000000000') {
32
- if (this.debug) {
33
- logger.logToStderr('Site is not groupified. Going ahead with the conventional site deletion options');
34
- }
35
- return this.deleteSiteWithoutGroup(logger, args);
36
- }
37
- else {
38
- if (this.debug) {
39
- logger.logToStderr(`Site attached to group ${_groupId}. Initiating group delete operation via Graph API`);
28
+ if (args.options.fromRecycleBin) {
29
+ this
30
+ .deleteSiteWithoutGroup(logger, args)
31
+ .then(_ => cb(), (err) => this.handleRejectedPromise(err, logger, cb));
32
+ }
33
+ else {
34
+ this
35
+ .getSiteGroupId(args.options.url, logger)
36
+ .then((groupId) => {
37
+ if (groupId === '00000000-0000-0000-0000-000000000000') {
38
+ if (this.debug) {
39
+ logger.logToStderr('Site is not groupified. Going ahead with the conventional site deletion options');
40
+ }
41
+ return this.deleteSiteWithoutGroup(logger, args);
40
42
  }
41
- if (args.options.fromRecycleBin || args.options.skipRecycleBin || args.options.wait) {
42
- logger.log(chalk.yellow(`Entered site is a groupified site. Hence, the parameters 'fromRecycleBin' or 'skipRecycleBin' or 'wait' will not be applicable.`));
43
+ else {
44
+ if (this.debug) {
45
+ logger.logToStderr(`Site attached to group ${groupId}. Initiating group delete operation via Graph API`);
46
+ }
47
+ return this
48
+ .getSiteGroup(groupId)
49
+ .then((group) => {
50
+ if (args.options.skipRecycleBin || args.options.wait) {
51
+ logger.logToStderr(chalk.yellow(`Entered site is a groupified site. Hence, the parameters 'skipRecycleBin' and 'wait' will not be applicable.`));
52
+ }
53
+ return this.deleteGroupifiedSite(group.id, logger);
54
+ })
55
+ .catch((err) => {
56
+ if (err.response.status === 404) {
57
+ if (this.verbose) {
58
+ logger.logToStderr(`Site group doesn't exist. Searching in the Microsoft 365 deleted groups.`);
59
+ }
60
+ return this
61
+ .isSiteGroupDeleted(groupId)
62
+ .then((deletedGroups) => {
63
+ if (deletedGroups.value.length === 0) {
64
+ if (this.verbose) {
65
+ logger.logToStderr("Site group doesn't exist anymore. Deleting the site.");
66
+ }
67
+ if (args.options.wait) {
68
+ logger.logToStderr(chalk.yellow(`Entered site is a groupified site. Hence, the parameter 'wait' will not be applicable.`));
69
+ }
70
+ return Promise.resolve();
71
+ }
72
+ else {
73
+ return Promise.reject(`Site group still exists in the deleted groups. The site won't be removed.`);
74
+ }
75
+ })
76
+ .then(_ => this.deleteOrphanedSite(logger, args.options.url))
77
+ .catch((err) => Promise.reject(err));
78
+ }
79
+ else {
80
+ return Promise.reject(err);
81
+ }
82
+ });
43
83
  }
44
- return this.deleteGroupifiedSite(_groupId, logger);
45
- }
46
- })
47
- .then(_ => cb(), (err) => this.handleRejectedPromise(err, logger, cb));
84
+ })
85
+ .then(_ => cb(), (err) => this.handleRejectedPromise(err, logger, cb));
86
+ }
48
87
  };
49
88
  if (args.options.confirm) {
50
89
  removeSite();
@@ -65,32 +104,64 @@ class SpoSiteRemoveCommand extends SpoCommand_1.default {
65
104
  });
66
105
  }
67
106
  }
107
+ getSiteGroup(groupId) {
108
+ const requestOptions = {
109
+ url: `https://graph.microsoft.com/v1.0/groups/${groupId}`,
110
+ headers: {
111
+ accept: 'application/json;odata.metadata=none'
112
+ },
113
+ responseType: 'json'
114
+ };
115
+ return request_1.default.get(requestOptions);
116
+ }
117
+ isSiteGroupDeleted(groupId) {
118
+ const requestOptions = {
119
+ url: `https://graph.microsoft.com/v1.0/directory/deletedItems/Microsoft.Graph.Group?$select=id&$filter=groupTypes/any(c:c+eq+'Unified') and startswith(id, '${groupId}')`,
120
+ headers: {
121
+ accept: 'application/json;odata.metadata=none'
122
+ },
123
+ responseType: 'json'
124
+ };
125
+ return request_1.default.get(requestOptions);
126
+ }
127
+ deleteOrphanedSite(logger, url) {
128
+ return this
129
+ .getSpoAdminUrl(logger, this.debug)
130
+ .then((spoAdminUrl) => {
131
+ const requestOptions = {
132
+ url: `${spoAdminUrl}/_api/GroupSiteManager/Delete?siteUrl='${url}'`,
133
+ headers: {
134
+ 'content-type': 'application/json;odata=nometadata',
135
+ accept: 'application/json;odata=nometadata'
136
+ },
137
+ responseType: 'json'
138
+ };
139
+ return request_1.default.post(requestOptions);
140
+ });
141
+ }
68
142
  deleteSiteWithoutGroup(logger, args) {
69
143
  return this
70
144
  .getSpoAdminUrl(logger, this.debug)
71
- .then((_spoAdminUrl) => {
72
- this.spoAdminUrl = _spoAdminUrl;
145
+ .then((spoAdminUrl) => {
146
+ this.spoAdminUrl = spoAdminUrl;
73
147
  return this.ensureFormDigest(this.spoAdminUrl, logger, this.context, this.debug);
74
148
  })
75
149
  .then((res) => {
76
150
  this.context = res;
77
151
  if (args.options.fromRecycleBin) {
78
152
  if (this.verbose) {
79
- logger.logToStderr(`Deleting site collection from recycle bin ${args.options.url}...`);
153
+ logger.logToStderr(`Deleting site from recycle bin ${args.options.url}...`);
80
154
  }
81
155
  return this.deleteSiteFromTheRecycleBin(args.options.url, args.options.wait, logger);
82
156
  }
83
157
  else {
84
- if (this.verbose) {
85
- logger.logToStderr(`Deleting site collection ${args.options.url}...`);
86
- }
87
158
  return this.deleteSite(args.options.url, args.options.wait, logger);
88
159
  }
89
160
  })
90
161
  .then(() => {
91
162
  if (args.options.skipRecycleBin) {
92
163
  if (this.verbose) {
93
- logger.logToStderr(`Also deleting site collection from recycle bin ${args.options.url}...`);
164
+ logger.logToStderr(`Also deleting site from tenant recycle bin ${args.options.url}...`);
94
165
  }
95
166
  return this.deleteSiteFromTheRecycleBin(args.options.url, args.options.wait, logger);
96
167
  }
@@ -106,7 +177,7 @@ class SpoSiteRemoveCommand extends SpoCommand_1.default {
106
177
  .then((res) => {
107
178
  this.context = res;
108
179
  if (this.verbose) {
109
- logger.logToStderr(`Deleting site ${url} ...`);
180
+ logger.logToStderr(`Deleting site ${url}...`);
110
181
  }
111
182
  const requestOptions = {
112
183
  url: `${this.spoAdminUrl}/_vti_bin/client.svc/ProcessQuery`,
@@ -143,9 +214,6 @@ class SpoSiteRemoveCommand extends SpoCommand_1.default {
143
214
  .ensureFormDigest(this.spoAdminUrl, logger, this.context, this.debug)
144
215
  .then((res) => {
145
216
  this.context = res;
146
- if (this.verbose) {
147
- logger.logToStderr(`Deleting site ${url} from the recycle bin...`);
148
- }
149
217
  const requestOptions = {
150
218
  url: `${this.spoAdminUrl}/_vti_bin/client.svc/ProcessQuery`,
151
219
  headers: {
@@ -185,7 +253,7 @@ class SpoSiteRemoveCommand extends SpoCommand_1.default {
185
253
  .then((res) => {
186
254
  this.context = res;
187
255
  if (this.verbose) {
188
- logger.logToStderr(`Retrieving the GroupId of the site ${url}`);
256
+ logger.logToStderr(`Retrieving the group Id of the site ${url}`);
189
257
  }
190
258
  const requestOptions = {
191
259
  url: `${this.spoAdminUrl}/_vti_bin/client.svc/ProcessQuery`,
@@ -0,0 +1,48 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const request_1 = require("../../../../request");
4
+ const SpoCommand_1 = require("../../../base/SpoCommand");
5
+ const commands_1 = require("../../commands");
6
+ class SpoWebInstalledLanguageListCommand extends SpoCommand_1.default {
7
+ get name() {
8
+ return commands_1.default.WEB_INSTALLEDLANGUAGE_LIST;
9
+ }
10
+ get description() {
11
+ return 'Lists all installed languages on site';
12
+ }
13
+ defaultProperties() {
14
+ return ['DisplayName', 'LanguageTag', 'Lcid'];
15
+ }
16
+ commandAction(logger, args, cb) {
17
+ if (this.verbose) {
18
+ logger.logToStderr(`Retrieving all installed languages on site ${args.options.webUrl}...`);
19
+ }
20
+ const requestOptions = {
21
+ url: `${args.options.webUrl}/_api/web/RegionalSettings/InstalledLanguages`,
22
+ headers: {
23
+ 'accept': 'application/json;odata=nometadata'
24
+ },
25
+ responseType: 'json'
26
+ };
27
+ request_1.default
28
+ .get(requestOptions)
29
+ .then((webInstalledLanguageProperties) => {
30
+ logger.log(webInstalledLanguageProperties.Items);
31
+ cb();
32
+ }, (err) => this.handleRejectedODataJsonPromise(err, logger, cb));
33
+ }
34
+ options() {
35
+ const options = [
36
+ {
37
+ option: '-u, --webUrl <webUrl>'
38
+ }
39
+ ];
40
+ const parentOptions = super.options();
41
+ return options.concat(parentOptions);
42
+ }
43
+ validate(args) {
44
+ return SpoCommand_1.default.isValidSharePointUrl(args.options.webUrl);
45
+ }
46
+ }
47
+ module.exports = new SpoWebInstalledLanguageListCommand();
48
+ //# sourceMappingURL=web-installedlanguage-list.js.map
@@ -22,9 +22,10 @@ exports.default = {
22
22
  CDN_POLICY_SET: `${prefix} cdn policy set`,
23
23
  CDN_SET: `${prefix} cdn set`,
24
24
  CONTENTTYPE_ADD: `${prefix} contenttype add`,
25
- CONTENTTYPE_GET: `${prefix} contenttype get`,
26
25
  CONTENTTYPE_FIELD_REMOVE: `${prefix} contenttype field remove`,
27
26
  CONTENTTYPE_FIELD_SET: `${prefix} contenttype field set`,
27
+ CONTENTTYPE_GET: `${prefix} contenttype get`,
28
+ CONTENTTYPE_LIST: `${prefix} contenttype list`,
28
29
  CONTENTTYPE_REMOVE: `${prefix} contenttype remove`,
29
30
  CONTENTTYPEHUB_GET: `${prefix} contenttypehub get`,
30
31
  CUSTOMACTION_ADD: `${prefix} customaction add`,
@@ -245,6 +246,7 @@ exports.default = {
245
246
  WEB_ADD: `${prefix} web add`,
246
247
  WEB_CLIENTSIDEWEBPART_LIST: `${prefix} web clientsidewebpart list`,
247
248
  WEB_GET: `${prefix} web get`,
249
+ WEB_INSTALLEDLANGUAGE_LIST: `${prefix} web installedlanguage list`,
248
250
  WEB_LIST: `${prefix} web list`,
249
251
  WEB_REINDEX: `${prefix} web reindex`,
250
252
  WEB_REMOVE: `${prefix} web remove`,
@@ -22,7 +22,7 @@ class TeamsReportDirectroutingcallsCommand extends GraphCommand_1.default {
22
22
  commandAction(logger, args, cb) {
23
23
  const toDateTimeParameter = encodeURIComponent(args.options.toDateTime ? args.options.toDateTime : new Date().toISOString());
24
24
  const requestOptions = {
25
- url: `${this.resource}/beta/communications/callRecords/getDirectRoutingCalls(fromDateTime=${encodeURIComponent(args.options.fromDateTime)},toDateTime=${toDateTimeParameter})`,
25
+ url: `${this.resource}/v1.0/communications/callRecords/getDirectRoutingCalls(fromDateTime=${encodeURIComponent(args.options.fromDateTime)},toDateTime=${toDateTimeParameter})`,
26
26
  headers: {
27
27
  accept: 'application/json;odata.metadata=none'
28
28
  },
@@ -52,6 +52,9 @@ m365 aad app add [options]
52
52
  `--manifest [manifest]`
53
53
  : Azure AD app manifest as retrieved from the Azure Portal to create the app registration from
54
54
 
55
+ `--save`
56
+ : Use to store the information about the created app in a local file
57
+
55
58
  --8<-- "docs/cmd/_global.md"
56
59
 
57
60
  ## Remarks
@@ -80,6 +83,8 @@ When using the `withSecret` option, this command will automatically generate a s
80
83
 
81
84
  After creating the Azure AD app registration, this command returns the app ID and object ID of the created app registration. If you used the `withSecret` option, it will also return the generated secret.
82
85
 
86
+ If you want to store the information about the created Azure AD app registration, use the `--save` option. This is useful when you build solutions connected to Microsoft 365 and want to easily manage app registrations used with your solution. When you use the `--save` option, after you create the app registration, the command will write its ID and name to the `.m365rc.json` file in the current directory. If the file already exists, it will add the information about the to it, allowing you to track multiple apps. If the file doesn't exist, the command will create it.
87
+
83
88
  ## Examples
84
89
 
85
90
  Create new Azure AD app registration with the specified name
@@ -141,3 +146,9 @@ Create new Azure AD app registration with Application ID URI set to a value that
141
146
  ```sh
142
147
  m365 aad app add --name 'My AAD app' --uri api://caf406b91cd4.ngrok.io/_appId_ --scopeName access_as_user --scopeAdminConsentDescription 'Access as a user' --scopeAdminConsentDisplayName 'Access as a user' --scopeConsentBy adminsAndUsers
143
148
  ```
149
+
150
+ Create new Azure AD app registration with the specified name. Store information about the created app registration in the _.m365rc.json_ file in the current directory.
151
+
152
+ ```sh
153
+ m365 aad app add --name 'My AAD app' --save
154
+ ```
@@ -0,0 +1,48 @@
1
+ # aad app get
2
+
3
+ Gets an Azure AD app registration
4
+
5
+ ## Usage
6
+
7
+ ```sh
8
+ m365 aad app get [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ `--appId [appId]`
14
+ : Application (client) ID of the Azure AD application registration to get. Specify either `appId`, `objectId` or `name`
15
+
16
+ `--objectId [objectId]`
17
+ : Object ID of the Azure AD application registration to get. Specify either `appId`, `objectId` or `name`
18
+
19
+ `--name [name]`
20
+ : Name of the Azure AD application registration to get. Specify either `appId`, `objectId` or `name`
21
+
22
+ --8<-- "docs/cmd/_global.md"
23
+
24
+ ## Remarks
25
+
26
+ For best performance use the `objectId` option to reference the Azure AD application registration to update. If you use `appId` or `name`, this command will first need to find the corresponding object ID for that application.
27
+
28
+ If the command finds multiple Azure AD application registrations with the specified app name, it will prompt you to disambiguate which app it should use, listing the discovered object IDs.
29
+
30
+ ## Examples
31
+
32
+ Get the Azure AD application registration by its app (client) ID
33
+
34
+ ```sh
35
+ m365 aad app get --appId d75be2e1-0204-4f95-857d-51a37cf40be8
36
+ ```
37
+
38
+ Get the Azure AD application registration by its object ID
39
+
40
+ ```sh
41
+ m365 aad app get --objectId d75be2e1-0204-4f95-857d-51a37cf40be8
42
+ ```
43
+
44
+ Get the Azure AD application registration by its name
45
+
46
+ ```sh
47
+ m365 aad app get --name "My app"
48
+ ```
@@ -36,6 +36,7 @@ m365 aad o365group add [options]
36
36
  ## Remarks
37
37
 
38
38
  When specifying the path to the logo image you can use both relative and absolute paths. Note, that ~ in the path, will not be resolved and will most likely result in an error.
39
+ If an invalid user is provided in the comma-separated list or Owners or Members, the command operation will fail and the Micrsoft 365 Group will not be created.
39
40
 
40
41
  ## Examples
41
42
 
@@ -0,0 +1,53 @@
1
+ # aad sp add
2
+
3
+ Adds a service principal to a registered Azure AD app
4
+
5
+ ## Usage
6
+
7
+ ```sh
8
+ m365 aad sp add [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ `--appId [appId]`
14
+ : ID of the application to which the service principal should be added
15
+
16
+ `--appName [appName]`
17
+ : Display name of the application to which the service principal should be added
18
+
19
+ `--objectId [objectId]`
20
+ : ObjectId of the application to which the service principal should be added
21
+
22
+ --8<-- "docs/cmd/_global.md"
23
+
24
+ ## Remarks
25
+
26
+ Specify either the `appId`, `appName` or `objectId`. If you specify more than one option value, the command will fail with an error.
27
+
28
+ If you register an application in the portal, an application object as well as a service principal object are automatically created in your home tenant. If you register an application using CLI for Microsoft 365 or the Microsoft Graph, you'll need to create the service principal separately. To register/create an application using the CLI for Microsoft 365, use the [m365 aad app add](../app/app-add.md) command.
29
+
30
+ ## Examples
31
+
32
+ Adds a service principal to a registered Azure AD app with appId _b2307a39-e878-458b-bc90-03bc578531d6_.
33
+
34
+ ```sh
35
+ m365 aad sp add --appId b2307a39-e878-458b-bc90-03bc578531d6
36
+ ```
37
+
38
+ Adds a service principal to a registered Azure AD app with appName _Microsoft Graph_.
39
+
40
+ ```sh
41
+ m365 aad sp add --appName "Microsoft Graph"
42
+ ```
43
+
44
+ Adds a service principal to a registered Azure AD app with objectId _b2307a39-e878-458b-bc90-03bc578531d6_.
45
+
46
+ ```sh
47
+ m365 aad sp add --objectId b2307a39-e878-458b-bc90-03bc578531d6
48
+ ```
49
+
50
+ ## More information
51
+
52
+ - Application and service principal objects in Azure Active Directory (Azure AD): [https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-application-objects](https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-application-objects)
53
+ - Create servicePrincipal: [https://docs.microsoft.com/en-us/graph/api/serviceprincipal-post-serviceprincipals?view=graph-rest-1.0](https://docs.microsoft.com/en-us/graph/api/serviceprincipal-post-serviceprincipals?view=graph-rest-1.0)
@@ -0,0 +1,46 @@
1
+ # file list
2
+
3
+ Retrieves files from the specified folder and site
4
+
5
+ ## Usage
6
+
7
+ ```sh
8
+ m365 file list [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ `-u, --webUrl <webUrl>`
14
+ : The URL of the site where the folder from which to retrieve files is located
15
+
16
+ `-f, --folderUrl <folderUrl>`
17
+ : The server- or site-relative URL of the folder from which to retrieve files
18
+
19
+ `--recursive`
20
+ : Set to retrieve files from subfolders
21
+
22
+ --8<-- "docs/cmd/_global.md"
23
+
24
+ ## Remarks
25
+
26
+ This command is an improved version of the `spo file list` command. The main difference between the two commands is, that `file list` uses Microsoft Graph and properly supports retrieving files from large folders. Because `file list` uses Microsoft Graph and `spo file list` uses SharePoint REST APIs, the data returned by both commands is different.
27
+
28
+ ## Examples
29
+
30
+ Return all files from folder _Shared Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
31
+
32
+ ```sh
33
+ m365 file list --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents'
34
+ ```
35
+
36
+ Return all files from the folder _Shared Documents_ and all the sub-folders of _Shared Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_
37
+
38
+ ```sh
39
+ m365 file list --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents' --recursive
40
+ ```
41
+
42
+ Return all files from the _Important_ folder in the _Shared Documents_ document library located in site _https://contoso.sharepoint.com/sites/project-x_
43
+
44
+ ```sh
45
+ m365 file list --webUrl https://contoso.sharepoint.com/sites/project-x --folder 'Shared Documents/Important'
46
+ ```
@@ -0,0 +1,43 @@
1
+ # search externalconnection add
2
+
3
+ Add a new external connection to be defined for Microsoft Search
4
+
5
+ ## Usage
6
+
7
+ ```sh
8
+ m365 search externalconnection add [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ `-i, --id <id>`
14
+ : Developer-provided unique ID of the connection within the Azure Active Directory tenant
15
+
16
+ `-n, --name <name>`
17
+ : The display name of the connection to be displayed in the Microsoft 365 admin center. Maximum length of 128 characters
18
+
19
+ `-d, --description <description>`
20
+ : Description of the connection displayed in the Microsoft 365 admin center
21
+
22
+ `--authorizedAppIds [authorizedAppIds]`
23
+ : Comma-separated collection of application IDs for registered Azure Active Directory apps that are allowed to manage the external connection and to index content in the external connection.
24
+
25
+ --8<-- "docs/cmd/_global.md"
26
+
27
+ ## Remarks
28
+
29
+ The `id` must be at least 3 and no more than 32 characters long. It can contain only alphanumeric characters, can't begin with _Microsoft_ and can be any of the following values: *None, Directory, Exchange, ExchangeArchive, LinkedIn, Mailbox, OneDriveBusiness, SharePoint, Teams, Yammer, Connectors, TaskFabric, PowerBI, Assistant, TopicEngine, MSFT_All_Connectors*.
30
+
31
+ ## Examples
32
+
33
+ Adds a new external connection with name and description of test
34
+
35
+ ```sh
36
+ m365 search externalconnection add --id MyApp --name "My application" --description "Description of your application"
37
+ ```
38
+
39
+ Adds a new external connection with a limited number of authorized apps
40
+
41
+ ```sh
42
+ m365 search externalconnection add --id MyApp --name "My application" --description "Description of your application" --authorizedAppIds "00000000-0000-0000-0000-000000000000,00000000-0000-0000-0000-000000000001,00000000-0000-0000-0000-000000000002"
43
+ ```
@@ -32,7 +32,7 @@ m365 spfx project upgrade [options]
32
32
 
33
33
  ## Remarks
34
34
 
35
- The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.13.0).
35
+ The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.13.1).
36
36
 
37
37
  This command doesn't change your project files. Instead, it gives you a report with all steps necessary to upgrade your project to the specified version of the SharePoint Framework. Changing project files is error-prone, especially when it comes to updating your solution's code. This is why at this moment, this command produces a report that you can use yourself to perform the necessary updates and verify that everything is working as expected.
38
38
 
@@ -0,0 +1,33 @@
1
+ # spo contenttype list
2
+
3
+ Lists content types from specified site
4
+
5
+ ## Usage
6
+
7
+ ```sh
8
+ m365 spo contenttype list [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ `-u, --webUrl <webUrl>`
14
+ : Absolute URL of the site for which to list content types
15
+
16
+ `-c, --category [category]`
17
+ : Category name of content types. When defined will return only content types from specified category
18
+
19
+ --8<-- "docs/cmd/_global.md"
20
+
21
+ ## Examples
22
+
23
+ Retrieve site content types
24
+
25
+ ```PowerShell
26
+ m365 spo contenttype list --webUrl "https://contoso.sharepoint.com/sites/contoso-sales"
27
+ ```
28
+
29
+ Retrieve site content types from the 'List Content Types' category
30
+
31
+ ```PowerShell
32
+ m365 spo contenttype list --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --category "List Content Types"
33
+ ```
@@ -22,6 +22,9 @@ m365 spo list get [options]
22
22
  `-p, --properties [properties]`
23
23
  : Comma-separated list of properties to retrieve from the list. Will retrieve all properties possible from default response, if not specified.
24
24
 
25
+ `--withPermissions`
26
+ : Set if you want to return associated roles and permissions of the list.
27
+
25
28
  --8<-- "docs/cmd/_global.md"
26
29
 
27
30
  ## Examples
@@ -44,6 +47,12 @@ Get information about a list returning the specified list properties
44
47
  m365 spo list get --title Documents --webUrl https://contoso.sharepoint.com/sites/project-x --properties "Title,Id,HasUniqueRoleAssignments,AllowContentTypes"
45
48
  ```
46
49
 
50
+ Get information about a list along with the roles and permissions
51
+
52
+ ```sh
53
+ m365 spo list get --title Documents --webUrl https://contoso.sharepoint.com/sites/project-x --withPermissions
54
+ ```
55
+
47
56
  ## More information
48
57
 
49
58
  - List REST API resources: [https://msdn.microsoft.com/en-us/library/office/dn531433.aspx#bk_ListEndpoint](https://msdn.microsoft.com/en-us/library/office/dn531433.aspx#bk_ListEndpoint)
@@ -20,10 +20,10 @@ m365 spo page add [options]
20
20
  : Title of the page to create. If not specified, will use the page name as its title
21
21
 
22
22
  `-l, --layoutType [layoutType]`
23
- : Layout of the page. Allowed values `Article,Home`. Default `Article`
23
+ : Layout of the page. Allowed values `Article`, `Home`, `SingleWebPartAppPage`, `RepostPage`,`HeaderlessSearchResults`, `Spaces`, `Topic`. Default `Article`
24
24
 
25
25
  `-p, --promoteAs [promoteAs]`
26
- : Create the page for a specific purpose. Allowed values `HomePage,NewsPage`
26
+ : Create the page for a specific purpose. Allowed values `HomePage`, `NewsPage`
27
27
 
28
28
  `--commentsEnabled`
29
29
  : Set to enable comments on the page
@@ -17,13 +17,13 @@ m365 spo page set [options]
17
17
  : URL of the site where the page to update is located
18
18
 
19
19
  `-l, --layoutType [layoutType]`
20
- : Layout of the page. Allowed values `Article,Home`
20
+ : Layout of the page. Allowed values `Article`, `Home`, `SingleWebPartAppPage`, `RepostPage`,`HeaderlessSearchResults`, `Spaces`, `Topic`
21
21
 
22
22
  `-p, --promoteAs [promoteAs]`
23
- : Update the page purpose. Allowed values `HomePage,NewsPage`
23
+ : Update the page purpose. Allowed values `HomePage`, `NewsPage`
24
24
 
25
25
  `--commentsEnabled [commentsEnabled]`
26
- : Set to `true`, to enable comments on the page. Allowed values `true,false`
26
+ : Set to `true`, to enable comments on the page. Allowed values `true`, `false`
27
27
 
28
28
  `--publish`
29
29
  : Set to publish the page
@@ -34,7 +34,9 @@ m365 spo site remove [options]
34
34
 
35
35
  Deleting a site collection is by default asynchronous and depending on the current state of Microsoft 365, might take up to few minutes. If you're building a script with steps that require the site to be fully deleted, you should use the `--wait` flag. When using this flag, the `spo site remove` command will keep running until it received confirmation from Microsoft 365 that the site has been fully deleted.
36
36
 
37
- If the site which you have selected to remove is groupified (Modern Team Site), flags `--fromRecycleBin`, `--skipRecycleBin` and `--wait` will not be applicable
37
+ If the site which you have selected to remove is groupified (Modern Team Site) and group exists, flags `--skipRecycleBin` and `--wait` will not be applicable. If the linked group still exists in the deleted groups, the site won't be removed. If the linked group is permanently deleted, the site will be removed like any classic site (except that flag `--wait` only will still not be applicable).
38
+
39
+ If the argument `--fromRecycleBin` is passed, the selected site will be permanently removed even if it's a groupified one.
38
40
 
39
41
  ## Examples
40
42
 
@@ -0,0 +1,24 @@
1
+ # spo web installedlanguage list
2
+
3
+ Lists all installed languages on site
4
+
5
+ ## Usage
6
+
7
+ ```sh
8
+ m365 spo web installedlanguage list [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ `-u, --webUrl <webUrl>`
14
+ : URL of the site for which to retrieve the list of installed languages
15
+
16
+ --8<-- "docs/cmd/_global.md"
17
+
18
+ ## Examples
19
+
20
+ Return all installed languages from site _https://contoso.sharepoint.com/_
21
+
22
+ ```sh
23
+ m365 spo web installedlanguage list --webUrl https://contoso.sharepoint.com
24
+ ```
@@ -24,9 +24,6 @@ This command only works with app-only permissions. You will need to create your
24
24
 
25
25
  The difference between `fromDateTime` and `toDateTime` cannot exceed a period of 90 days
26
26
 
27
- !!! attention
28
- This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
29
-
30
27
  ## Examples
31
28
 
32
29
  Get details about direct routing calls made between 2020-10-31 and today