@pnp/cli-microsoft365 10.4.0-beta.17b3a55 → 10.4.0-beta.1d1e5a7

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.
@@ -14,10 +14,13 @@ m365 entra group member set [options]
14
14
 
15
15
  ```md definition-list
16
16
  `-i, --groupId [groupId]`
17
- : The ID of the Entra ID group. Specify `groupId` or `groupDisplayName` but not both.
17
+ : The ID of the Entra ID group. Specify `groupId`, `groupDisplayName` or `groupName` but not multiple.
18
18
 
19
19
  `-n, --groupDisplayName [groupDisplayName]`
20
- : The display name of the Entra ID group. Specify `groupId` or `groupDisplayName` but not both.
20
+ : (deprecated. Use option `groupName` instead) The display name of the Entra ID group. Specify `groupId`, `groupDisplayName` or `groupName` but not multiple.
21
+
22
+ `--groupName [groupName]`
23
+ : The display name of the Microsoft Entra group. Specify `groupId`, `groupDisplayName` or `groupName` but not multiple.
21
24
 
22
25
  `--ids [ids]`
23
26
  : Comma-separated list of user IDs. Specify either `ids` or `userNames` but not both.
@@ -39,6 +42,12 @@ Update a single member specified by ID to a member of a group specified by displ
39
42
  m365 entra group member set --groupDisplayName Developers --ids 098b9f52-f48c-4401-819f-29c33794c3f5 --role Member
40
43
  ```
41
44
 
45
+ Update a single member specified by ID to a member of a group specified by group name
46
+
47
+ ```sh
48
+ m365 entra group member set --groupName Developers --ids 098b9f52-f48c-4401-819f-29c33794c3f5 --role Member
49
+ ```
50
+
42
51
  Update multiple members specified by ID to members of a group specified by ID
43
52
 
44
53
  ```sh
@@ -51,6 +60,12 @@ Update a single member specified by UPN to an owner of a group specified by disp
51
60
  m365 entra group member set --groupDisplayName Developers --userNames john.doe@contoso.com --role Owner
52
61
  ```
53
62
 
63
+ Update a single member specified by UPN to an owner of a group specified by group name
64
+
65
+ ```sh
66
+ m365 entra group member set --groupName Developers --userNames john.doe@contoso.com --role Owner
67
+ ```
68
+
54
69
  Update multiple members specified by UPN to owners of a group specified by ID
55
70
 
56
71
  ```sh
@@ -0,0 +1,65 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+
3
+ # entra user session revoke
4
+
5
+ Revokes all sign-in sessions for a given user
6
+
7
+ ## Usage
8
+
9
+ ```sh
10
+ m365 entra user session revoke [options]
11
+ ```
12
+
13
+ ## Options
14
+ ```md definition-list
15
+ `-i, --userId [userId]`
16
+ : The id of the user. Specify either `userId` or `userName`, but not both.
17
+
18
+ `-n, --userName [userName]`
19
+ : The user principal name of the user. Specify either `userId` or `userName`, but not both.
20
+
21
+ `-f, --force`
22
+ : Don't prompt for confirmation.
23
+ ```
24
+
25
+ <Global />
26
+
27
+ ## Remarks
28
+
29
+ :::info
30
+
31
+ To use this command you must be either **User Administrator** or **Global Administrator**.
32
+
33
+ :::
34
+
35
+ :::note
36
+
37
+ There might be a small delay of a few minutes before tokens are revoked.
38
+
39
+ This API doesn't revoke sign-in sessions for external users, because external users sign in through their home tenant.
40
+
41
+ :::
42
+
43
+ ## Examples
44
+
45
+ Revoke sign-in sessions of a user specified by id
46
+
47
+ ```sh
48
+ m365 entra user session revoke --userId 4fb72b9b-d0b0-4a35-8bc1-83f9a6488c48
49
+ ```
50
+
51
+ Revoke sign-in sessions of a user specified by its UPN
52
+
53
+ ```sh
54
+ m365 entra user session revoke --userName john.doe@contoso.onmicrosoft.com
55
+ ```
56
+
57
+ Revoke sign-in sessions of a user specified by its UPN without prompting for confirmation
58
+
59
+ ```sh
60
+ m365 entra user session revoke --userName john.doe@contoso.onmicrosoft.com --force
61
+ ```
62
+
63
+ ## Response
64
+
65
+ The command won't return a response on success.
@@ -28,10 +28,14 @@ m365 spo field get [options]
28
28
  : Server- or web-relative URL of the list where the field is located. Specify either `listTitle`, `listId` or `listUrl`.
29
29
 
30
30
  `-i, --id [id]`
31
- : The ID of the field to retrieve. Specify `id` or `title` but not both.
31
+ : The ID of the field to retrieve. Specify either `id`, `title` or `internalName`.
32
32
 
33
33
  `-t, --title [title]`
34
- : The display name (case-sensitive) of the field to retrieve. Specify `id` or `title` but not both.
34
+ : The display name (case-sensitive) of the field to retrieve. Specify either `id`, `title` or `internalName`.
35
+ ```
36
+
37
+ `--internalName [internalName]`
38
+ : The internal name (case-sensitive) of the field to retrieve. Specify either `id`, `title` or `internalName`.
35
39
  ```
36
40
 
37
41
  <Global />
@@ -56,6 +60,12 @@ Retrieves list column by display name located in the specified site. Retrieves t
56
60
  m365 spo field get --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listUrl "Lists/Events" --title "Title"
57
61
  ```
