We have just published a new major version of CLI for Microsoft 365 v3. Here is what has changed.<\/p>\n
CLI for Microsoft 365 is a cross-platform CLI that allows you to manage various configuration settings of Microsoft 365 and SharePoint Framework projects no matter which operating system or shell you use.<\/p>\n
While building solutions for Microsoft 365 expands beyond the Windows operating system, managing many of the platform settings is possible only through PowerShell on Windows. As more and more users work on non-Windows machines, it’s inconvenient for them to have to use a Windows virtual machine to configure their tenants. With the CLI for Microsoft 365, you can configure your tenant no matter which operating system you use. Additionally, using CLI for Microsoft 365, you can manage your SharePoint Framework projects.<\/p>\n
As we kept extending CLI for Microsoft 365 with new functionality during the last year, we noticed a few areas that we could improve to simplify using the CLI. As such, this new major version is evolutionary. Following is the overview of the most noteworthy changes introduced in CLI for Microsoft 365 v3. For the full list of changes, see the release notes<\/a>.<\/p>\n To help you upgrade to v3, we prepared a summary of breaking changes and the recommended actions. For more information see the v3 Upgrade Guidance<\/a> in our docs.<\/p><\/blockquote>\n Earlier this year, Microsoft renamed Office 365 to Microsoft 365 to better address the complete suite of their productivity technology. To stay consistent with the new name, we renamed Office 365 CLI<\/em> to CLI for Microsoft 365<\/em>. We hope that the new name clearly illustrates our ambition to offer you one CLI to manage all of your Microsoft 365 tenant and its services.<\/p>\n To start the CLI, in the past you’d execute in the command line Starting from version 3, CLI for Microsoft 365 is available on npm at We also renamed our GitHub repo which is now available at https:\/\/github.com\/pnp\/cli-microsoft365<\/a>. Our docs are published at https:\/\/pnp.github.io\/cli-microsoft365<\/a> or https:\/\/aka.ms\/cli-m365<\/a> for short.<\/p>\n In the past you could use CLI for Microsoft 365 in two ways. You could either execute a specific command, like In the past year we found out that the immersive mode isn’t used as much as we initially had thought it would be. While it gives instant access to command completion, it prevents you from using other shell commands. What’s more, immersive mode depends on Vorpal which the community stopped maintaining.<\/p>\n Thinking about the future, we decided to remove immersive mode and start preparing for removing Vorpal. This will allow us to keep all our dependencies up-to-date.<\/p>\n Despite our best efforts to review specs for all commands that we implement in CLI for Microsoft, over the course we picked up some inconsistencies. While we adjusted them as quickly as possible to offer you a consistent experience across all commands, we haven’t removed the original names to avoid breaking changes.<\/p>\n In this major version, we removed these previously deprecated aliases and options to keep our code base clean and maintainable for the coming releases.<\/p>\n Aside from changes, we’ve also introduced a few new commands for managing Microsoft 365.<\/p>\n In August Microsoft released a preview version of new APIs for Microsoft To Do. Following this release, Yannick Plenevaux contributed commands to list, remove and update to do lists.<\/p>\n To retrieve all Microsoft To Do lists, execute:<\/p>\n To rename a list, execute:<\/p>\n Finally, to remove a specific list, execute:<\/p>\n For more information about working with Microsoft To Do using CLI for Microsoft 365, see the docs at aka.ms\/cli-m365<\/a>.<\/p>\n In the past few months, there’s been a huge increase in Microsoft Teams usage. After the pandemic forced our hand, Teams became the primary tool to facilitate collaboration in many organization, who often had to speed up their rollout plans and let their employees work from home.<\/p>\n While deploying Teams, many organizations want to go beyond the standard setup and offer their employees a set of additional applications they can use to work more effectively. But managing these applications at scale can quickly become cumbersome. To help organizations remove unnecessary apps, Aakash Bhardwaj contributed a command to uninstall personal apps.<\/p>\n To uninstall a personal Teams app, execute:<\/p>\n For more information about managing Microsoft Teams using CLI for Microsoft 365, see the docs at aka.ms\/cli-m365<\/a>.<\/p>\n One of the most complex areas of governing Microsoft 365 is permission management. Across Microsoft 365, different services have a different way of managing their permissions and which all require separate configuration. One of such services is SharePoint, where each site, list or a file can be secured separately.<\/p>\n To help you keep track of permissions in your sites, Dipen Shah contributed a command that lets you list groups from the specific web.<\/p>\n To get groups from a specific web, execute:<\/p>\n Preparing for the rollout of Knowledge Hub Sites, Arjun Menon contributed a command that lets you set the knowledge hub site for your tenant.<\/p>\n To set a knowledge hub site for your tenant, execute:<\/p>\n As the functionality is released, you can expect more commands related to managing knowledge sites in CLI for Microsoft 365.<\/p>\n This release wouldn’t be also possible without the help of (in alphabetical order) Aakash Bhardwaj<\/a>, Velin Georgiev<\/a>, Arjun Menon<\/a>, Waldek Mastykarz<\/a>, Nanddeep Nachan<\/a>, Yannick Plenevaux<\/a>, Roman Rozinov<\/a>, Albert-Jan Schot<\/a>, Dipen Shah<\/a>, Garry Trinder<\/a>, Joseph Velliah<\/a> and Rabia Williams<\/a> as well as all other contributors we had to date. There wouldn’t be a v3 without the v2 and v1, which you helped to build. Thank you all so much for the time you chose to spend on CLI for Microsoft 365!<\/p>\n With the big refactoring behind us, we’re going to focus on adding more commands and improving the existing ones. Like always, we’re listening for feedback and ideas for improvements. We can’t promise we’ll implement everything, but we will definitely engage in the discussion to better understand your suggestions.<\/p>\n Microsoft 365 is evolving and new capabilities are being released every day. With CLI for Microsoft 365, we aim to help you manage your tenant on any platform in a consistent way, no matter which part of Microsoft 365 you interact with. While we keep adding new commands to CLI for Microsoft 365 each release, we still barely scratched the surface with what\u2019s possible in Microsoft 365. In the upcoming versions of the CLI for Microsoft, you can expect us to add more commands across the different workloads in Microsoft 365.<\/p>\n In every release of CLI for Microsoft 365, we introduce new commands for managing Microsoft 365. With almost 400 commands across the different Microsoft 365 services, CLI for Microsoft 365 has become a powerful tool, not just for managing your tenant but also for automating your daily work.<\/p>\n We\u2019d love to show you how you can use CLI for Microsoft 365 to build automation scripts in PowerShell Core and Bash. If you have any scripts using SPO or PnP PowerShell that you use frequently, please share them with us so that we can learn more about the common automation scenarios.<\/p>\n Currently, CLI for Microsoft 365 has dedicated commands for retrieving, creating, and updating resources. If you were to create a script that ensures a specific configuration, for each resource you\u2019d need to see if it exists, create it if it doesn\u2019t, or update it if it does.<\/p>\n We\u2019re thinking about simplifying this scenario by introducing commands with a new verb named ensure. For example, to ensure that a particular site collection exists, instead of executing a combination of We\u2019ll start to implement this idea on the At this moment, the most of SharePoint We\u2019re thinking about addressing this limitation by allowing you to set the value of any property exposed on the SharePoint object. This would work only for properties that have values of simple types like bool, string or int because complex values likely can\u2019t be serialized to string without additional logic.<\/p>\n We would offer rudimentary logic of checking if the specified properties are valid, by examining the latest version of the SPO CSOM assemblies and checking which properties on the particular SharePoint class have setters and values of the supported types and thus can be used.<\/p>\n What do you think of this approach? Would this help to solve a problem you have? In the previous release, we have extended the spo web set command with this functionality. We\u2019d love you to try it and tell us what you think.<\/p>\n Get the latest release of CLI for Microsoft 365 from npm by executing in the command line:<\/p>\n If you need more help getting started or want more details about the commands, the architecture or the project, go to aka.ms\/cli-m365<\/a>. If you see any room for improvement, please, don’t hesitate to reach out to us either on GitHub<\/a>, or on twitter with the #CLIMicrosoft365 hashtag.<\/p>\n","protected":false},"excerpt":{"rendered":" We’ve just published a new version of CLI for Microsoft 365 with commands for managing Microsoft 365 tenants and SharePoint Framework projects on any platform.<\/p>\n","protected":false},"author":69079,"featured_media":25159,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[11],"tags":[143,53,140,19],"class_list":["post-5142","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-office-add-ins","tag-cli-for-microsoft-365","tag-office-365","tag-office-365-cli","tag-sharepoint-framework"],"acf":[],"blog_post_summary":" We’ve just published a new version of CLI for Microsoft 365 with commands for managing Microsoft 365 tenants and SharePoint Framework projects on any platform.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/5142","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/users\/69079"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=5142"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/5142\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/25159"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=5142"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=5142"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=5142"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}New name: Office 365 CLI<\/em> becomes CLI for Microsoft 365<\/em><\/h3>\n
office365<\/code> or o365<\/code> for short. In the latest version 2 we’ve already introduced the new executable names microsoft365<\/code> or m365<\/code>. Starting from v3, the office365<\/code> and o365<\/code> executables are no longer available and you can execute CLI for Microsoft 365 commands only using microsoft365<\/code> or m365<\/code>.<\/p>\n@pnp\/cli-microsoft365<\/code>. Version 2 of the CLI available at @pnp\/office365-cli<\/code> will remain available on npm, but will be deprecated. We won’t be updating it anymore and recommend that you upgrade to version 3 to benefit of the latest additions and improvements.<\/p>\nRemoved immersive mode<\/h3>\n
o365 spo site list<\/code> or you could start the CLI in immersive mode by running o365<\/code> and get a CLI-specific command prompt.<\/p>\nRemoved obsolete aliases and options<\/h3>\n
New commands<\/h3>\n
Manage Microsoft To Do lists<\/h4>\n
m365 todo list<\/span> list<\/span>\n<\/code><\/pre>\nm365 todo list set<\/span> --id \"AAMkAGI3NDhlZmQzLWQxYjAtNGJjNy04NmYwLWQ0M2IzZTNlMDUwNAAuAAAAAACQ1l2jfH6VSZraktP8Z7auAQCbV93BagWITZhL3J6BMqhjAAD9pHIhAAA=\"<\/span> --new<\/span>Name<\/span> \"My updated task list\"<\/span>\n<\/code><\/pre>\nm365 todo list<\/span> remove --name<\/span> \"My task list\"<\/span>\n<\/code><\/pre>\nUninstall personal Teams app<\/h4>\n
m365<\/span> teams user app remove --appId YzUyN2<\/span>E0<\/span>NzAtYTg4<\/span>Mi00<\/span>ODFjLTk4<\/span>MWMtZWU2<\/span>ZWZhYmE4<\/span>NWM3<\/span>IyM0<\/span>ZDFlYTA0<\/span>Ny1<\/span>mMTk2<\/span>LTQ1<\/span>MGQtYjJlOS0<\/span>wZDI4<\/span>NTViYTA1<\/span>YTY= --userId 2609<\/span>af39<\/span>-7775<\/span>-4<\/span>f94<\/span>-a3<\/span>dc-0<\/span>dd67657<\/span>e900<\/span>\n<\/code><\/pre>\nList groups from specific web<\/h4>\n
m365 spo group<\/span> list<\/span> --webUrl \"https:\/\/contoso.sharepoint.com\/sites\/contoso\"<\/span>\n<\/code><\/pre>\nSet Knowledge Hub Site<\/h4>\n
m365 spo knowledgehub set<\/span> --url https:<\/span>\/\/contoso.sharepoint.com<\/span>\/sites\/knowledgesite<\/span>\n<\/code><\/pre>\nContributors<\/h2>\n
What’s next<\/h2>\n
More commands, what else<\/h3>\n
Script examples<\/h3>\n
ensure<\/code> commands<\/h3>\nspo site list<\/code>\/spo site get<\/code>, spo site add<\/code> and spo site set<\/code>, you\u2019d execute spo site ensure<\/code> with the necessary parameters which would automatically verify if the particular site exists and matches your configuration. If the site doesn\u2019t exist, it would create it. If it does, the command would check if the properties you specified to match the retrieved site and update them if necessary.<\/p>\nspo site<\/code> commands. We\u2019d love to hear from you if it\u2019s something that you\u2019d find helpful and what other objects we should take into account.<\/p>\nSetting arbitrary properties on SharePoint objects<\/h3>\n
set<\/code> commands in CLI for Microsoft 365 support only a handful of options that correspond to the properties of their SharePoint class, like Web<\/code>, Site<\/code>, List<\/code>, etc. This is similar to how the Set-PnP*<\/code> cmdlets work. However, because PnP PowerShell works with CSOM, this limitation there is often circumvented, by retrieving the CSOM object, updating its properties, and calling $object.ExecuteQuery()<\/code> to persist the changes outside of PnP cmdlets. Because the CLI doesn\u2019t use CSOM, this isn\u2019t possible and users are limited to using whatever options are exposed by the CLI commands.<\/p>\nTry it today<\/h2>\n
npm<\/span> i<\/span> -g<\/span> @pnp<\/span>\/cli<\/span>-microsoft365<\/span>\n<\/code><\/pre>\n