@pnp/cli-microsoft365 7.5.0 → 7.6.0-beta.480812d
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.
- package/.eslintrc.cjs +3 -0
- package/README.md +1 -1
- package/allCommands.json +1 -1
- package/allCommandsFull.json +1 -1
- package/dist/Auth.js +12 -10
- package/dist/AuthServer.js +1 -1
- package/dist/cli/cli.js +1 -1
- package/dist/config.js +2 -2
- package/dist/m365/app/commands/app-get.js +1 -1
- package/dist/m365/app/commands/app-open.js +1 -1
- package/dist/m365/app/commands/permission/permission-add.js +2 -2
- package/dist/m365/app/commands/permission/permission-list.js +2 -2
- package/dist/m365/cli/commands/cli-consent.js +2 -2
- package/dist/m365/cli/commands/cli-reconsent.js +3 -3
- package/dist/m365/commands/login.js +1 -1
- package/dist/m365/entra/commands/administrativeunit/administrativeunit-add.js +1 -0
- package/dist/m365/entra/commands/administrativeunit/administrativeunit-get.js +1 -0
- package/dist/m365/entra/commands/administrativeunit/administrativeunit-list.js +1 -0
- package/dist/m365/entra/commands/administrativeunit/administrativeunit-member-add.js +1 -0
- package/dist/m365/entra/commands/administrativeunit/administrativeunit-member-get.js +1 -0
- package/dist/m365/entra/commands/administrativeunit/administrativeunit-member-list.js +1 -0
- package/dist/m365/entra/commands/administrativeunit/administrativeunit-remove.js +1 -0
- package/dist/m365/entra/commands/app/app-add.js +7 -6
- package/dist/m365/entra/commands/app/app-get.js +4 -3
- package/dist/m365/entra/commands/app/app-list.js +1 -0
- package/dist/m365/entra/commands/app/app-permission-add.js +3 -2
- package/dist/m365/entra/commands/app/app-permission-list.js +1 -1
- package/dist/m365/entra/commands/app/app-remove.js +5 -4
- package/dist/m365/entra/commands/app/app-role-add.js +6 -5
- package/dist/m365/entra/commands/app/app-role-list.js +4 -3
- package/dist/m365/entra/commands/app/app-role-remove.js +6 -5
- package/dist/m365/entra/commands/app/app-set.js +8 -7
- package/dist/m365/entra/commands/approleassignment/approleassignment-add.js +2 -1
- package/dist/m365/entra/commands/approleassignment/approleassignment-list.js +1 -0
- package/dist/m365/entra/commands/approleassignment/approleassignment-remove.js +1 -0
- package/dist/m365/entra/commands/enterpriseapp/enterpriseapp-add.js +1 -0
- package/dist/m365/entra/commands/enterpriseapp/enterpriseapp-get.js +1 -0
- package/dist/m365/entra/commands/enterpriseapp/enterpriseapp-list.js +1 -0
- package/dist/m365/entra/commands/group/group-get.js +1 -0
- package/dist/m365/entra/commands/group/group-list.js +1 -0
- package/dist/m365/entra/commands/group/group-remove.js +1 -0
- package/dist/m365/entra/commands/group/group-user-list.js +1 -0
- package/dist/m365/entra/commands/groupsetting/groupsetting-add.js +1 -0
- package/dist/m365/entra/commands/groupsetting/groupsetting-get.js +1 -0
- package/dist/m365/entra/commands/groupsetting/groupsetting-list.js +1 -0
- package/dist/m365/entra/commands/groupsetting/groupsetting-remove.js +1 -0
- package/dist/m365/entra/commands/groupsetting/groupsetting-set.js +1 -0
- package/dist/m365/entra/commands/groupsettingtemplate/groupsettingtemplate-get.js +1 -0
- package/dist/m365/entra/commands/groupsettingtemplate/groupsettingtemplate-list.js +1 -0
- package/dist/m365/entra/commands/license/license-list.js +1 -0
- package/dist/m365/entra/commands/m365group/m365group-add.js +1 -0
- package/dist/m365/entra/commands/m365group/m365group-conversation-list.js +1 -0
- package/dist/m365/entra/commands/m365group/m365group-conversation-post-list.js +1 -0
- package/dist/m365/entra/commands/m365group/m365group-get.js +1 -0
- package/dist/m365/entra/commands/m365group/m365group-list.js +1 -0
- package/dist/m365/entra/commands/m365group/m365group-recyclebinitem-clear.js +1 -0
- package/dist/m365/entra/commands/m365group/m365group-recyclebinitem-list.js +1 -0
- package/dist/m365/entra/commands/m365group/m365group-recyclebinitem-remove.js +1 -0
- package/dist/m365/entra/commands/m365group/m365group-recyclebinitem-restore.js +1 -0
- package/dist/m365/entra/commands/m365group/m365group-remove.js +1 -0
- package/dist/m365/entra/commands/m365group/m365group-renew.js +1 -0
- package/dist/m365/entra/commands/m365group/m365group-set.js +1 -0
- package/dist/m365/entra/commands/m365group/m365group-teamify.js +1 -0
- package/dist/m365/entra/commands/m365group/m365group-user-add.js +1 -0
- package/dist/m365/entra/commands/m365group/m365group-user-list.js +1 -0
- package/dist/m365/entra/commands/m365group/m365group-user-remove.js +1 -0
- package/dist/m365/entra/commands/m365group/m365group-user-set.js +1 -0
- package/dist/m365/entra/commands/oauth2grant/oauth2grant-add.js +1 -0
- package/dist/m365/entra/commands/oauth2grant/oauth2grant-list.js +1 -0
- package/dist/m365/entra/commands/oauth2grant/oauth2grant-remove.js +1 -0
- package/dist/m365/entra/commands/oauth2grant/oauth2grant-set.js +1 -0
- package/dist/m365/entra/commands/policy/policy-list.js +1 -0
- package/dist/m365/entra/commands/siteclassification/siteclassification-disable.js +1 -0
- package/dist/m365/entra/commands/siteclassification/siteclassification-enable.js +1 -0
- package/dist/m365/entra/commands/siteclassification/siteclassification-get.js +1 -0
- package/dist/m365/entra/commands/siteclassification/siteclassification-set.js +1 -0
- package/dist/m365/entra/commands/user/user-add.js +1 -0
- package/dist/m365/entra/commands/user/user-get.js +1 -0
- package/dist/m365/entra/commands/user/user-guest-add.js +1 -0
- package/dist/m365/entra/commands/user/user-hibp.js +1 -0
- package/dist/m365/entra/commands/user/user-license-add.js +1 -0
- package/dist/m365/entra/commands/user/user-license-list.js +1 -0
- package/dist/m365/entra/commands/user/user-license-remove.js +1 -0
- package/dist/m365/entra/commands/user/user-list.js +1 -0
- package/dist/m365/entra/commands/user/user-password-validate.js +1 -0
- package/dist/m365/entra/commands/user/user-recyclebinitem-clear.js +1 -0
- package/dist/m365/entra/commands/user/user-recyclebinitem-list.js +1 -0
- package/dist/m365/entra/commands/user/user-recyclebinitem-remove.js +2 -1
- package/dist/m365/entra/commands/user/user-recyclebinitem-restore.js +1 -0
- package/dist/m365/entra/commands/user/user-remove.js +1 -0
- package/dist/m365/entra/commands/user/user-set.js +1 -0
- package/dist/m365/entra/commands/user/user-signin-list.js +1 -0
- package/dist/m365/outlook/commands/message/message-remove.js +113 -0
- package/dist/m365/outlook/commands.js +1 -0
- package/dist/m365/pp/commands/managementapp/managementapp-add.js +7 -7
- package/dist/m365/purview/commands/threatassessment/threatassessment-add.js +123 -0
- package/dist/m365/purview/commands/threatassessment/threatassessment-list.js +104 -0
- package/dist/m365/purview/commands.js +3 -1
- package/dist/m365/spfx/commands/project/DeployWorkflow.js +111 -0
- package/dist/m365/spfx/commands/project/project-azuredevops-pipeline-add.js +183 -0
- package/dist/m365/spfx/commands/project/project-azuredevops-pipeline-model.js +2 -0
- package/dist/m365/spfx/commands/project/project-github-workflow-add.js +3 -4
- package/dist/m365/spfx/commands.js +1 -0
- package/dist/m365/spo/commands/folder/FolderColor.js +19 -0
- package/dist/m365/spo/commands/folder/folder-add.js +46 -17
- package/dist/m365/spo/commands/folder/folder-set.js +118 -0
- package/dist/m365/spo/commands/group/group-member-add.js +2 -2
- package/dist/m365/spo/commands/group/group-member-remove.js +1 -1
- package/dist/m365/spo/commands/site/site-apppermission-add.js +2 -2
- package/dist/m365/spo/commands/site/site-recyclebinitem-restore.js +66 -27
- package/dist/m365/spo/commands/tenant/tenant-settings-set.js +1 -1
- package/dist/m365/spo/commands/user/user-remove.js +93 -16
- package/dist/m365/spo/commands.js +1 -0
- package/dist/m365/teams/commands/tab/tab-get.js +1 -1
- package/dist/utils/spo.js +1 -1
- package/docs/docs/cmd/app/app-get.mdx +10 -10
- package/docs/docs/cmd/app/app-open.mdx +6 -6
- package/docs/docs/cmd/app/permission/permission-add.mdx +2 -2
- package/docs/docs/cmd/app/permission/permission-list.mdx +5 -5
- package/docs/docs/cmd/cli/cli-consent.mdx +2 -2
- package/docs/docs/cmd/cli/cli-reconsent.mdx +6 -6
- package/docs/docs/cmd/entra/app/app-permission-add.mdx +6 -6
- package/docs/docs/cmd/entra/approleassignment/approleassignment-add.mdx +1 -1
- package/docs/docs/cmd/entra/approleassignment/approleassignment-list.mdx +4 -4
- package/docs/docs/cmd/entra/enterpriseapp/enterpriseapp-add.mdx +1 -1
- package/docs/docs/cmd/entra/enterpriseapp/enterpriseapp-get.mdx +1 -1
- package/docs/docs/cmd/entra/group/group-user-add.mdx +7 -7
- package/docs/docs/cmd/entra/oauth2grant/oauth2grant-add.mdx +1 -1
- package/docs/docs/cmd/entra/oauth2grant/oauth2grant-list.mdx +1 -1
- package/docs/docs/cmd/entra/oauth2grant/oauth2grant-remove.mdx +1 -1
- package/docs/docs/cmd/entra/oauth2grant/oauth2grant-set.mdx +1 -1
- package/docs/docs/cmd/external/connection/connection-add.mdx +2 -2
- package/docs/docs/cmd/file/file-add.mdx +1 -1
- package/docs/docs/cmd/graph/schemaextension/schemaextension-add.mdx +2 -2
- package/docs/docs/cmd/graph/schemaextension/schemaextension-set.mdx +1 -1
- package/docs/docs/cmd/login.mdx +18 -18
- package/docs/docs/cmd/outlook/message/message-remove.mdx +67 -0
- package/docs/docs/cmd/pa/app/app-owner-set.mdx +1 -1
- package/docs/docs/cmd/pa/app/app-permission-ensure.mdx +3 -3
- package/docs/docs/cmd/pa/app/app-permission-remove.mdx +3 -3
- package/docs/docs/cmd/planner/plan/plan-add.mdx +1 -1
- package/docs/docs/cmd/planner/roster/roster-add.mdx +5 -5
- package/docs/docs/cmd/planner/roster/roster-get.mdx +7 -7
- package/docs/docs/cmd/planner/roster/roster-member-add.mdx +4 -4
- package/docs/docs/cmd/planner/roster/roster-member-get.mdx +4 -4
- package/docs/docs/cmd/planner/roster/roster-member-list.mdx +2 -2
- package/docs/docs/cmd/planner/roster/roster-member-remove.mdx +5 -5
- package/docs/docs/cmd/planner/roster/roster-plan-list.mdx +1 -1
- package/docs/docs/cmd/planner/roster/roster-remove.mdx +2 -2
- package/docs/docs/cmd/planner/task/task-add.mdx +1 -1
- package/docs/docs/cmd/planner/task/task-get.mdx +1 -1
- package/docs/docs/cmd/planner/task/task-list.mdx +1 -1
- package/docs/docs/cmd/planner/task/task-remove.mdx +1 -1
- package/docs/docs/cmd/planner/task/task-set.mdx +1 -1
- package/docs/docs/cmd/pp/environment/environment-get.mdx +1 -1
- package/docs/docs/cmd/pp/environment/environment-list.mdx +1 -1
- package/docs/docs/cmd/pp/managementapp/managementapp-add.mdx +9 -9
- package/docs/docs/cmd/purview/auditlog/auditlog-list.mdx +1 -1
- package/docs/docs/cmd/purview/sensitivitylabel/sensitivitylabel-get.mdx +1 -1
- package/docs/docs/cmd/purview/sensitivitylabel/sensitivitylabel-list.mdx +1 -1
- package/docs/docs/cmd/purview/sensitivitylabel/sensitivitylabel-policysettings-list.mdx +1 -1
- package/docs/docs/cmd/purview/threatassessment/threatassessment-add.mdx +131 -0
- package/docs/docs/cmd/purview/threatassessment/threatassessment-list.mdx +110 -0
- package/docs/docs/cmd/request.mdx +1 -1
- package/docs/docs/cmd/spfx/project/project-azuredevops-pipeline-add.mdx +87 -0
- package/docs/docs/cmd/spfx/project/project-github-workflow-add.mdx +2 -2
- package/docs/docs/cmd/spo/file/file-roleassignment-add.mdx +3 -3
- package/docs/docs/cmd/spo/file/file-roleassignment-remove.mdx +2 -2
- package/docs/docs/cmd/spo/folder/folder-add.mdx +38 -0
- package/docs/docs/cmd/spo/folder/folder-roleassignment-add.mdx +1 -1
- package/docs/docs/cmd/spo/folder/folder-roleassignment-remove.mdx +1 -1
- package/docs/docs/cmd/spo/folder/folder-set.mdx +88 -0
- package/docs/docs/cmd/spo/group/group-member-add.mdx +2 -2
- package/docs/docs/cmd/spo/group/group-member-remove.mdx +3 -3
- package/docs/docs/cmd/spo/list/list-roleassignment-add.mdx +3 -3
- package/docs/docs/cmd/spo/list/list-roleassignment-remove.mdx +2 -2
- package/docs/docs/cmd/spo/listitem/listitem-roleassignment-add.mdx +8 -8
- package/docs/docs/cmd/spo/listitem/listitem-roleassignment-remove.mdx +2 -2
- package/docs/docs/cmd/spo/site/site-apppermission-add.mdx +2 -2
- package/docs/docs/cmd/spo/site/site-apppermission-set.mdx +2 -2
- package/docs/docs/cmd/spo/site/site-recyclebinitem-restore.mdx +29 -5
- package/docs/docs/cmd/spo/tenant/tenant-settings-set.mdx +89 -89
- package/docs/docs/cmd/spo/user/user-ensure.mdx +1 -1
- package/docs/docs/cmd/spo/user/user-remove.mdx +40 -9
- package/docs/docs/cmd/spo/web/web-roleassignment-add.mdx +3 -3
- package/docs/docs/cmd/spo/web/web-roleassignment-remove.mdx +2 -2
- package/docs/docs/cmd/teams/channel/channel-member-remove.mdx +1 -1
- package/docs/docs/cmd/teams/channel/channel-member-set.mdx +1 -1
- package/docs/docs/cmd/teams/chat/chat-member-remove.mdx +3 -3
- package/docs/docs/cmd/teams/report/report-directroutingcalls.mdx +1 -1
- package/docs/docs/cmd/teams/report/report-pstncalls.mdx +1 -1
- package/docs/docs/cmd/teams/tab/tab-get.mdx +19 -12
- package/docs/docs/cmd/tenant/security/security-alerts-list.mdx +1 -1
- package/docs/docs/cmd/viva/engage/engage-group-list.mdx +1 -1
- package/docs/docs/cmd/viva/engage/engage-group-user-add.mdx +1 -1
- package/docs/docs/cmd/viva/engage/engage-group-user-remove.mdx +1 -1
- package/docs/docs/cmd/viva/engage/engage-message-add.mdx +1 -1
- package/docs/docs/cmd/viva/engage/engage-message-get.mdx +1 -1
- package/docs/docs/cmd/viva/engage/engage-message-like-set.mdx +1 -1
- package/docs/docs/cmd/viva/engage/engage-message-list.mdx +1 -1
- package/docs/docs/cmd/viva/engage/engage-message-remove.mdx +1 -1
- package/docs/docs/cmd/viva/engage/engage-network-list.mdx +1 -1
- package/docs/docs/cmd/viva/engage/engage-search.mdx +1 -1
- package/docs/docs/cmd/viva/engage/engage-user-get.mdx +1 -1
- package/docs/docs/cmd/viva/engage/engage-user-list.mdx +1 -1
- package/npm-shrinkwrap.json +64 -60
- package/package.json +12 -12
- package/dist/m365/spo/commands/folder/folder-rename.js +0 -72
- package/docs/docs/cmd/spo/folder/folder-rename.mdx +0 -44
|
@@ -16,40 +16,40 @@ m365 pp managementapp add [options]
|
|
|
16
16
|
|
|
17
17
|
```md definition-list
|
|
18
18
|
`--appId [appId]`
|
|
19
|
-
: Application (client) ID of the
|
|
19
|
+
: Application (client) ID of the Microsoft Entra application registration to register as a management app. Specify either `appId`, `objectId` or `name`
|
|
20
20
|
|
|
21
21
|
`--objectId [objectId]`
|
|
22
|
-
: Object ID of the
|
|
22
|
+
: Object ID of the Microsoft Entra application registration to register as a management app. Specify either `appId`, `objectId` or `name`
|
|
23
23
|
|
|
24
24
|
`--name [name]`
|
|
25
|
-
: Name of the
|
|
25
|
+
: Name of the Microsoft Entra application registration to register as a management app. Specify either `appId`, `objectId` or `name`
|
|
26
26
|
```
|
|
27
27
|
|
|
28
28
|
<Global />
|
|
29
29
|
|
|
30
30
|
## Remarks
|
|
31
31
|
|
|
32
|
-
To execute this command the first time you'll need sign in using the Microsoft Azure PowerShell app registration. You can do this by executing `m365 login --appId 1950a258-227b-4e31-a9cf-717495945fc2`. To register the
|
|
32
|
+
To execute this command the first time you'll need sign in using the Microsoft Azure PowerShell app registration. You can do this by executing `m365 login --appId 1950a258-227b-4e31-a9cf-717495945fc2`. To register the Microsoft Entra app registration that CLI for Microsoft 365 uses by default, execute `m365 pp managementapp add--appId 31359c7f-bd7e-475c-86db-fdb8c937548e`.
|
|
33
33
|
|
|
34
|
-
For best performance use the `appId` option to reference the
|
|
34
|
+
For best performance use the `appId` option to reference the Microsoft Entra application registration to update. If you use `objectId` or `name`, this command will first need to find the corresponding `appId` for that application.
|
|
35
35
|
|
|
36
|
-
If the command finds multiple
|
|
36
|
+
If the command finds multiple Microsoft Entra application registrations with the specified app name, it will prompt you to disambiguate which app it should use, listing the discovered object IDs.
|
|
37
37
|
|
|
38
38
|
## Examples
|
|
39
39
|
|
|
40
|
-
Register CLI for Microsoft 365 as a management application for the Power Platform
|
|
40
|
+
Register CLI for Microsoft 365 as a management application for the Power Platform.
|
|
41
41
|
|
|
42
42
|
```sh
|
|
43
43
|
m365 pp managementapp add --appId 31359c7f-bd7e-475c-86db-fdb8c937548e
|
|
44
44
|
```
|
|
45
45
|
|
|
46
|
-
Register
|
|
46
|
+
Register a Microsoft Entra application with the specified object ID as a management application for the Power Platform.
|
|
47
47
|
|
|
48
48
|
```sh
|
|
49
49
|
m365 pp managementapp add --objectId d75be2e1-0204-4f95-857d-51a37cf40be8
|
|
50
50
|
```
|
|
51
51
|
|
|
52
|
-
Register
|
|
52
|
+
Register a Microsoft Entra application named _My app_ as a management application for the Power Platform.
|
|
53
53
|
|
|
54
54
|
```sh
|
|
55
55
|
m365 pp managementapp add --name "My app"
|
|
@@ -49,7 +49,7 @@ Retrieving audit logs is an intensive process, especially for large or active te
|
|
|
49
49
|
|
|
50
50
|
When you specify a value for `contentType`, consider the following:
|
|
51
51
|
|
|
52
|
-
- `AzureActiveDirectory` includes all
|
|
52
|
+
- `AzureActiveDirectory` includes all Microsoft Entra ID audit logs.
|
|
53
53
|
- `Exchange` includes all Exchange audit logs.
|
|
54
54
|
- `SharePoint` includes all SharePoint audit logs.
|
|
55
55
|
- `General` includes all other workloads not included in the previous content types.
|
|
@@ -19,7 +19,7 @@ m365 purview sensitivitylabel get [options]
|
|
|
19
19
|
: The Id of the sensitivity label.
|
|
20
20
|
|
|
21
21
|
`--userId [userId]`
|
|
22
|
-
: User's
|
|
22
|
+
: User's Microsoft Entra ID. Optionally specify this if you want to get a list of sensitivity labels that the user has access to. Specify either `userId` or `userName` but not both.
|
|
23
23
|
|
|
24
24
|
`--userName [userName]`
|
|
25
25
|
: User's UPN (user principal name, e.g. johndoe@example.com). Optionally specify this if you want to get a list of sensitivity labels that the user has access to. Specify either `userId` or `userName` but not both.
|
|
@@ -16,7 +16,7 @@ m365 purview sensitivitylabel list [options]
|
|
|
16
16
|
|
|
17
17
|
```md definition-list
|
|
18
18
|
`--userId [userId]`
|
|
19
|
-
: User's
|
|
19
|
+
: User's Microsoft Entra ID. Optionally specify this if you want to get a list of sensitivity labels that the user has access to. Specify either `userId` or `userName` but not both.
|
|
20
20
|
|
|
21
21
|
`--userName [userName]`
|
|
22
22
|
: User's UPN (user principal name, e.g. johndoe@example.com). Optionally specify this if you want to get a list of sensitivity labels that the user has access to. Specify either `userId` or `userName` but not both.
|
|
@@ -16,7 +16,7 @@ m365 purview sensitivitylabel policysettings list [options]
|
|
|
16
16
|
|
|
17
17
|
```md definition-list
|
|
18
18
|
`--userId [userId]`
|
|
19
|
-
: User's
|
|
19
|
+
: User's Microsoft Entra ID. Optionally specify this if you want to get a list of policy settings for a sensitivity label that the user has access to. Specify either `userId` or `userName` but not both.
|
|
20
20
|
|
|
21
21
|
`--userName [userName]`
|
|
22
22
|
: User's UPN (user principal name, e.g. johndoe@example.com). Optionally specify this if you want to get a list of policy settings for a sensitivity label that the user has access to. Specify either `userId` or `userName` but not both.
|
|
@@ -0,0 +1,131 @@
|
|
|
1
|
+
import Global from '/docs/cmd/_global.mdx';
|
|
2
|
+
import Tabs from '@theme/Tabs';
|
|
3
|
+
import TabItem from '@theme/TabItem';
|
|
4
|
+
|
|
5
|
+
# purview threatassessment add
|
|
6
|
+
|
|
7
|
+
Create a threat assessment
|
|
8
|
+
|
|
9
|
+
## Usage
|
|
10
|
+
|
|
11
|
+
```sh
|
|
12
|
+
m365 purview threatassessment add [options]
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
## Options
|
|
16
|
+
|
|
17
|
+
```md definition-list
|
|
18
|
+
`-t, --type <type>`
|
|
19
|
+
: The type of threat assessment to retrieve. Supports `file` and `url`.
|
|
20
|
+
|
|
21
|
+
`-e, --expectedAssessment <expectedAssessment>`
|
|
22
|
+
: The expected assessment from submitter. Possible values are: `block` and `unblock`.
|
|
23
|
+
|
|
24
|
+
`-c, --category <category>`
|
|
25
|
+
: The threat category. Possible values are: `spam`, `phishing`, `malware`.
|
|
26
|
+
|
|
27
|
+
`-p, --path [path]`
|
|
28
|
+
: Local path to the file to upload. Can only be used for threat assessment with type `file`.
|
|
29
|
+
|
|
30
|
+
`-u, --url [url]`
|
|
31
|
+
: The URL string. Can only be used for threat assessment with type `url`.
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
<Global />
|
|
35
|
+
|
|
36
|
+
## Remarks
|
|
37
|
+
|
|
38
|
+
:::info
|
|
39
|
+
|
|
40
|
+
This command currently only supports delegated permissions.
|
|
41
|
+
|
|
42
|
+
:::
|
|
43
|
+
|
|
44
|
+
## Examples
|
|
45
|
+
|
|
46
|
+
Create a file threat assessment
|
|
47
|
+
|
|
48
|
+
```sh
|
|
49
|
+
m365 purview threatassessment add --type file --expectedAssessment block --category malware --fileName 'test.txt' --path 'C:\Path\To\File.txt'
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
Create a url threat assessment
|
|
53
|
+
|
|
54
|
+
```sh
|
|
55
|
+
m365 purview threatassessment add --type url --expectedAssessment block --category phishing --url 'http://contoso.com'
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
## Response
|
|
59
|
+
|
|
60
|
+
<Tabs>
|
|
61
|
+
<TabItem value="JSON">
|
|
62
|
+
|
|
63
|
+
```json
|
|
64
|
+
{
|
|
65
|
+
"id": "b0e69f1c-adda-4df2-2906-08dc2caa6b3f",
|
|
66
|
+
"createdDateTime": "2024-02-13T15:42:43.5131654Z",
|
|
67
|
+
"contentType": "file",
|
|
68
|
+
"expectedAssessment": "block",
|
|
69
|
+
"category": "malware",
|
|
70
|
+
"status": "pending",
|
|
71
|
+
"requestSource": "administrator",
|
|
72
|
+
"fileName": "test.txt",
|
|
73
|
+
"contentData": "dGVzdC50eHQ=",
|
|
74
|
+
"createdBy": {
|
|
75
|
+
"user": {
|
|
76
|
+
"id": "fe36f75e-c103-410b-a18a-2bf6df06ac3a",
|
|
77
|
+
"displayName": "John Doe"
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
</TabItem>
|
|
84
|
+
<TabItem value="Text">
|
|
85
|
+
|
|
86
|
+
```text
|
|
87
|
+
category : malware
|
|
88
|
+
contentData : dGVzdC50eHQ=
|
|
89
|
+
contentType : file
|
|
90
|
+
createdBy : {"user":{"id":"fe36f75e-c103-410b-a18a-2bf6df06ac3a","displayName":"John Doe"}}
|
|
91
|
+
createdDateTime : 2024-02-13T16:15:00.4125206Z
|
|
92
|
+
expectedAssessment: block
|
|
93
|
+
fileName : test.txt
|
|
94
|
+
id : be1223c4-4e92-4a4c-8c16-08dc2caeedba
|
|
95
|
+
requestSource : administrator
|
|
96
|
+
status : pending
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
</TabItem>
|
|
100
|
+
<TabItem value="CSV">
|
|
101
|
+
|
|
102
|
+
```csv
|
|
103
|
+
id,createdDateTime,contentType,expectedAssessment,category,status,requestSource,fileName,contentData
|
|
104
|
+
d31eb5f5-ecd5-4a8e-fb2a-08dc2caf00a8,2024-02-13T16:15:32.1741098Z,file,block,malware,pending,administrator,test.txt,dGVzdC50eHQ=
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
</TabItem>
|
|
108
|
+
<TabItem value="Markdown">
|
|
109
|
+
|
|
110
|
+
```md
|
|
111
|
+
# purview threatassessment add --type "file" --expectedAssessment "block" --category "malware" --path "C:\temp\test.txt"
|
|
112
|
+
|
|
113
|
+
Date: 13/02/2024
|
|
114
|
+
|
|
115
|
+
## e3524baf-6ea6-4fab-68af-08dc2caf0ae3
|
|
116
|
+
|
|
117
|
+
Property | Value
|
|
118
|
+
---------|-------
|
|
119
|
+
id | e3524baf-6ea6-4fab-68af-08dc2caf0ae3
|
|
120
|
+
createdDateTime | 2024-02-13T16:15:49.3342383Z
|
|
121
|
+
contentType | file
|
|
122
|
+
expectedAssessment | block
|
|
123
|
+
category | malware
|
|
124
|
+
status | pending
|
|
125
|
+
requestSource | administrator
|
|
126
|
+
fileName | test.txt
|
|
127
|
+
contentData | dGVzdC50eHQ=
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
</TabItem>
|
|
131
|
+
</Tabs>
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
import Global from '/docs/cmd/_global.mdx';
|
|
2
|
+
import Tabs from '@theme/Tabs';
|
|
3
|
+
import TabItem from '@theme/TabItem';
|
|
4
|
+
|
|
5
|
+
# purview threatassessment list
|
|
6
|
+
|
|
7
|
+
Get a list of threat assessments
|
|
8
|
+
|
|
9
|
+
## Usage
|
|
10
|
+
|
|
11
|
+
```sh
|
|
12
|
+
m365 purview threatassessment list [options]
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
## Options
|
|
16
|
+
|
|
17
|
+
```md definition-list
|
|
18
|
+
`-t, --type [type]`
|
|
19
|
+
: The type of threat assessment to retrieve. Allowed values are `mail`, `file`, `emailFile` and `url`.
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
<Global />
|
|
23
|
+
|
|
24
|
+
## Examples
|
|
25
|
+
|
|
26
|
+
Get a list of threat assessments
|
|
27
|
+
|
|
28
|
+
```sh
|
|
29
|
+
m365 purview threatassessment list
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
Get a list of threat assessments of type _mail_
|
|
33
|
+
|
|
34
|
+
```sh
|
|
35
|
+
m365 purview threatassessment list --type mail
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
## Response
|
|
39
|
+
|
|
40
|
+
<Tabs>
|
|
41
|
+
<TabItem value="JSON">
|
|
42
|
+
|
|
43
|
+
```json
|
|
44
|
+
[
|
|
45
|
+
{
|
|
46
|
+
"type": "mail",
|
|
47
|
+
"id": "49c5ef5b-1f65-444a-e6b9-08d772ea2059",
|
|
48
|
+
"createdDateTime": "2019-11-27T03:30:18.6890937Z",
|
|
49
|
+
"contentType": "mail",
|
|
50
|
+
"expectedAssessment": "block",
|
|
51
|
+
"category": "spam",
|
|
52
|
+
"status": "pending",
|
|
53
|
+
"requestSource": "administrator",
|
|
54
|
+
"recipientEmail": "john@contoso.onmicrosoft.com",
|
|
55
|
+
"destinationRoutingReason": "notJunk",
|
|
56
|
+
"messageUri": "https://graph.microsoft.com/v1.0/users/c52ce8db-3e4b-4181-93c4-7d6b6bffaf60/messages/AAMkADU3MWUxOTU0LWNlOTEt=",
|
|
57
|
+
"createdBy": {
|
|
58
|
+
"user": {
|
|
59
|
+
"id": "c52ce8db-3e4b-4181-93c4-7d6b6bffaf60",
|
|
60
|
+
"displayName": "John Doe"
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
];
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
</TabItem>
|
|
68
|
+
<TabItem value="Text">
|
|
69
|
+
|
|
70
|
+
```text
|
|
71
|
+
id type category
|
|
72
|
+
------------------------------------ ----------- --------
|
|
73
|
+
49c5ef5b-1f65-444a-e6b9-08d772ea2059 mail spam
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
</TabItem>
|
|
77
|
+
<TabItem value="CSV">
|
|
78
|
+
|
|
79
|
+
```csv
|
|
80
|
+
id,type,category
|
|
81
|
+
49c5ef5b-1f65-444a-e6b9-08d772ea2059,mail,spam
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
</TabItem>
|
|
85
|
+
<TabItem value="Markdown">
|
|
86
|
+
|
|
87
|
+
```md
|
|
88
|
+
# purview threatassessment list
|
|
89
|
+
|
|
90
|
+
Date: 16/2/2023
|
|
91
|
+
|
|
92
|
+
## a47e428c-a7bd-4cf2-f061-08db0f58b736
|
|
93
|
+
|
|
94
|
+
Property | Value
|
|
95
|
+
---------|-------
|
|
96
|
+
type | mail
|
|
97
|
+
id | 49c5ef5b-1f65-444a-e6b9-08d772ea2059
|
|
98
|
+
createdDateTime | 2019-11-27T03:30:18.6890937Z
|
|
99
|
+
contentType | mail
|
|
100
|
+
expectedAssessment | block
|
|
101
|
+
category | spam
|
|
102
|
+
status | pending
|
|
103
|
+
recipientEmail | john@contoso.onmicrosoft.com
|
|
104
|
+
destinationRoutingReason | notJunk
|
|
105
|
+
messageUri | https://graph.microsoft.com/v1.0/users/c52ce8db-3e4b-4181-93c4-7d6b6bffaf60/messages/AAMkADU3MWUxOTU0LWNlOTEt=
|
|
106
|
+
createdBy | {"user":{"id":"c52ce8db-3e4b-4181-93c4-7d6b6bffaf60","displayName":"John Doe"}}
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
</TabItem>
|
|
110
|
+
</Tabs>
|
|
@@ -22,7 +22,7 @@ m365 request [options]
|
|
|
22
22
|
: The HTTP request method. Accepted values are `get`, `post`, `put`, `patch`, `delete`, `head`, `options`. The default value is `get`.
|
|
23
23
|
|
|
24
24
|
`-r, --resource [resource]`
|
|
25
|
-
: The resource uri for which the CLI should acquire a token from
|
|
25
|
+
: The resource uri for which the CLI should acquire a token from Microsoft Entra ID in order to access the service.
|
|
26
26
|
|
|
27
27
|
`-b, --body [body]`
|
|
28
28
|
: The request body. Optionally use `@example.json` to load the body from a file.
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
import Global from '/docs/cmd/_global.mdx';
|
|
2
|
+
|
|
3
|
+
# spfx project azuredevops pipeline add
|
|
4
|
+
|
|
5
|
+
Adds a Azure DevOps Pipeline for a SharePoint Framework project
|
|
6
|
+
|
|
7
|
+
## Usage
|
|
8
|
+
|
|
9
|
+
```sh
|
|
10
|
+
m365 spfx project azuredevops pipeline add [options]
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Options
|
|
14
|
+
|
|
15
|
+
```md definition-list
|
|
16
|
+
`-n, --name [name]`
|
|
17
|
+
: Name of the pipeline run that will be created. If none is specified a default name generated by Azure DevOps will be used
|
|
18
|
+
|
|
19
|
+
`-b, --branchName [branchName]`
|
|
20
|
+
: Specify the branch name which should trigger the workflow on push. If none is specified a default will be used which is 'main'
|
|
21
|
+
|
|
22
|
+
`-l, --loginMethod [loginMethod]`
|
|
23
|
+
: Specify the login method used for the login action. Possible options are: `user`, `application`. Default `application`
|
|
24
|
+
|
|
25
|
+
`-s, --scope [scope]`
|
|
26
|
+
: Scope of the app catalog: `tenant`, `sitecollection`. Default is `tenant`
|
|
27
|
+
|
|
28
|
+
`-u, --siteUrl [siteUrl]`
|
|
29
|
+
: The URL of the site collection where the solution package will be added. Required if scope is set to `sitecollection`
|
|
30
|
+
|
|
31
|
+
`--skipFeatureDeployment`
|
|
32
|
+
: When specified the app will be added to all sites. When deployed to the site app catalog it will be added to all sub-sites of that site.
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
<Global />
|
|
36
|
+
|
|
37
|
+
## Remarks
|
|
38
|
+
|
|
39
|
+
The `spfx project azuredevops pipeline add` will create a workflow .yml file in the `.azuredevops/pipelines` directory in your project. If such directory does not exist the command will automatically create it.
|
|
40
|
+
|
|
41
|
+
The command will not create the Azure DevOps pipeline. You will need to manually create it in Azure DevOps. The command will only create the workflow file which you can then push to your repo and create a new yaml pipline based on it.
|
|
42
|
+
|
|
43
|
+
For the `application` login method the command does not register an Entra application nor does it create the required certificate. In order to proceed, obtain (create) a self-signed certificate and register a new Entra application with certificate authentication. After that you will need to fill the following variables, or what is more preferable, create a dedicated variable group to store those properties:
|
|
44
|
+
|
|
45
|
+
- `CertificateBase64Encoded` - base 64 encoded certificate. Use either `CertificateBase64Encoded` or `CertificateSecureFileId` but not both
|
|
46
|
+
- `CertificateSecureFileId` - id of a certificate file in the secure files section of the DevOps library. `.pfx` file. Use either `CertificateBase64Encoded` or `CertificateSecureFileId` but not both
|
|
47
|
+
- `CertificatePassword` - certificate password. This applies only if the certificate is encoded which is the recommended approach
|
|
48
|
+
- `EntraAppId` - client id of the registered Entra application
|
|
49
|
+
|
|
50
|
+
This use case is perfect in a production context as it does not create any dependencies on an account
|
|
51
|
+
|
|
52
|
+
For the `user` login method you will need to fill the following variables, or what is more preferable, create a dedicated variable group to store those properties:
|
|
53
|
+
|
|
54
|
+
- `UserName` - user email
|
|
55
|
+
- `Password` - password
|
|
56
|
+
|
|
57
|
+
This method is perfect to test your workflow, in a dev context, for personal usage. It will not work for accounts with MFA.
|
|
58
|
+
|
|
59
|
+
:::info
|
|
60
|
+
|
|
61
|
+
Run this command in the SPFx solution folder.
|
|
62
|
+
|
|
63
|
+
:::
|
|
64
|
+
|
|
65
|
+
## Examples
|
|
66
|
+
|
|
67
|
+
Adds an Azure DevOps Pipeline for a SharePoint Framework project triggered on push to main
|
|
68
|
+
|
|
69
|
+
```sh
|
|
70
|
+
m365 spfx project azuredevops pipeline add
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
Adds an Azure DevOps Pipeline for a SharePoint Framework project with `user` login method triggered on push to main
|
|
74
|
+
|
|
75
|
+
```sh
|
|
76
|
+
m365 spfx project azuredevops pipeline add --loginMethod "user"
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
Adds an Azure DevOps Pipeline for a SharePoint Framework project with deployment to a site collection app catalog
|
|
80
|
+
|
|
81
|
+
```sh
|
|
82
|
+
m365 spfx project azuredevops pipeline add --scope "sitecollection" --siteUrl "https://some.sharepoint.com/sites/someSite"
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
## Response
|
|
86
|
+
|
|
87
|
+
The command won't return a response on success.
|
|
@@ -44,9 +44,9 @@ m365 spfx project github workflow add [options]
|
|
|
44
44
|
|
|
45
45
|
The `spfx project github workflow add` will create a workflow .yml file in the `.github/workflows` directory in your project. If such directory does not exist the command will automatically create it.
|
|
46
46
|
|
|
47
|
-
For the `application` login method the command does not register
|
|
47
|
+
For the `application` login method the command does not register a Microsoft Entra application nor create the required certificate. In order for you to proceed you will need to first obtain (create) a self-signed certificate and register a new Microsoft Entra application with certificate authentication. After that in GitHub repo settings, you will need to create the following secrets:
|
|
48
48
|
|
|
49
|
-
- `APP_ID` - client id of the registered
|
|
49
|
+
- `APP_ID` - client id of the registered Microsoft Entra application
|
|
50
50
|
- `CERTIFICATE_ENCODED` - application's encoded certificate
|
|
51
51
|
- `CERTIFICATE_PASSWORD` - certificate password. This applies only if the certificate is encoded which is the recommended approach
|
|
52
52
|
|
|
@@ -26,16 +26,16 @@ m365 spo file roleassignment add [options]
|
|
|
26
26
|
: The SharePoint Id of the principal. It may be either a user id or group id to add a role assignment for. Specify either `upn`, `groupName`, or `principalId` but not multiple.
|
|
27
27
|
|
|
28
28
|
`--upn [upn]`
|
|
29
|
-
: upn/email of user to assign role to. Specify either `upn`, `groupName`, or `principalId` but not multiple.
|
|
29
|
+
: The upn/email of user to assign role to. Specify either `upn`, `groupName`, or `principalId` but not multiple.
|
|
30
30
|
|
|
31
31
|
`--groupName [groupName]`
|
|
32
|
-
: The group name of
|
|
32
|
+
: The group name of Microsoft Entra or SharePoint group. Specify either `upn`, `groupName`, or `principalId` but not multiple.
|
|
33
33
|
|
|
34
34
|
`--roleDefinitionId [roleDefinitionId]`
|
|
35
35
|
: ID of role definition. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.
|
|
36
36
|
|
|
37
37
|
`--roleDefinitionName [roleDefinitionName]`
|
|
38
|
-
:
|
|
38
|
+
: The name of a role definition, like 'Contribute', 'Read', etc. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.
|
|
39
39
|
```
|
|
40
40
|
|
|
41
41
|
<Global />
|
|
@@ -26,10 +26,10 @@ m365 spo file roleassignment remove [options]
|
|
|
26
26
|
: The SharePoint Id of the principal. It may be either a user id or group id. Specify either `upn`, `groupName`, or `principalId` but not multiple.
|
|
27
27
|
|
|
28
28
|
`--upn [upn]`
|
|
29
|
-
:
|
|
29
|
+
: The upn/email of the user. Specify either `upn`, `groupName`, or `principalId` but not multiple.
|
|
30
30
|
|
|
31
31
|
`--groupName [groupName]`
|
|
32
|
-
: The group name of
|
|
32
|
+
: The group name of a Microsoft Entra or SharePoint group. Specify either `upn`, `groupName`, or `principalId` but not multiple.
|
|
33
33
|
|
|
34
34
|
`-f, --force`
|
|
35
35
|
: Don't prompt for confirmation.
|
|
@@ -23,10 +23,36 @@ m365 spo folder add [options]
|
|
|
23
23
|
|
|
24
24
|
`-n, --name <name>`
|
|
25
25
|
: Name of the new folder to be created.
|
|
26
|
+
|
|
27
|
+
`--color [color]`
|
|
28
|
+
: Visual color of the folder. Valid values are a color name or a number. Check remarks for more info.
|
|
26
29
|
```
|
|
27
30
|
|
|
28
31
|
<Global />
|
|
29
32
|
|
|
33
|
+
## Remarks
|
|
34
|
+
|
|
35
|
+
When you specify a value for `color`, consider the following:
|
|
36
|
+
|
|
37
|
+
| Color | Number value | String value |
|
|
38
|
+
|--------------|--------------|--------------|
|
|
39
|
+
| Yellow | 0 | yellow |
|
|
40
|
+
| Dark red | 1 | darkRed |
|
|
41
|
+
| Dark orange | 2 | darkOrange |
|
|
42
|
+
| Dark green | 3 | darkGreen |
|
|
43
|
+
| Dark teal | 4 | darkTeal |
|
|
44
|
+
| Dark blue | 5 | darkBlue |
|
|
45
|
+
| Dark purple | 6 | darkPurple |
|
|
46
|
+
| Dark pink | 7 | darkPink |
|
|
47
|
+
| Grey | 8 | grey |
|
|
48
|
+
| Light red | 9 | lightRed |
|
|
49
|
+
| Light orange | 10 | lightOrange |
|
|
50
|
+
| Light green | 11 | lightGreen |
|
|
51
|
+
| Light teal | 12 | lightTeal |
|
|
52
|
+
| Light blue | 13 | lightBlue |
|
|
53
|
+
| Light purple | 14 | lightPurple |
|
|
54
|
+
| Light pink | 15 | lightPink |
|
|
55
|
+
|
|
30
56
|
## Examples
|
|
31
57
|
|
|
32
58
|
Creates folder in a specific library within the site.
|
|
@@ -41,6 +67,18 @@ Creates folder in a specific folder within the site.
|
|
|
41
67
|
m365 spo folder add --webUrl https://contoso.sharepoint.com/sites/project-x --parentFolderUrl '/sites/project-x/Shared Documents/Reports' --name 'Financial reports'
|
|
42
68
|
```
|
|
43
69
|
|
|
70
|
+
Create a folder with a dark blue look
|
|
71
|
+
|
|
72
|
+
```sh
|
|
73
|
+
m365 spo folder add --webUrl https://contoso.sharepoint.com --parentFolder '/ProjectFiles' --name 'Project-x' --color 5
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
Create a folder with a light teal look
|
|
77
|
+
|
|
78
|
+
```sh
|
|
79
|
+
m365 spo folder add --webUrl https://contoso.sharepoint.com --url '/ProjectFiles/Project-x' --color lightTeal
|
|
80
|
+
```
|
|
81
|
+
|
|
44
82
|
## Response
|
|
45
83
|
|
|
46
84
|
<Tabs>
|
|
@@ -26,7 +26,7 @@ m365 spo folder roleassignment add [options]
|
|
|
26
26
|
: The upn/email of the user. Specify either `upn`, `groupName` or `principalId` but not multiple.
|
|
27
27
|
|
|
28
28
|
`--groupName [groupName]`
|
|
29
|
-
: The
|
|
29
|
+
: The Microsoft Entra or SharePoint group name. Specify either `upn`, `groupName` or `principalId` but not multiple.
|
|
30
30
|
|
|
31
31
|
`--roleDefinitionId [roleDefinitionId]`
|
|
32
32
|
: ID of the role definition. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.
|
|
@@ -26,7 +26,7 @@ m365 spo folder roleassignment remove [options]
|
|
|
26
26
|
: The upn/email of the user. Specify either `upn`, `groupName` or `principalId` but not multiple.
|
|
27
27
|
|
|
28
28
|
`--groupName [groupName]`
|
|
29
|
-
: The
|
|
29
|
+
: The Microsoft Entra or SharePoint group name. Specify either `upn`, `groupName` or `principalId` but not multiple.
|
|
30
30
|
|
|
31
31
|
`-f, --force`
|
|
32
32
|
: Don't prompt for confirmation when removing the role assignment.
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
import Global from '/docs/cmd/_global.mdx';
|
|
2
|
+
|
|
3
|
+
# spo folder set
|
|
4
|
+
|
|
5
|
+
Updates a folder
|
|
6
|
+
|
|
7
|
+
## Usage
|
|
8
|
+
|
|
9
|
+
```sh
|
|
10
|
+
m365 spo folder set [options]
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Alias
|
|
14
|
+
|
|
15
|
+
```sh
|
|
16
|
+
m365 spo folder rename [options]
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
## Options
|
|
20
|
+
|
|
21
|
+
```md definition-list
|
|
22
|
+
`-u, --webUrl <webUrl>`
|
|
23
|
+
: The URL of the site where the folder is located.
|
|
24
|
+
|
|
25
|
+
`--url <url>`
|
|
26
|
+
: The server- or site-relative decoded URL of the folder.
|
|
27
|
+
|
|
28
|
+
`-n, --name [name]`
|
|
29
|
+
: New name for the folder.
|
|
30
|
+
|
|
31
|
+
`--color [color]`
|
|
32
|
+
: Visual color of the folder. Valid values are a color name or a number. Check remarks for more info.
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
<Global />
|
|
36
|
+
|
|
37
|
+
## Remarks
|
|
38
|
+
|
|
39
|
+
When you specify a value for `color`, consider the following:
|
|
40
|
+
|
|
41
|
+
| Color | Number value | String value |
|
|
42
|
+
|--------------|--------------|--------------|
|
|
43
|
+
| Yellow | 0 | yellow |
|
|
44
|
+
| Dark red | 1 | darkRed |
|
|
45
|
+
| Dark orange | 2 | darkOrange |
|
|
46
|
+
| Dark green | 3 | darkGreen |
|
|
47
|
+
| Dark teal | 4 | darkTeal |
|
|
48
|
+
| Dark blue | 5 | darkBlue |
|
|
49
|
+
| Dark purple | 6 | darkPurple |
|
|
50
|
+
| Dark pink | 7 | darkPink |
|
|
51
|
+
| Grey | 8 | grey |
|
|
52
|
+
| Light red | 9 | lightRed |
|
|
53
|
+
| Light orange | 10 | lightOrange |
|
|
54
|
+
| Light green | 11 | lightGreen |
|
|
55
|
+
| Light teal | 12 | lightTeal |
|
|
56
|
+
| Light blue | 13 | lightBlue |
|
|
57
|
+
| Light purple | 14 | lightPurple |
|
|
58
|
+
| Light pink | 15 | lightPink |
|
|
59
|
+
|
|
60
|
+
## Examples
|
|
61
|
+
|
|
62
|
+
Set the folder name to 'My Folder 2'
|
|
63
|
+
|
|
64
|
+
```sh
|
|
65
|
+
m365 spo folder set --webUrl https://contoso.sharepoint.com/sites/project-x --url '/Shared Documents/My Folder 1' --name 'My Folder 2'
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
Set the folder name to 'My folder 2'
|
|
69
|
+
|
|
70
|
+
```sh
|
|
71
|
+
m365 spo folder set --webUrl https://contoso.sharepoint.com/sites/project-x --url '/sites/project-x/Shared Documents/My Folder 1' --name 'My Folder 2'
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
Set the folder color to dark blue
|
|
75
|
+
|
|
76
|
+
```sh
|
|
77
|
+
m365 spo folder set --webUrl https://contoso.sharepoint.com --url '/ProjectFiles/Project-x' --color 5
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
Set the folder color to light teal
|
|
81
|
+
|
|
82
|
+
```sh
|
|
83
|
+
m365 spo folder set --webUrl https://contoso.sharepoint.com --url '/ProjectFiles/Project-x' --color lightTeal
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
## Response
|
|
87
|
+
|
|
88
|
+
The command won't return a response on success.
|
|
@@ -37,13 +37,13 @@ m365 spo group member add [options]
|
|
|
37
37
|
: The object Id of the Entra group to add as a member. If multiple groups need to be added, the Ids have to be comma-separated. Specify either `userIds`, `userNames`, `emails`, `aadGroupIds`, `entraGroupIds`, `aadGroupNames`, or `entraGroupNames`.
|
|
38
38
|
|
|
39
39
|
`--aadGroupIds [aadGroupIds]`
|
|
40
|
-
: (deprecated. Use `entraGroupIds` instead) The object
|
|
40
|
+
: (deprecated. Use `entraGroupIds` instead) The object ID of the Microsoft Entra group to add as a member. If multiple groups need to be added, the Ids have to be comma-separated. Specify either `userIds`, `userNames`, `emails`, `aadGroupIds`, `entraGroupIds`, `aadGroupNames`, or `entraGroupNames`.
|
|
41
41
|
|
|
42
42
|
`--entraGroupNames [entraGroupNames]`
|
|
43
43
|
: The name of the Entra group to add as a member. If multiple groups need to be added, they have to be comma-separated. Specify either `userIds`, `userNames`, `emails`, `aadGroupIds`, `entraGroupIds`, `aadGroupNames`, or `entraGroupNames`.
|
|
44
44
|
|
|
45
45
|
`--aadGroupNames [aadGroupNames]`
|
|
46
|
-
: (deprecated. Use `entraGroupNames` instead) The name of the
|
|
46
|
+
: (deprecated. Use `entraGroupNames` instead) The name of the Microsoft Entra group to add as a member. If multiple groups need to be added, they have to be comma-separated. Specify either `userIds`, `userNames`, `emails`, `aadGroupIds`, `entraGroupIds`, `aadGroupNames`, or `entraGroupNames`.
|
|
47
47
|
```
|
|
48
48
|
|
|
49
49
|
<Global />
|