Skip to content

Release notes

v3.5.0

New commands

Adaptive Cards:

Azure Active Directory:

File:

Power Automate:

Changes

  • updated 'teams team add' to use Microsoft Graph v1.0 API #2020
  • applied multiple performance improvements #2047
  • fixed 'page header set' command #2049, #2050
  • added wait-npm-publish script to CI/CD #2053
  • added support for passing complex content from files #2042
  • added support for adding page description to 'spo page add' and 'spo page set' #2044
  • added new sample script for emptying the tenant recycle bin #1142
  • updated sample script changing CLI command name to m365 #2063
  • added new sample script 'Export all Flows in environment' #2082
  • added new sample script 'List all application customizers' #2074
  • changed secret expiration to 1 year in aad app add #2064

v3.4.0

New commands

SharePoint:

Teams:

Yammer:

  • yammer search - returns a list of messages, users, topics and groups that match the specified query #1454

Changes

  • updated docs for the login command with links to more info #1966
  • moved global options in docs to a separate file #1852, #1969
  • extended login with support for passing base64-encoded certificate #1971
  • extended login with calculating thumbprint from the certificate #1973
  • fixed 'spo listitem set' command #1984
  • changed loading optional dependencies to lazy to speed up CLI #1990
  • extended login with support for .pfx certificates not protected with a password #1974
  • fixed the outlook mail send command #1991
  • extended the login command with appId and tenant #1975
  • fixed the spo apppage add command #2000
  • removed short options from args passed to commands #1992
  • extended spo sitedesign get to include title #1884
  • removed unnecessary request digest from spo sitedesign list #2006
  • fixed issue with resolving uppercase URLs #2011
  • added Dockerfile #1786
  • added line information to JSON-based rules in 'spfx project upgrade' #1602
  • removed the 'started' telemetry event #2018
  • clarified SPFx project upgrade actions #1857, #1569
  • added preserving page content to spo page header set #2019

v3.3.0

New commands

Power Automate:

SharePoint:

Teams:

To Do:

Changes

  • extended channel list with teamName #1889
  • extended 'teams channel get' command with support for teamName and channelName options #1887
  • extended 'spo tenant settings set' with DisableCustomAppAuthentication #1829
  • added the 'Analyze Microsoft 365 User Profile Photos using Azure Computer Vision API' sample script #1894
  • fixed displaying command groups in alphabetical order in help #1922
  • fixed excluding command and arguments as field values in 'spo file add' #1936
  • refactored processing command output #1552, #1823 and #1875
  • fixed displaying help for command's alias #1907
  • added tracking output mode to telemetry #1946
  • fixed retrieving unknown options #1947
  • renamed query to camlQuery in spo listitem list #1948
  • fixed user-agent header #1951
  • fixed user guide env. variable naming #1954
  • made 'console.log()' synchronous #1266
  • extended todo task list with id #1943

v3.2.0

New commands

Azure Active Directory:

Microsoft Teams:

SharePoint:

Changes

  • removed Vorpal #1737
  • extended 'todo list set' with name #1806
  • updated 'aad approleassignment list' to v1.0 graph API #1604
  • removed CommandInstance and simplifies validate() #1821
  • replaced request with Axios #1363
  • added quotes to paths in shell commands #1849
  • fixed 'flow export' command #1845
  • extended 'spo site remove' with support for M365 groups #1561
  • added the 'Deploy a Microsoft Teams personal app and add it to users' sample script #1867
  • added Teams scope to the list of default permissions in the docs #1860
  • updated 'aad approleassignment add' to use Microsoft Graph #1858
  • added the 'Removes Microsoft Teams personal app from users and Microsoft Teams app catalog' sample script #1883
  • extended 'teams app list' with support for using Team's name #1861
  • excluded missing global options in 'spo tenant settings set' #1903
  • added support for specifying Team name in teams channel add #1888
  • excluded missing global options in 'aad user list' #1909
  • fixed 'spo file get' for large files #1796

v3.1.0

New commands

Microsoft 365:

Outlook:

Power Apps:

SharePoint:

