v6 Upgrade Guidance
The v6 of CLI for Microsoft 365 introduces several breaking changes. To help you upgrade to the latest version of CLI for Microsoft 365, we've listed those changes along with any actions you may need to take.
Consolidated SharePoint Online site commands
In CLI for Microsoft 365 we had several commands that were originally targeted at classic SharePoint sites. All functionality in these commands has been merged with the regular SharePoint site commands and deprecated as a result. They have therefore been removed in v6. The commands that were removed are:
Command | Merged with |
---|---|
spo site classic add | spo site add |
spo site classic list | spo site list |
spo site classic set | spo site set |
To fix a resulting issue with the spo site list
command, the default value of the type
option of that command has been removed.
What action do I need to take?
Replace references to spo site classic *
commands, with the respective spo site *
command. The options have not changed and the output of the commands has not changed as well. After updating the references test your scripts as there might be slight differences in how the commands behave.
Removed the executeWithLimitedPermission
option in the spo list list
command
In version 5 of the CLI for Microsoft 365, the spo list list
command could only be executed with site owner permissions. To update this without introducing a breaking change, we temporarily added the --executeWithLimitedPermission
option to be able to execute it as a site visitor or member as well. In v6 we removed this option while changing the command in such a way that you do not need to be a site owner anymore.
What action do I need to take?
Remove the references to the executeWithLimitedPermission
option in your scripts. Verify that your scripts work as intended with the new data structure returned by the spo list list
command.