58
62
 
63
+ Retrieves list column by internal name located in the specified site. Retrieves the list by its url.
64
+
65
+ ```sh
66
+ m365 spo field get --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listUrl "Lists/Events" --internalName "Title"
67
+ ```
68
+
59
69
  ## Response
60
70
 
61
71
  <Tabs>
@@ -26,13 +26,16 @@ m365 spo field remove [options]
26
26
  : Server- or web-relative URL of the list where the field is located. Specify either `listTitle`, `listId` or `listUrl`.
27
27
 
28
28
  `-i, --id [id]`
29
- : The ID of the field to remove. Specify either `id`, `title`, or `group`.
29
+ : The ID of the field to remove. Specify either `id`, `title`, `internalName`, or `group`.
30
30
 
31
31
  `-t, --title [title]`
32
- : The display name (case-sensitive) of the field to remove. Specify either `id`, `title`, or `group`.
32
+ : The display name (case-sensitive) of the field to remove. Specify either `id`, `title`, `internalName`, or `group`.
33
+
34
+ `--internalName [internalName]`
35
+ : The internal name (case-sensitive) of the field to remove. Specify either `id`, `title`, `internalName`, or `group`.
33
36
 
34
37
  `-g, --group [group]`
35
- : Delete all fields from this group (case-sensitive). Specify either `id`, `title`, or `group`.
38
+ : Delete all fields from this group (case-sensitive). Specify either `id`, `title`, `internalName`, or `group`.
36
39
 
37
40
  `-f, --force`
38
41
  : Don't prompt for confirming removing the field.
@@ -60,6 +63,12 @@ Remove the list column with the specified display name, located in the specified
60
63
  m365 spo field remove --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listUrl "Lists/Events" --title "Title"
61
64
  ```
62
65
 
66
+ Remove the list column with the specified display name, located in the specified site. Retrieves the list by its url.
67
+
68
+ ```sh
69
+ m365 spo field remove --webUrl https://contoso.sharepoint.com/sites/contoso-sales --listUrl "Lists/Events" --internalName "Title"
70
+ ```
71
+
63
72
  Remove all site columns from the specified group.
64
73
 
65
74
  ```sh
@@ -26,10 +26,13 @@ m365 spo field set [options]
26
26
  : Server- or site-relative URL of the list where the field is located (if list column). Specify either `listTitle`, `listId` or `listUrl`.
27
27
 
28
28
  `-i, --id [id]`
29
- : ID of the field to update. Specify either `id` or `title` but not both.
29
+ : ID of the field to update. Specify either `id`, `title`, or 'internalName' but not all.
30
30
 
31
31
  `-t, --title [title]`
32
- : Title or internal name of the field to update. Specify either `id` or `title` but not both.
32
+ : Title of the field to update. Specify either `id`, `title`, or 'internalName' but not all.
33
+
34
+ `--internalName [internalName]`
35
+ : Internal name of the field to update. Specify either `id`, `title`, or 'internalName' but not all.
33
36
 
34
37
  `--updateExistingLists`
35
38
  : Set, to push the update to existing lists. Otherwise, the changes will apply to new lists only.
@@ -51,6 +54,12 @@ When updating column formatting for a field with the `--CustomFormatter` option,
51
54
 
52
55
  Update the title of the site column specified by its internal name and push changes to existing lists.
53
56
 
57
+ ```sh
58
+ m365 spo field set --webUrl https://contoso.sharepoint.com/sites/project-x --internalName 'MyColumn' --updateExistingLists --Title 'My column'
59
+ ```
60
+
61
+ Update the title of the site column specified by its title and push changes to existing lists.
62
+
54
63
  ```sh
55
64
  m365 spo field set --webUrl https://contoso.sharepoint.com/sites/project-x --title 'MyColumn' --updateExistingLists --Title 'My column'
56
65
  ```
@@ -67,11 +76,16 @@ Update the description of a column specified by the ID on a list retrieved by th
67
76
  m365 spo field set --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl '/sites/project-x/Lists/My List' --id 330f29c5-5c4c-465f-9f4b-7903020ae1ce --Description 'My column Description'
68
77
  ```
69
78
 
70
- Update column formatting of the specified list column.
79
+ Update column formatting of the specified list column based on title.
71
80
 
72
81
  ```sh
73
82
  m365 spo field set --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'My List' --title 'MyColumn' --CustomFormatter '{"schema":"https://developer.microsoft.com/json-schemas/sp/column-formatting.schema.json", "elmType": "div", "txtContent": "@currentField"}'
74
83
  ```
84
+ Update column formatting of the specified list column based on internalName.
85
+
86
+ ```sh
87
+ m365 spo field set --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'My List' --internalName 'MyColumn' --CustomFormatter '{"schema":"https://developer.microsoft.com/json-schemas/sp/column-formatting.schema.json", "elmType": "div", "txtContent": "@currentField"}'
88
+ ```
75
89
 
76
90
  ## Response
77
91