Changes

  • added the 'Remove orphaned redirect sites' sample script #1717
  • extended 'spo page get' json output to include all returned properties #1729
  • extended 'spfx doctor' with support for SPFx v1.11 #1721
  • extended 'tenant status list' with filtering by workload #1743
  • fixed long running copy and move operations #1698
  • added 'm365' alias to examples in docs and help #1694
  • added support for parsing JSON with BOM to 'spfx project upgrade' #1723
  • renamed token file use the new CLI name #1810

v3.0.0

New commands

Microsoft Teams:

Microsoft To Do:

SharePoint:

Changes

  • fixed 'spo search' command #1696
  • added the 'Export Configurations of Tenant Wide Extensions' sample script #1440
  • extended 'spo site set' with sharing capabilities #1713
  • removed deprecated 'id' option in 'spo site set' #1536
  • removed deprecated exit code in 'spfx project upgrade' #1418
  • removed immersive mode #1600
  • removed '-h' as option #1680
  • removed deprecated 'accesstoken get' alias #1368
  • removed '--pretty' global option #1338
  • removed deprecated aliases #1339
  • renamed 'Office 365 CLI' to 'CLI for Microsoft 365' #1635
  • added 'owners' option for CommunicationSite creation using 'spo site add' #1734
  • added LCID validation to 'spo site add' #1749
  • added "Caveats when certificate login" doc #1734, #1738
  • removed obsolete outputFile option #1769
  • renamed environment variables from OFFICE365CLI to CLIMICROSOFT365 #1787
  • extended 'spo web set' with welcomePage #1730

v2.13.0

New commands

SharePoint:

Changes

  • added the 'List app usage in Microsoft Teams' sample script #1640
  • fixed the 'Get user with login name' example for 'spo user get' command #1707
  • updated CodeTour SPFx upgrade report schema #1708
  • consolidated 'spo site add' and 'spo site classic add' commands #1493

v2.12.0

New commands

Microsoft Graph:

SharePoint:

SharePoint Framework:

Changes

  • added the 'Sync SharePoint Document Library Documents with Azure Storage Container' sample script #1685
  • added support for upgrading projects built using SharePoint Framework v1.11.0 #1714

v2.11.0

Changes

  • added the 'remove wiki tab from a Microsoft Teams channel' sample script #1506
  • fixed suggesting incorrect componentType #1574
  • added m365 and microsoft365 executables #1637
  • consolidated spo site remove and spo site classic remove commands #1494
  • added suggesting upgrading dependency @microsoft/sp-page-context #1521
  • added suggesting upgrading dependency @microsoft/sp-odata-types #1520
  • added suggesting upgrading dependency @microsoft/sp-module-interfaces #1519
  • added suggesting upgrading dependency @microsoft/sp-loader #1518
  • added suggesting upgrading dependency @microsoft/sp-list-subscription #1517
  • fixed detecting onprem SPFx projects' versions #1647
  • extended 'teams team add' with support for Teams templates #916
  • extended 'spo field remove' with removing all fields from a group #1381
  • fixed incorrect path in FN018001 #1661
  • fixed incorrect path in FN018003 and FN018004 #1662
  • fixed resolution of paths on Windows in 'spfx project upgrade'
  • added the 'Insert pictures in a SharePoint Document Library into a Word document' sample script #1653
  • extended 'teams team add' with support for returning team information #1654
  • fixes bug in returning lists #1667

v2.10.0

New commands

Azure Active Directory:

  • aad approleassignment add - adds service principal permissions also known as scopes and app role assignments for specified Azure AD application registration #1581

Microsoft Teams:

Microsoft To Do:

Yammer:

