@pnp/cli-microsoft365 10.4.0-beta.c93f9cd → 10.5.0-beta.31bfdff

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 (25) hide show
  1. package/.eslintrc.cjs +1 -0
  2. package/README.md +2 -2
  3. package/allCommands.json +1 -1
  4. package/allCommandsFull.json +1 -1
  5. package/dist/Command.js +1 -1
  6. package/dist/appInsights.js +2 -0
  7. package/dist/cli/cli.js +1 -1
  8. package/dist/m365/graph/commands/directoryextension/directoryextension-add.js +85 -0
  9. package/dist/m365/graph/commands/directoryextension/directoryextension-get.js +82 -0
  10. package/dist/m365/graph/commands/directoryextension/directoryextension-remove.js +93 -0
  11. package/dist/m365/graph/commands.js +3 -0
  12. package/dist/m365/spo/commands/page/page-header-set.js +47 -10
  13. package/dist/m365/spo/commands/page/page-section-remove.js +81 -0
  14. package/dist/m365/spo/commands.js +1 -0
  15. package/dist/request.js +5 -0
  16. package/dist/telemetry.js +21 -17
  17. package/dist/utils/directoryExtension.js +25 -0
  18. package/dist/utils/entraApp.js +28 -0
  19. package/docs/docs/cmd/graph/directoryextension/directoryextension-add.mdx +123 -0
  20. package/docs/docs/cmd/graph/directoryextension/directoryextension-get.mdx +118 -0
  21. package/docs/docs/cmd/graph/directoryextension/directoryextension-remove.mdx +57 -0
  22. package/docs/docs/cmd/spo/page/page-section-remove.mdx +47 -0
  23. package/npm-shrinkwrap.json +12 -10
  24. package/package.json +2 -2
  25. package/dist/telemetryRunner.js +0 -26
