Skip to content

Added Permissions section for external commands. Closes #6978 #7191

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
nanddeepn wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Added Permissions section for external commands. Closes #6978 #7191

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a44ec57
Added Permissions section
nanddeepn Apr 5, 2026
bfbad23
Added missing permission
nanddeepn Apr 6, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions docs/docs/cmd/external/connection/connection-add.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,6 @@
import Global from '../../_global.mdx';
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# external connection add

Expand Down Expand Up @@ -38,6 +40,25 @@ m365 search externalconnection add

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*.

## Permissions

<Tabs>
<TabItem value="Delegated">

| Resource | Permissions |
|-----------------|--------------------------------------|
| Microsoft Graph | ExternalConnection.ReadWrite.OwnedBy |

</TabItem>
<TabItem value="Application">

| Resource | Permissions |
|-----------------|--------------------------------------|
| Microsoft Graph | ExternalConnection.ReadWrite.OwnedBy |

</TabItem>
</Tabs>

## Examples

Adds a new external connection with name and description of test app.
Expand Down
19 changes: 19 additions & 0 deletions docs/docs/cmd/external/connection/connection-doctor.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -49,6 +49,25 @@ Some checks must be done manually, because there are no APIs available to verify

When you check the compatibility with all UXs, and there are multiple checks with the same ID, the command will use the first matching check, following the order listed above.

## Permissions

<Tabs>
<TabItem value="Delegated">

| Resource | Permissions |
|-----------------|----------------------------------------------------------------------|
| Microsoft Graph | ExternalConnection.ReadWrite.OwnedBy, ExternalItem.ReadWrite.OwnedBy |

</TabItem>
<TabItem value="Application">

| Resource | Permissions |
|-----------------|----------------------------------------------------------------------|
| Microsoft Graph | ExternalConnection.ReadWrite.OwnedBy, ExternalItem.ReadWrite.OwnedBy |

</TabItem>
</Tabs>

## Examples

Checks if the external connection with the specified ID is correctly configured for use with Copilot for Microsoft 365.
Expand Down
19 changes: 19 additions & 0 deletions docs/docs/cmd/external/connection/connection-get.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,25 @@ m365 search externalconnection get

<Global />

## Permissions

<Tabs>
<TabItem value="Delegated">

| Resource | Permissions |
|-----------------|--------------------------------------|
| Microsoft Graph | ExternalConnection.ReadWrite.OwnedBy |

</TabItem>
<TabItem value="Application">

| Resource | Permissions |
|-----------------|--------------------------------------|
| Microsoft Graph | ExternalConnection.ReadWrite.OwnedBy |

</TabItem>
</Tabs>

## Examples

Get the External Connection by its id.
Expand Down
19 changes: 19 additions & 0 deletions docs/docs/cmd/external/connection/connection-list.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,25 @@ m365 search externalconnection list

<Global />

## Permissions

<Tabs>
<TabItem value="Delegated">

| Resource | Permissions |
|-----------------|--------------------------------------|
| Microsoft Graph | ExternalConnection.ReadWrite.OwnedBy |

</TabItem>
<TabItem value="Application">

| Resource | Permissions |
|-----------------|--------------------------------------|
| Microsoft Graph | ExternalConnection.ReadWrite.OwnedBy |

</TabItem>
</Tabs>

## Examples

List external connections.
Expand Down
21 changes: 21 additions & 0 deletions docs/docs/cmd/external/connection/connection-remove.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,6 @@
import Global from '../../_global.mdx';
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# external connection remove

Expand Down Expand Up @@ -35,6 +37,25 @@ m365 search externalconnection remove

If the command finds multiple external connections with the specified name, it will prompt you to disambiguate which external connection it should remove, listing the discovered IDs.

## Permissions

<Tabs>
<TabItem value="Delegated">

| Resource | Permissions |
|-----------------|--------------------------------------|
| Microsoft Graph | ExternalConnection.ReadWrite.OwnedBy |

</TabItem>
<TabItem value="Application">

| Resource | Permissions |
|-----------------|--------------------------------------|
| Microsoft Graph | ExternalConnection.ReadWrite.OwnedBy |

</TabItem>
</Tabs>

## Examples

Removes external connection by its id.
Expand Down
21 changes: 21 additions & 0 deletions docs/docs/cmd/external/connection/connection-schema-add.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,6 @@
import Global from '../../_global.mdx';
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# external connection schema add

Expand Down Expand Up @@ -31,6 +33,25 @@ m365 search externalconnection schema add

<Global />

## Permissions

<Tabs>
<TabItem value="Delegated">

| Resource | Permissions |
|-----------------|--------------------------------------|
| Microsoft Graph | ExternalConnection.ReadWrite.OwnedBy |

</TabItem>
<TabItem value="Application">

| Resource | Permissions |
|-----------------|--------------------------------------|
| Microsoft Graph | ExternalConnection.ReadWrite.OwnedBy |

</TabItem>
</Tabs>

## Examples

Adds a new schema to a specific external connection.
Expand Down
21 changes: 21 additions & 0 deletions docs/docs/cmd/external/connection/connection-urltoitemresolver-add.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,6 @@
import Global from '../../_global.mdx';
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# external connection urltoitemresolver add

Expand Down Expand Up @@ -30,6 +32,25 @@ m365 external connection urltoitemresolver add [options]
```
<Global />

## Permissions

<Tabs>
<TabItem value="Delegated">

| Resource | Permissions |
|-----------------|--------------------------------------|
| Microsoft Graph | ExternalConnection.ReadWrite.OwnedBy |

</TabItem>
<TabItem value="Application">

| Resource | Permissions |
|-----------------|--------------------------------------|
| Microsoft Graph | ExternalConnection.ReadWrite.OwnedBy |

</TabItem>
</Tabs>

## Examples

Adds a URL to item resolver to an existing connection
Expand Down
19 changes: 19 additions & 0 deletions docs/docs/cmd/external/item/item-add.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -58,6 +58,25 @@ You can use the following types:

For more information about using these options, see the Microsoft Graph API documentation and documentation about Microsoft Graph connectors.

## Permissions

<Tabs>
<TabItem value="Delegated">

| Resource | Permissions |
|-----------------|--------------------------------|
| Microsoft Graph | ExternalItem.ReadWrite.OwnedBy |

</TabItem>
<TabItem value="Application">

| Resource | Permissions |
|-----------------|--------------------------------|
| Microsoft Graph | ExternalItem.ReadWrite.OwnedBy |

</TabItem>
</Tabs>

## Examples

Creates an external item with simple properties that everyone is allowed to access
Expand Down