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