Skip to content

Commit 0f7a1f1

Browse files
SmitaNachanAdam-it
SmitaNachan
and
Adam-it
authored
Adds Permissions section for exo approleassignment and file commands. Closes #6977
Co-authored-by: Adam Wójcik <58668583+Adam-it@users.noreply.github.com>
1 parent a1a4000 commit 0f7a1f1

6 files changed

Lines changed: 122 additions & 0 deletions

File tree

‎docs/docs/cmd/exo/approleassignment/approleassignment-add.mdx‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -65,6 +65,25 @@ To use this command you must be at least **Privileged Role Administrator**.
6565

6666
:::
6767

68+
## Permissions
69+
70+
<Tabs>
71+
<TabItem value="Delegated">
72+
73+
| Resource | Permissions |
74+
|-----------------|------------------------------|
75+
| Microsoft Graph | RoleManagement.ReadWrite.Exchange |
76+
77+
</TabItem>
78+
<TabItem value="Application">
79+
80+
| Resource | Permissions |
81+
|-----------------|------------------------------|
82+
| Microsoft Graph | RoleManagement.ReadWrite.Exchange |
83+
84+
</TabItem>
85+
</Tabs>
86+
6887
## Examples
6988

7089
Assign a role specified by id to a service principal specified by id and scope the assignment to the whole tenant

‎docs/docs/cmd/file/convert/convert-pdf.mdx‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,6 @@
11
import Global from '../../_global.mdx';
2+
import Tabs from '@theme/Tabs';
3+
import TabItem from '@theme/TabItem';
24

35
# file convert pdf
46

@@ -30,6 +32,25 @@ If you choose to store the converted file in a document library, CLI will store
3032

3133
If the conversion process fails, CLI will attempt to clean up the temporary files (the source file uploaded to your tenant, if you're converting a local file to PDF, and the converted PDF file on your disk if you chose to upload the converted file to your tenant). If removing the temporary files fails, you will need to clean them up yourself. CLI will list the URL and/or path of the files to remove.
3234

35+
## Permissions
36+
37+
<Tabs>
38+
<TabItem value="Delegated">
39+
40+
| Resource | Permissions |
41+
|-----------------|---------------------------------|
42+
| Microsoft Graph | Files.ReadWrite, Sites.Read.All |
43+
44+
</TabItem>
45+
<TabItem value="Application">
46+
47+
| Resource | Permissions |
48+
|-----------------|-------------------------------------|
49+
| Microsoft Graph | Files.ReadWrite.All, Sites.Read.All |
50+
51+
</TabItem>
52+
</Tabs>
53+
3354
## Examples
3455

3556
Converts local file to PDF and stores the converted file on the disk

‎docs/docs/cmd/file/file-add.mdx‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,6 @@
11
import Global from '../_global.mdx';
2+
import Tabs from '@theme/Tabs';
3+
import TabItem from '@theme/TabItem';
24

35
# file add
46

@@ -31,6 +33,25 @@ The `folderUrl` must be an absolute URL to the document library where the file s
3133

3234
By default, the `file add` command will automatically lookup the ID of the site where you want to upload the file based on the specified `folderUrl`. It will do this, by breaking the URL into chunks and incrementally calling Microsoft Graph to retrieve site information. This is necessary, because there is no other way looking at the URL to distinguish where the site URL ends and the document library URL starts. If you want to speed up uploading files, or you use resource-specific consent and your Microsoft Entra app only has access to the specific site, you can use the `siteUrl` option to specify the URL of the site yourself.
3335

36+
## Permissions
37+
38+
<Tabs>
39+
<TabItem value="Delegated">
40+
41+
| Resource | Permissions |
42+
|-----------------|----------------------------------|
43+
| Microsoft Graph | Files.ReadWrite, Sites.ReadWrite.All |
44+
45+
</TabItem>
46+
<TabItem value="Application">
47+
48+
| Resource | Permissions |
49+
|-----------------|---------------------|
50+
| Microsoft Graph | Sites.ReadWrite.All |
51+
52+
</TabItem>
53+
</Tabs>
54+
3455
## Examples
3556

3657
Uploads file from the current folder to the root folder of a document library in the root site collection

‎docs/docs/cmd/file/file-copy.mdx‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,6 @@
11
import Global from '../_global.mdx';
2+
import Tabs from '@theme/Tabs';
3+
import TabItem from '@theme/TabItem';
24

35
# file copy
46

@@ -31,6 +33,25 @@ m365 file copy [options]
3133

3234
<Global />
3335

36+
## Permissions
37+
38+
<Tabs>
39+
<TabItem value="Delegated">
40+
41+
| Resource | Permissions |
42+
|-----------------|---------------------|
43+
| Microsoft Graph | Sites.ReadWrite.All |
44+
45+
</TabItem>
46+
<TabItem value="Application">
47+
48+
| Resource | Permissions |
49+
|-----------------|---------------------|
50+
| Microsoft Graph | Sites.ReadWrite.All |
51+
52+
</TabItem>
53+
</Tabs>
54+
3455
## Examples
3556

3657
Copy a file by server-relative URL to a document library in another site collection with server relative URL

‎docs/docs/cmd/file/file-list.mdx‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,25 @@ m365 file list [options]
3131

3232
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.
3333

34+
## Permissions
35+
36+
<Tabs>
37+
<TabItem value="Delegated">
38+
39+
| Resource | Permissions |
40+
|-----------------|----------------------------|
41+
| Microsoft Graph | Files.Read, Sites.Read.All |
42+
43+
</TabItem>
44+
<TabItem value="Application">
45+
46+
| Resource | Permissions |
47+
|-----------------|--------------------------------|
48+
| Microsoft Graph | Files.Read.All, Sites.Read.All |
49+
50+
</TabItem>
51+
</Tabs>
52+
3453
## Examples
3554

3655
Return all files from the folder _Shared Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_

‎docs/docs/cmd/file/file-move.mdx‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,6 @@
11
import Global from '../_global.mdx';
2+
import Tabs from '@theme/Tabs';
3+
import TabItem from '@theme/TabItem';
24

35
# file move
46

@@ -36,6 +38,25 @@ m365 file move [options]
3638
- If the source and target locations are within the same document library or drive, the command will utilize the Move DriveItem API, preserving the version history of the file.
3739
- If the source and target locations are in different document libraries or drives, the command will use a copy-and-delete combination to move the file. Please note that in this case, version history will not be retained.
3840

41+
## Permissions
42+
43+
<Tabs>
44+
<TabItem value="Delegated">
45+
46+
| Resource | Permissions |
47+
|-----------------|---------------------|
48+
| Microsoft Graph | Sites.ReadWrite.All |
49+
50+
</TabItem>
51+
<TabItem value="Application">
52+
53+
| Resource | Permissions |
54+
|-----------------|---------------------|
55+
| Microsoft Graph | Sites.ReadWrite.All |
56+
57+
</TabItem>
58+
</Tabs>
59+
3960
## Examples
4061

4162
Move a file by server-relative URL to a folder in the same document library

0 commit comments

Comments
 (0)