package/docs/docs/cmd/graph/directoryextension/directoryextension-add.mdx ADDED
@@ -0,0 +1,123 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # graph directoryextension add
6
+
7
+ Creates a new directory extension
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 graph directoryextension add [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ ```md definition-list
18
+ `-n, --name <name>`
19
+ : The name of the directory extension.
20
+
21
+ `--appId [appId]`
22
+ : Application (client) ID of the Entra application where the directory extension is registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
23
+
24
+ `--appObjectId [appObjectId]`
25
+ : Object ID of the Entra application where the directory extension is registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
26
+
27
+ `--appName [appName]`
28
+ : The name of Entra application where the directory extension is registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
29
+
30
+ `--dataType <dataType>`
31
+ : The data type of the value the extension property can hold. Possible values are: `Binary`, `Boolean`, `DateTime`, `Integer`, `LargeInteger` and `String`.
32
+
33
+ `--targetObjects <targetObjects>`
34
+ : Comma-separated list of Microsoft Graph resources that can use the extension. Possible values are: `User`, `Group`, `Application`, `AdministrativeUnit`, `Device` and `Organization`.
35
+
36
+ `--isMultiValued`
37
+ : Defines the directory extension as a multi-valued property.
38
+ ```
39
+
40
+ <Global />
41
+
42
+ ## Examples
43
+
44
+ Create a new directory extension of string type defined for user resource.
45
+
46
+ ```sh
47
+ m365 graph directoryextension add --name gitHubWorkAccountName --appName ContosoApp --targetObjects User --dataType String
48
+ ```
49
+
50
+ Create a new multi-valued directory extension of integer type defined for device and application resource
51
+
52
+ ```sh
53
+ m365 graph directoryextension add --name departmentIds --appId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --targetObjects 'Application,Device' --dataType Integer --isMultiValued
54
+ ```
55
+
56
+ ## Response
57
+
58
+ <Tabs>
59
+ <TabItem value="JSON">
60
+
61
+ ```json
62
+ {
63
+ "id": "522817ae-5c95-4243-96c1-f85231fcbc1f",
64
+ "deletedDateTime": null,
65
+ "appDisplayName": "ContosoApp",
66
+ "dataType": "String",
67
+ "isMultiValued": false,
68
+ "isSyncedFromOnPremises": false,
69
+ "name": "extension_105be60b603845fea385e58772d9d630_githubworkaccount",
70
+ "targetObjects": [
71
+ "User"
72
+ ]
73
+ }
74
+ ```
75
+
76
+ </TabItem>
77
+ <TabItem value="Text">
78
+
79
+ ```text
80
+ appDisplayName : ContosoApp
81
+ dataType : String
82
+ deletedDateTime : null
83
+ id : 01e77f60-3dde-4fa3-825b-cac8048994a8
84
+ isMultiValued : false
85
+ isSyncedFromOnPremises: false
86
+ name : extension_105be60b603845fea385e58772d9d630_githubworkaccount
87
+ targetObjects : ["User"]
88
+ ```
89
+
90
+ </TabItem>
91
+ <TabItem value="CSV">
92
+
93
+ ```csv
94
+ id,deletedDateTime,appDisplayName,dataType,isMultiValued,isSyncedFromOnPremises,name
95
+ b0937b01-49ce-45c7-a52a-727954f092ea,,ContosoApp,String,,,extension_105be60b603845fea385e58772d9d630_githubworkaccount
96
+ ```
97
+
98
+ </TabItem>
99
+ <TabItem value="Markdown">
100
+
101
+ ```md
102
+ # graph directoryextension add --debug "false" --verbose "false" --name "githubworkaccount" --appName "ContosoApp" --dataType "String" --targetObjects "User"
103
+
104
+ Date: 9/8/2024
105
+
106
+ ## extension_105be60b603845fea385e58772d9d630_githubworkaccount (cec3c38e-3f4a-4ca8-9523-afa47016f51b)
107
+
108
+ Property | Value|
109
+ ---------|-------|
110
+ id | cec3c38e-3f4a-4ca8-9523-afa47016f51b
111
+ appDisplayName | ContosoApp
112
+ dataType | String
113
+ isMultiValued | false
114
+ isSyncedFromOnPremises | false
115
+ name | extension\_105be60b603845fea385e58772d9d630\_githubworkaccount
116
+ ```
117
+
118
+ </TabItem>
119
+ </Tabs>
120
+
121
+ ## More information
122
+
123
+ - Directory extensions: https://learn.microsoft.com/graph/extensibility-overview#directory-microsoft-entra-id-extensions
package/docs/docs/cmd/graph/directoryextension/directoryextension-get.mdx ADDED
@@ -0,0 +1,118 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # graph directoryextension get
6
+
7
+ Retrieves the definition of a directory extension
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 graph directoryextension get [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ ```md definition-list
18
+ `-i, --id [id]`
19
+ : The ID of the directory extension. Specify either `id` or `name`, but not both.
20
+
21
+ `-n, --name [name]`
22
+ : The name of the directory extension. Specify either `id` or `name`, but not both.
23
+
24
+ `--appId [appId]`
25
+ : Application (client) ID of the Entra application where the directory extension is registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
26
+
27
+ `--appObjectId [appObjectId]`
28
+ : Object ID of the Entra application where the directory extension is registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
29
+
30
+ `--appName [appName]`
31
+ : The name of Entra application where the directory extension is registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
32
+ ```
33
+
34
+ <Global />
35
+
36
+ ## Examples
37
+
38
+ Get directory extension by id registered for an application specified by app id.
39
+
40
+ ```sh
41
+ m365 directoryextension get --id 1f0f15e3-925d-40f0-8fc8-9d3ad135bce0 --appId fd918e4b-c821-4efb-b50a-5eddd23afc6f
42
+ ```
43
+
44
+ Get directory extension by name registered for an application specified by name.
45
+
46
+ ```sh
47
+ m365 directoryextension get --name extension_105be60b603845fea385e58772d9d630_GitHubWorkAccount --appName ContosoApp
48
+ ```
49
+
50
+
51
+ ## Response
52
+
53
+ <Tabs>
54
+ <TabItem value="JSON">
55
+
56
+ ```json
57
+ {
58
+ "id": "522817ae-5c95-4243-96c1-f85231fcbc1f",
59
+ "deletedDateTime": null,
60
+ "appDisplayName": "ContosoApp",
61
+ "dataType": "String",
62
+ "isMultiValued": false,
63
+ "isSyncedFromOnPremises": false,
64
+ "name": "extension_105be60b603845fea385e58772d9d630_githubworkaccount",
65
+ "targetObjects": [
66
+ "User"
67
+ ]
68
+ }
69
+ ```
70
+
71
+ </TabItem>
72
+ <TabItem value="Text">
73
+
74
+ ```text
75
+ appDisplayName : ContosoApp
76
+ dataType : String
77
+ deletedDateTime : null
78
+ id : 01e77f60-3dde-4fa3-825b-cac8048994a8
79
+ isMultiValued : false
80
+ isSyncedFromOnPremises: false
81
+ name : extension_105be60b603845fea385e58772d9d630_githubworkaccount
82
+ targetObjects : ["User"]
83
+ ```
84
+
85
+ </TabItem>
86
+ <TabItem value="CSV">
87
+
88
+ ```csv
89
+ id,deletedDateTime,appDisplayName,dataType,isMultiValued,isSyncedFromOnPremises,name
90
+ b0937b01-49ce-45c7-a52a-727954f092ea,,ContosoApp,String,,,extension_105be60b603845fea385e58772d9d630_githubworkaccount
91
+ ```
92
+
93
+ </TabItem>
94
+ <TabItem value="Markdown">
95
+
96
+ ```md
97
+ # graph directoryextension add --debug "false" --verbose "false" --name "githubworkaccount" --appName "ContosoApp" --dataType "String" --targetObjects "User"
98
+
99
+ Date: 3/2/2025
100
+
101
+ ## extension_105be60b603845fea385e58772d9d630_githubworkaccount (cec3c38e-3f4a-4ca8-9523-afa47016f51b)
102
+
103
+ Property | Value|
104
+ ---------|-------|
105
+ id | cec3c38e-3f4a-4ca8-9523-afa47016f51b
106
+ appDisplayName | ContosoApp
107
+ dataType | String
108
+ isMultiValued | false
109
+ isSyncedFromOnPremises | false
110
+ name | extension\_105be60b603845fea385e58772d9d630\_githubworkaccount
111
+ ```
112
+
113
+ </TabItem>
114
+ </Tabs>
115
+
116
+ ## More information
117
+
118
+ - Directory extensions: https://learn.microsoft.com/graph/extensibility-overview#directory-microsoft-entra-id-extensions
package/docs/docs/cmd/graph/directoryextension/directoryextension-remove.mdx ADDED
@@ -0,0 +1,57 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+
3
+ # graph directoryextension remove
4
+
5
+ Removes a directory extension
6
+
7
+ ## Usage
8
+
9
+ ```sh
10
+ m365 graph directoryextension remove [options]
11
+ ```
12
+
13
+ ## Options
14
+
15
+ ```md definition-list
16
+ `-i, --id [id]`
17
+ : The ID of the directory extension to remove. Specify either `id` or `name`, but not both.
18
+
19
+ `-n, --name [name]`
20
+ : The name of the directory extension to remove. Specify either `id` or `name`, but not both.
21
+
22
+ `--appId [appId]`
23
+ : Application (client) ID of the Entra application where the directory extension is registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
24
+
25
+ `--appObjectId [appObjectId]`
26
+ : Object ID of the Entra application where the directory extension is registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
27
+
28
+ `--appName [appName]`
29
+ : The name of Entra application where the directory extension is registered. Specify either `appId`, `appObjectId` or `appName`, but not multiple.
30
+
31
+ `-f, --force`
32
+ : Don't prompt for confirmation before removing the directory extension
33
+ ```
34
+
35
+ <Global />
36
+
37
+ ## Examples
38
+
39
+ Remove a directory extension specified by name from an application specified by app object id and don't prompt for confirmation
40
+
41
+ ```sh
42
+ m365 graph directoryextension remove --name extension_105be60b603845fea385e58772d9d630_githubworkaccount --appObjectId 1caf7dcd-7e83-4c3a-94f7-932a1299c844 --force
43
+ ```
44
+
45
+ Remove a directory extension specified by id from an application specified by app name and don't prompt for confirmation
46
+
47
+ ```sh
48
+ m365 graph directoryextension remove --id 522817ae-5c95-4243-96c1-f85231fcbc1f --appName ContosoApp
49
+ ```
50
+
51
+ ## Response
52
+
53
+ The command won't return a response on success.
54
+
55
+ ## More information
56
+
57
+ - Directory extensions: https://learn.microsoft.com/graph/extensibility-overview#directory-microsoft-entra-id-extensions
package/docs/docs/cmd/spo/page/page-section-remove.mdx ADDED
@@ -0,0 +1,47 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # spo page section remove
6
+
7
+ Removes the specified section from a modern page
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 spo page section remove [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ ```md definition-list
18
+ `-u, --webUrl <webUrl>`
19
+ : URL of the site where the page is located.
20
+
21
+ `-n, --pageName <pageName>`
22
+ : Name of the page from which to remove a section.
23
+
24
+ `-s, --section <section>`
25
+ : ID of the section to be removed.
26
+
27
+ `-f, --force`
28
+ : Don't prompt for confirmation.
29
+ ```
30
+
31
+ <Global />
32
+
33
+ ## Remarks
34
+
35
+ If the specified `pageName` doesn't refer to an existing modern page, you will get a _File doesn't exists_ error.
36
+
37
+ ## Examples
38
+
39
+ Remove section of a modern page
40
+
41
+ ```sh
42
+ m365 spo page section remove --webUrl https://contoso.sharepoint.com/sites/team-a --pageName home.aspx --section 1
43
+ ```
44
+
45
+ ## Response
46
+
47
+ The command won't return a response on success.
package/npm-shrinkwrap.json CHANGED
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "name": "@pnp/cli-microsoft365",
3
- "version": "10.4.0",
3
+ "version": "10.5.0",
4
4
  "lockfileVersion": 3,
5
5
  "requires": true,
6
6
  "packages": {
7
7
  "": {
8
8
  "name": "@pnp/cli-microsoft365",
9
- "version": "10.4.0",
9
+ "version": "10.5.0",
10
10
  "license": "MIT",
11
11
  "dependencies": {
12
12
  "@azure/msal-common": "^15.1.0",
@@ -55,7 +55,7 @@
55
55
  "@types/json-schema": "^7.0.15",
56
56
  "@types/json-to-ast": "^2.1.4",
57
57
  "@types/mocha": "^10.0.10",
58
- "@types/node": "^20.17.16",
58
+ "@types/node": "^22.13.4",
59
59
  "@types/node-forge": "^1.3.11",
60
60
  "@types/omelette": "^0.4.4",
61
61
  "@types/semver": "^7.5.8",
@@ -1880,11 +1880,12 @@
1880
1880
  }
1881
1881
  },
1882
1882
  "node_modules/@types/node": {
1883
- "version": "20.17.16",
1884
- "resolved": "https://registry.npmjs.org/@types/node/-/node-20.17.16.tgz",
1885
- "integrity": "sha512-vOTpLduLkZXePLxHiHsBLp98mHGnl8RptV4YAO3HfKO5UHjDvySGbxKtpYfy8Sx5+WKcgc45qNreJJRVM3L6mw==",
1883
+ "version": "22.13.4",
1884
+ "resolved": "https://registry.npmjs.org/@types/node/-/node-22.13.4.tgz",
1885
+ "integrity": "sha512-ywP2X0DYtX3y08eFVx5fNIw7/uIv8hYUKgXoK8oayJlLnKcRfEYCxWMVE1XagUdVtCJlZT1AU4LXEABW+L1Peg==",
1886
+ "license": "MIT",
1886
1887
  "dependencies": {
1887
- "undici-types": "~6.19.2"
1888
+ "undici-types": "~6.20.0"
1888
1889
  }
1889
1890
  },
1890
1891
  "node_modules/@types/node-forge": {
@@ -5959,9 +5960,10 @@
5959
5960
  }
5960
5961
  },
5961
5962
  "node_modules/undici-types": {
5962
- "version": "6.19.8",
5963
- "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.19.8.tgz",
5964
- "integrity": "sha512-ve2KP6f/JnbPBFyobGHuerC9g1FYGn/F8n1LWTwNxCEzd6IfqTwUQcNXgEtmmQ6DlRrC1hrSrBnCZPokRrDHjw=="
5963
+ "version": "6.20.0",
5964
+ "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.20.0.tgz",
5965
+ "integrity": "sha512-Ny6QZ2Nju20vw1SRHe3d9jVu6gJ+4e3+MMpqu7pqE5HT6WsTSlce++GQmK5UXS8mzV8DSYHrQH+Xrf2jVcuKNg==",
5966
+ "license": "MIT"
5965
5967
  },
5966
5968
  "node_modules/update-notifier": {
5967
5969
  "version": "7.3.1",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pnp/cli-microsoft365",
3
- "version": "10.4.0-beta.c93f9cd",
3
+ "version": "10.5.0-beta.31bfdff",
4
4
  "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
5
5
  "license": "MIT",
6
6
  "main": "./dist/api.js",
@@ -293,7 +293,7 @@
293
293
  "@types/json-schema": "^7.0.15",
294
294
  "@types/json-to-ast": "^2.1.4",
295
295
  "@types/mocha": "^10.0.10",
296
- "@types/node": "^20.17.16",
296
+ "@types/node": "^22.13.4",
297
297
  "@types/node-forge": "^1.3.11",
298
298
  "@types/omelette": "^0.4.4",
299
299
  "@types/semver": "^7.5.8",
package/dist/telemetryRunner.js DELETED
@@ -1,26 +0,0 @@
1
- import appInsights from './appInsights.js';
2
- import * as process from 'process';
3
- import * as fs from 'fs';
4
- process.stdin.setEncoding('utf8');
5
- try {
6
- // read from stdin
7
- const input = fs.readFileSync(0, 'utf-8');
8
- const data = JSON.parse(input);
9
- const { commandName, properties, exception, shell, session } = data;
10
- appInsights.commonProperties.shell = shell;
11
- appInsights.context.tags[appInsights.context.keys.sessionId] = session;
12
- if (exception) {
13
- appInsights.trackException({
14
- exception
15
- });
16
- }
17
- else {
18
- appInsights.trackEvent({
19
- name: commandName,
20
- properties
21
- });
22
- }
23
- await appInsights.flush();
24
- }
25
- catch { }
26
- //# sourceMappingURL=telemetryRunner.js.map