Changes

  • added support for more module types in spfx project externalize #1192
  • fixed indentation of resolution for FN012010 #1467
  • fixes description of FN003003 #1469
  • updated MPA docs with Docker image version #1531
  • simplified persisting login information #1313
  • updated the Authenticate with Microsoft Graph sample replacing the deprecated method #1548
  • included PowerShell completion script in the package #1551
  • added Flow inventory sample script #1522
  • added managed identity authentication #1314
  • fixed 'teams team add' command #1497
  • extended 'spo site set' with additional options #1478
  • added the 'Bulk add/remove users to Microsoft Teams and Microsoft 365 Groups' sample script #1540
  • updates the 'cli consent' command references #1542
  • fixed 'aad user list' command #1553
  • ensured all global options are ignored in request bodies #1563
  • fixed windows builds #1544
  • added missing '}' in FN011008 resolution #1509
  • fixed issue with logging out after running tests #1570
  • fixed incorrect import suggestions in FN016004 #1484
  • fixed indentation of FN011010 resolution #1485
  • moved SPFx test projects to a common location #1507
  • added suggesting upgrading dependency @microsoft/sp-component-base #1512
  • made FN011008 supersede FN011009 #1510
  • added FN017001 to the summary #1511
  • added suggesting upgrading dependency @microsoft/sp-diagnostics #1513
  • added suggesting upgrading dependency @microsoft/sp-dynamic-data #1514
  • added suggesting upgrading dependency @microsoft/sp-extension-base #1515
  • extended 'aad approleassignment list' with --objectId option #1579
  • added 'Using your own Azure AD identity' to docs #1496
  • added the 'Disable the specified tenant-wide extension' sample script #1444
  • added suggesting upgrading dependency @microsoft/sp-http #1516
  • added the 'Add custom client-side web part to modern page' sample script #1438
  • added CodeTour report for spfx project upgrade #1592
  • extended 'aad sp get' with --objectId option #1567
  • removed reserved shortcut from 'aad approleassignment list' objectId option #1607

v2.9.0

New commands

Azure Active Directory:

Microsoft Teams:

Microsoft 365:

SharePoint:

Yammer:

Changes

  • added 'Scan Microsoft 365 Groups created with User's First or Last Name' sample #1342
  • extended tenant id get with retrieving the ID of the current tenant #1378
  • changed communicating no need to upgrade spfx project as a non-error #1407
  • moved the 'consent' command to the 'cli' namespace #1336
  • implemented '--reconsent' as a CLI command #1337
  • updated docs wrapping file names in quotes #1410
  • replaced | (pipe) with , (comma) in the docs #1420
  • added conditionally suggesting upgrading Office UI Fabric scss files #1468
  • added the 'Ensure site assets library is created' sample script #1447
  • added the 'List all tenant-wide extensions' sample script #1443
  • fixed guidance for upgrading teams piece in spfx project upgrade #1471
  • extended spo theme set command with support for theme validation #1466
  • fixed resolution of FN003005_CFG_localizedResource_pathLib in spfx project upgrade #1470
  • updated Theme Generator URL on spo theme set & spo theme apply commands #1465

v2.8.0

New commands

Microsoft Graph:

Microsoft 365:

SharePoint:

SharePoint Framework:

  • spfx doctor - verifies environment configuration for using the specific version of the SharePoint Framework #1353

Skype:

  • skype report activitycounts - gets the trends on how many users organized and participated in conference sessions held in your organization through Skype for Business. The report also includes the number of peer-to-peer sessions #1302
  • skype report activityusercounts - gets the trends on how many unique users organized and participated in conference sessions held in your organization through Skype for Business. The report also includes the number of peer-to-peer sessions #1303
  • skype report activityuserdetail - gets details about Skype for Business activity by user #1301

Yammer:

Changes

  • added 'Add App Catalog to SharePoint site' sample #1413
  • added 'Delete all Microsoft 365 groups' sample #1140
  • added 'Delete custom SharePoint site scripts' sample #1139
  • added 'Hide SharePoint list from Site Contents' sample #1413
  • extended team channel name validation to allow 'tacv2'. #1401

v2.7.0

New commands

Azure Active Directory:

Microsoft Graph:

Microsoft 365:

SharePoint:

Microsoft Teams:

Yammer:

Changes

  • added PowerShell command completion #261
  • added 'since' option to 'teams message list' command #1125
  • extended 'spo file add' with chunked uploads #1052
  • added support for prettifying json output #1324
  • fixed bug in retrieving modern pages from root site #1328
  • extended 'spo site list' command with support for returning deleted sites #1335
  • exposed completion commands as CLI commands #1329
  • fixed bug in retrieving files with special characters #1358
  • added alias to 'accesstoken get' #1369

v2.6.0

New commands

Microsoft Graph:

Power Apps:

SharePoint:

Yammer:

Changes

  • added support for file edit suggestions #1190
  • added support for JMESPath #1315
  • made non-immersive mode completion standalone #1316
  • added GitHub Actions documentation #1094
  • added the 'Delete all non group connected SharePoint sites' example #1141

v2.5.0

New commands

OneDrive:

SharePoint:

Changes

  • fixed error using command spo listitem add when text field value only contains numbers #1297
  • added support for upgrading projects built using SharePoint Framework v1.9.1 #1310

v2.4.0

New commands

OneDrive:

Outlook:

SharePoint:

Yammer:

Power Apps:

Changes

  • added support for setting CSOM properties on web #1202
  • Rush stack compiler made optional for 1.9.1 upgrade #1222

v2.3.0

New commands

SharePoint Framework:

Yammer:

Changes

  • added the 'Authenticate with and call the Microsoft Graph' example #1186
  • fixed the 'spo hubsite list' command #1180
  • fixed the 'spo file add' command #1179
  • added case-sensitive option parsing #1182
  • added 'Lists active SharePoint site collection application catalogs' sample #1194
  • extended the 'yammer message list' command #1184
  • excluded unsupported modules in 'spfx project externalize' #1191

v2.2.0

New commands

Azure Active Directory:

Flow:

PowerApps:

SharePoint Online:

Microsoft Teams:

Yammer:

Changes

  • updated pa commands to reflect official pac cli v1.0.6 #1129
  • added the 'Govern orphaned Microsoft Teams' example #1147
  • added the 'remove custom themes' example #1137
  • corrected 'aad o365group user list' alias #1149
  • updated 'spo storageentity set' docs about handling trailing slash #1153
  • updated vorpal to 1.11.7 #1150
  • added versions to deps for building docs in CI #1157
  • added the 'consent' command #1162
  • added the 'Delete custom SharePoint site designs' example #1138

v2.1.0

New commands

SharePoint Online:

Microsoft Teams:

PowerApps:

Global:

Changes

  • updated vorpal to 1.11.6 #1092
  • removed spo-specific action implementation #1092
  • implemented passing AAD error during device code auth #1095
  • added handling forbidden errors #1096
  • fixed handling Flow nextLink #1114
  • added support for multi-shell #887
  • renamed the outlook sendmail command #1103
  • extended teams report commands with support for specifying output file #1075
  • added support for adding web parts to empty pages #740

v2.0.0

New commands

SharePoint Online:

Microsoft Teams:

Microsoft Flow:

Microsoft 365 groups:

Microsoft Graph:

Changes

  • simplified login #889
  • API name removed from the command name #890
  • extended 'spo web set' with searchScope option #947
  • fixed 'Access token is empty' error for 'teams report deviceusageuserdetail' #1025
  • updated documentation on connecting the CLI when protected cert #1023
  • extended 'spfx project upgrade' with outputFile option #984
  • login extended with support for authentication using Personal Information Exchange (.pfx) file #1030

v1.23.0

  • added support for upgrading projects built using SharePoint Framework v1.8.2 #1044

v1.22.0

New commands

SharePoint Online:

Microsoft Graph:

Microsoft 365:

Changes

  • extended 'spo site add' with support for specifying owners #823
  • extended 'graph o365group list' with support for orphaned groups #959
  • added support for superseding SPFx project upgrade findings #970
  • added support for package managers #617
  • extended 'spo page set' with support for promoting as template #978
  • extended 'spo page add' with support for promoting as template #977

v1.21.0

New commands

SharePoint Online:

Microsoft Graph:

v1.20.0

New commands

SharePoint Online:

Microsoft Graph:

Changes

  • extended 'spo theme apply' with support for applying standard themes #920
  • improved detecting SPFx React projects solving #968

v1.19.0

Changes

  • added support for upgrading projects built using SharePoint Framework v1.8.1 #934

v1.18.0

New commands

SharePoint Online:

Microsoft Graph:

Changes

  • centralized executing HTTP requests solving #888
  • fixed bug in loading commands #942
  • fixed saving files in 'spo file get' #931
  • extended 'spo web set' to control footer visibility #946

v1.17.0

New commands

SharePoint Online:

Microsoft Graph:

Changes

  • updated documentation on using custom AAD app #895
  • added validation for Teams channel IDs #909
  • fixed the 'spo page clientsidewebpart add' command #913
  • fixed typo in the 'spo tenant settings set' command options #923
  • updated commands to use MS Graph v1.0 endpoint #865
  • added support for upgrading projects built using SharePoint Framework v1.8.0 #932

v1.16.0

New commands

SharePoint Online:

Microsoft Graph:

Changes

  • extended 'graph teams app list' #859
  • added 'spo site groupify' alias #873
  • fixed the 'spo page section add' command #908
  • fixed the 'spo page header set' command #911

v1.15.0

New commands

SharePoint Online:

Microsoft Graph:

Changes

  • fixed ID of the FN002009 SPFx project upgrade rule #854
  • fixed issue with updating the header of non-en-US pages #851
  • added support for upgrading projects built using SharePoint Framework v1.7.1 #848

v1.14.0

New commands

SharePoint Online:

Microsoft Graph:

Changes

  • updated 'spo list webhook list' parameters #747
  • updated 'azmgmt flow list' to support paged content #776
  • added fieldTitle, listId and listUrl options to 'spo file get' #754
  • extended 'spo sitedesign apply' with large site designs #714
  • added support for dynamic data #751
  • extended 'spo web set' with modern UI options #798

v1.13.0

New commands

SharePoint Online:

Microsoft Graph:

Changes

  • added support for specifying language when creating site #728
  • fixed bug in setting client-side web part order #712
  • added support for authentication using certificate #389
  • renamed 'graph teams channel message get' to 'graph teams message get'
  • extended 'spo folder copy' with support for schema mismatch #706
  • extended 'spo file copy' with support for schema mismatch #705
  • updated showing scope in 'spo customaction list' #742
  • extended 'spo hubsite list' with info about associated sites #709
  • added support for SPO-D URLs solving #759

v1.12.0

New commands

SharePoint Online:

Changes

  • added support for site collection app catalog in the spo app install, -retract, -uninstall and -upgrade commands #405
  • fixed bug with caching tokens for SPO commands #719

v1.11.0

New commands

SharePoint Online:

Changes

  • added support for setting page title #693
  • added support for adding child navigation nodes #695
  • added support for specifying web part data and fixed web parts lookup #701, #703
  • removed treating values of unknown options as numbers #702
  • added support for site collection app catalog in the spo app add, -deploy, -get, -list and -remove commands #405 (partially)
  • added support for upgrading projects built using SharePoint Framework v1.7.0 #716

v1.10.0

New commands

SharePoint Online:

Microsoft Graph:

Changes

  • added support for adding child terms #686

v1.9.0

Changes

  • added support for upgrading projects built using SharePoint Framework v1.6.0 #663

v1.8.0

New commands

SharePoint Online:

Microsoft Graph:

Changes

  • improved SPFx project upgrade text report #591
  • updated the 'spo tenant settings list' command #623
  • changed commands to be lazy-loaded #624
  • added error codes to the 'spfx project upgrade' command #630
  • changed vorpal dependency to https #637
  • added retrieving GuestUsageGuidelinesUrl #640

v1.7.0

New commands

SharePoint Online:

Microsoft Graph:

Azure Management Service:

Changes

  • added support for upgrading projects built using SharePoint Framework v1.5.1 #569
  • added support for setting debug and verbose mode using an environment variable #54
  • extended the 'spo cdn set' command, solving. Added support for managing both CDNs. Added support for enabling CDNs without provisioning default origins #230
  • fixed bug in reporting SPFx project upgrade findings solving #582
  • fixed upgrade SPFx 1.6.0 FN012012 always returns a finding #580
  • combined npm commands in SPFx project upgrade summary solving #508
  • renamed 'connect' commands to 'login' #574
  • updated docs on escaping objectId in aad oauth2grant set and remove #606
  • added 'npm dedupe' SPFx project upgrade rule #612

v1.6.0

New commands

SharePoint Online:

Microsoft Graph:

