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
ortitle
-t, --title [title]
Title of the user custom action to retrieve information for. Specify either
id
ortitle
-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
. DefaultAll
--confirm
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
,response
,full
. Default isfull
.--query [query]
JMESPath query string. See http://jmespath.org/ for more information and examples.
-o, --output [output]
Output type.
json
,text
,csv
,md
. Defaultjson
.--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.
Examples
Removes user custom action with ID 058140e3-0e37-44fc-a1d3-79c487d371a3 located in site or site collection https://contoso.sharepoint.com/sites/test
m365 spo customaction remove --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --webUrl https://contoso.sharepoint.com/sites/test
Removes user custom action with Title YourAppCustomizer located in site or site collection https://contoso.sharepoint.com/sites/test
m365 spo customaction remove --title "YourAppCustomizer" --webUrl https://contoso.sharepoint.com/sites/test
Removes user custom action with ID 058140e3-0e37-44fc-a1d3-79c487d371a3 located in site or site collection https://contoso.sharepoint.com/sites/test. Skips the confirmation prompt message.
m365 spo customaction remove --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --webUrl https://contoso.sharepoint.com/sites/test --confirm
Removes user custom action with Title YourAppCustomizer located in site or site collection https://contoso.sharepoint.com/sites/test. Skips the confirmation prompt message.
m365 spo customaction remove --title "YourAppCustomizer" --webUrl https://contoso.sharepoint.com/sites/test --confirm
Removes user custom action with ID 058140e3-0e37-44fc-a1d3-79c487d371a3 located in site collection https://contoso.sharepoint.com/sites/test
m365 spo customaction remove --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --webUrl https://contoso.sharepoint.com/sites/test --scope Site
Removes user custom action with Title YourAppCustomizer 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 ID 058140e3-0e37-44fc-a1d3-79c487d371a3 located in site https://contoso.sharepoint.com/sites/test
m365 spo customaction remove --id 058140e3-0e37-44fc-a1d3-79c487d371a3 --webUrl https://contoso.sharepoint.com/sites/test --scope Web
Removes user custom action with Title YourAppCustomizer located in site https://contoso.sharepoint.com/sites/test
m365 spo customaction remove --title "YourAppCustomizer" --webUrl https://contoso.sharepoint.com/sites/test --scope Web
More information
- UserCustomAction REST API resources: https://msdn.microsoft.com/en-us/library/office/dn531432.aspx#bk_UserCustomAction