spo customaction remove

Removes specified custom action from site or site collection

Usage

m365 spo customaction remove [options]

Options

-i, --id [id]

Id (GUID) of the custom action to remove. Specify either id or title.

-t, --title [title]

Title of the user custom action to retrieve information for. Specify either id or title.

-u, --webUrl <webUrl>

Url of the site or site collection to remove the custom action from.

-s, --scope [scope]

Scope of the custom action. Allowed values Site, Web, All. Default All.

-f, --force

Don't prompt for confirming removal of a user custom action.

-h, --help [help]

Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, permissions, response, full. Default is options.

--query [query]

JMESPath query string. See http://jmespath.org/ for more information and examples.

-o, --output [output]

Output type. json, text, csv, md, none. Default json.

--verbose

Runs command with verbose logging.

--debug

Runs command with debug logging.

Remarks

If the command finds multiple user custom actions with the specified title, it will prompt you to disambiguate which user custom action it should use, listing the discovered IDs.

Permissions

Delegated

Resource	Permissions
SharePoint	AllSites.FullControl

Application

Resource	Permissions
SharePoint	Sites.FullControl.All

Examples

Removes user custom action with given ID located in the specified site or site collection.

m365 spo customaction remove --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --webUrl https://contoso.sharepoint.com/sites/test

Removes user custom action with given Title located in the specified site or site collection.

m365 spo customaction remove --title "YourAppCustomizer" --webUrl https://contoso.sharepoint.com/sites/test

Removes user custom action with given ID located in the specified site or site collection. Skips the confirmation prompt message.

m365 spo customaction remove --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --webUrl https://contoso.sharepoint.com/sites/test --force

Removes user custom action with given Title located in the specified site or site collection. Skips the confirmation prompt message.

m365 spo customaction remove --title "YourAppCustomizer" --webUrl https://contoso.sharepoint.com/sites/test --force

Removes user custom action with given ID located in the specified site collection.

m365 spo customaction remove --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --webUrl https://contoso.sharepoint.com/sites/test --scope Site

Removes user custom action with given Title located in site collection https://contoso.sharepoint.com/sites/test

m365 spo customaction remove --title "YourAppCustomizer" --webUrl https://contoso.sharepoint.com/sites/test --scope Site

Removes user custom action with given ID located in the specified site.

m365 spo customaction remove --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --webUrl https://contoso.sharepoint.com/sites/test --scope Web

Removes user custom action with given Title located in the specified site.

m365 spo customaction remove --title "YourAppCustomizer" --webUrl https://contoso.sharepoint.com/sites/test --scope Web

Response

The command won't return a response on success.

More information

• UserCustomAction REST API resources: https://msdn.microsoft.com/en-us/library/office/dn531432.aspx#bk_UserCustomAction