Changes

  • added support for upgrading projects built using SharePoint Framework v1.1.3 #485
  • added support for upgrading projects built using SharePoint Framework v1.1.1 #487
  • added support for upgrading projects built using SharePoint Framework v1.1.0 #488
  • added support for upgrading projects built using SharePoint Framework v1.0.2 #537
  • added support for upgrading projects built using SharePoint Framework v1.0.1 #536
  • added support for upgrading projects built using SharePoint Framework v1.0.0 #535
  • fixed created content type have different ID than specified #550

v1.5.0

New commands

SharePoint Online:

Changes

  • fixed exit code on error in the 'spo site add' command #511
  • Added support for retrieving apps by their name #516

v1.4.0

New commands

SharePoint Online:

SharePoint Framework:

Changes

  • refactored to return non-zero error code on error #468
  • fixed adding item to list referenced by id #473
  • added support for upgrading projects built using SharePoint Framework v1.4.0 #478
  • added support for upgrading projects built using SharePoint Framework v1.3.4 #479
  • added support for upgrading projects built using SharePoint Framework v1.3.2 #481
  • added support for upgrading projects built using SharePoint Framework v1.3.1 #482
  • added support for upgrading projects built using SharePoint Framework v1.3.0 #483
  • added support for upgrading projects built using SharePoint Framework v1.2.0 #484
  • clarified usage of the spo file get command #497
  • added support for upgrading projects built using SharePoint Framework v1.5.0 #505

v1.3.0

New commands

SharePoint Online:

Microsoft Graph:

Changes

  • added support for re-consenting the AAD app #421
  • added update notification #200
  • extended the 'spo app deploy' command to support specifying app using its name #404
  • extended the 'spo app add' command to return the information about the added app #463

v1.2.0

New commands

SharePoint Online:

Microsoft Graph:

Changes

  • added support for authenticating using credentials solving #388

v1.1.0

New commands

SharePoint Online:

Microsoft Graph:

Azure Management Service:

Updated commands

Microsoft Graph:

Changes

  • fixed bug in retrieving Microsoft 365 groups in immersive mode solving #351

v1.0.0

Breaking changes

  • switched to a custom Azure AD application for communicating with Microsoft 365. After installing this version you have to reconnect to Microsoft 365

New commands

SharePoint Online:

Microsoft Graph:

Changes

v0.5.0

Breaking changes

New commands

SharePoint Online:

Changes

v0.4.0

Breaking changes

New commands

SharePoint Online:

Azure Active Directory Graph:

  • aad login - log in to the Azure Active Directory Graph #160
  • aad logout - log out from Azure Active Directory Graph #161
  • aad status - shows Azure Active Directory Graph login status #162
  • aad sp get - gets information about the specific service principal #158
  • aad oauth2grant list - lists OAuth2 permission grants for the specified service principal #159
  • aad oauth2grant add - grant the specified service principal OAuth2 permissions to the specified resource #164
  • aad oauth2grant set - update OAuth2 permissions for the service principal #163
  • aad oauth2grant remove - remove specified service principal OAuth2 permissions #165

Changes

  • added support for persisting connection #46
  • fixed authentication bug in spo app install, spo app uninstall and spo app upgrade commands when connected to the tenant admin site #118
  • fixed authentication bug in the spo customaction get command when connected to the tenant admin site #113
  • fixed bug in rendering help for commands when using the --help option #104
  • added detailed output to the spo customaction get command #93
  • improved collecting telemetry #130, #131, #132, #133
  • added support for the skipFeatureDeployment flag to the spo app deploy command #134
  • wrapped executing commands in try..catch #109
  • added serializing objects in log #108
  • added support for autocomplete in Zsh, Bash and Fish and Clink (cmder) on Windows #141, #190

v0.3.0

New commands

SharePoint Online:

Changes

  • changed command output to silent #47
  • added user-agent string to all requests #52
  • refactored spo cdn get and spo storageentity set to use the getRequestDigest helper #78 and #80
  • added common handler for rejected OData promises #59
  • added Google Analytics code to documentation #84
  • added support for formatting command output as JSON #48

v0.2.0

New commands

SharePoint Online:

v0.1.1

Changes

  • Fixed bug in resolving command paths on Windows

v0.1.0

Initial release.

New commands

SharePoint Online: