

Release notes

v3.1.0

New commands

Microsoft 365:

• tenant service list - gets services available in Microsoft 365 #1740
• tenant service message list - gets service messages Microsoft 365 #1741
• tenant service report historicalservicestatus - gets the historical service status of Microsoft 365 Services of the last 7 days #1742

Outlook:

• outlook message list - gets all mail messages from the specified folder #1764
• outlook message move - moves message to the specified folder #1765

Power Apps:

• pa app list - lists all Power Apps apps #1789

SharePoint:

• spo knowledgehub remove - removes the Knowledge Hub Site setting for your tenant #1577

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:

• teams app user remove - uninstall an app from the personal scope of the specified user #1711

Microsoft To Do:

• todo list list - returns a list of Microsoft To Do task lists #1609
• todo list remove - removes a Microsoft To Do task list #1611
• todo list set - updates a Microsoft To Do task list #1612

SharePoint:

• spo group list - lists groups from specific web #1691
• spo knowledgehub set - sets the Knowledge Hub Site for your tenant #1576

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:

• spo group remove - removes group from specific web #1693
• spo user list - lists all the users within specific web #1672
• spo userprofile set - sets user profile property for a SharePoint user #1671

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:

• graph schemaextension list - gets a list of schemaExtension objects created in the current tenant #12

SharePoint:

• spo group get - gets site group #1692
• spo tenant appcatalog add - creates new tenant app catalog site #1646
• spo user get - gets a site user within specific web #1673
• spo user remove - removes user from specific web #1674

SharePoint Framework:

• spfx project rename - renames SharePoint Framework project #1349

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:

• teams user app add - install an app in the personal scope of the specified user #1450

Microsoft To Do:

• todo list add - adds a Microsoft To Do task list #1610

Yammer:

• yammer group user add - adds a user to a Yammer Group #1456
• yammer group user remove - removes a user from a Yammer group #1457
• yammer message like set - likes or unlikes a Yammer message #1455

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:

• aad o365group report activitystorage - get the total storage used across all group mailboxes and group sites #1286

Microsoft Teams:

• teams tab remove - removes a tab from the specified channel #1449

Microsoft 365:

• tenant status list - gets health status of the different services in Microsoft 365 #1272

SharePoint:

• spo orgassetslibrary add - promotes an existing library to become an organization assets library #1040

Yammer:

• yammer report activitycounts - gets the trends on the amount of Yammer activity in your organization by how many messages were posted, read, and liked #1383
• yammer report activityusercounts - gets the trends on the number of unique users who posted, read, and liked Yammer messages #1384
• yammer report activityuserdetail - gets details about Yammer activity by user #1382
• yammer report deviceusagedistributionusercounts - gets the number of users by device type #1386
• yammer report deviceusageusercounts - gets the number of daily users by device type #1387
• yammer report deviceusageuserdetail - gets details about Yammer device usage by user #1287
• yammer report groupsactivitydetail - gets details about Yammer groups activity by group #1388
• yammer report groupsactivitygroupcounts - gets the total number of groups that existed and how many included group conversation activity #1389

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:

• graph subscription add - creates a Microsoft Graph subscription #1100

Microsoft 365:

• tenant report activeuserdetail - gets details about Microsoft 365 active users #1300
• tenant report servicesusercounts - gets the count of users by activity type and service #1299

SharePoint:

• spo sitedesign task remove - removes the specified site design scheduled for execution #783

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:

• yammer report groupsactivitycounts - gets the number of Yammer messages posted, read, and liked in groups #1390

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:

• aad approleassignment list - lists app role assignments for the specified application registration #1270
• aad o365group report activityfilecounts - get the total number of files and how many of them were active across all group sites associated with an Microsoft 365 Group #1285

Microsoft Graph:

• graph schemaextension set - updates a Microsoft Graph schema extension #15

Microsoft 365:

• tenant report activeusercounts - gets the count of daily active users in the reporting period by product #1298

SharePoint:

• spo orgassetslibrary remove - removes a library that was designated as a central location for organization assets across the tenant #1042
• spo tenant recyclebinitem list - returns all modern and classic site collections in the tenant scoped recycle bin #1144

Microsoft Teams:

• teams tab add - add a tab to the specified channel #850

Yammer:

• yammer message add - posts a Yammer network message on behalf of the current user #1101

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:

• graph schemaextension remove - removes specified Microsoft Graph schema extension #16

Power Apps:

• pa connector export - exports the specified power automate or power apps custom connector #1084

SharePoint:

• spo report activityfilecounts - gets the number of unique, licensed users who interacted with files stored on SharePoint sites #1243
• spo report activitypages - gets the number of unique pages visited by users #1245
• spo report activityuserdetail - gets details about SharePoint activity by user #1242
• spo report activityusercounts - gets the trend in the number of active users #1244
• spo report siteusagedetail - gets details about SharePoint site usage #1246

Yammer:

• yammer group list - returns the list of groups in a Yammer network or the groups for a specific user #1185

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:

• onedrive report activityuserdetail - gets details about OneDrive activity by user #1255
• onedrive report usageaccountdetail - gets details about OneDrive usage by account #1251

SharePoint:

• spo report siteusagefilecounts - get the total number of files across all sites and the number of active files #1247
• spo report siteusagepages - gets the number of pages viewed across all sites #1250
• spo report siteusagesitecounts - gets the total number of files across all sites and the number of active files #1248
• spo report siteusagestorage - gets the trend of storage allocated and consumed during the reporting period #1249

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:

• onedrive report activityfilecounts - gets the number of unique, licensed users that performed file interactions against any OneDrive account #1257
• onedrive report activityusercounts - gets the trend in the number of active OneDrive users #1256
• onedrive report usageaccountcounts - gets the trend in the number of active OneDrive for Business sites #1252
• onedrive report usagefilecounts - gets the total number of files across all sites and how many are active files #1253
• onedrive report usagestorage - gets the trend on the amount of storage you are using in OneDrive for Business #1254

Outlook:

• outlook report mailappusageversionsusercounts - gets the count of unique users by Outlook desktop version #1215
• outlook report mailboxusagemailboxcount - gets the total number of user mailboxes in your organization and how many are active each day of the reporting period #1217
• outlook report mailboxusagequotastatusmailboxcounts - gets the count of user mailboxes in each quota category #1218
• outlook report mailboxusagestorage - gets the amount of mailbox storage used in your organization #1219
• outlook report mailappusageusercounts - gets the count of unique users that connected to Exchange Online using any email app #1214
• outlook report mailactivityusercounts - enables you to understand trends on the number of unique users who are performing email activities like send, read, and receive #1211
• outlook report mailactivitycounts - enables you to understand the trends of email activity (like how many were sent, read, and received) in your organization #1210
• outlook report mailboxusagedetail - gets details about mailbox usage #1216
• outlook report mailappusageuserdetail - gets details about which activities users performed on the various email apps #1212
• outlook report mailactivityuserdetail - gets details about email activity users have performed #1209
• outlook report mailappusageappsusercounts - gets the count of unique users per email app #1213

SharePoint:

• spo feature disable - disables feature for the specified site or web #676
• spo site rename - renames the URL and title of a site collection #1197

Yammer:

• yammer message remove - removes a Yammer message #1106

Power Apps:

• pa connector list - lists Power Apps and Power Automate (Flow) connectors #1237

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:

• spfx project externalize - externalizes SharePoint Framework project dependencies #571

Yammer:

• yammer message get - returns a Yammer message #1105
• yammer message list - returns all accessible messages from the user's Yammer network #1104
• yammer user list - returns users from the current network #1113

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:

• aad o365group report activitydetail - get details about Microsoft 365 Groups activity by group #1130
• aad o365group report activitycounts - get the number of group activities across group workloads #1159
• aad o365group report activitygroupcounts - get the daily total number of groups and how many of them were active based on email conversations, Yammer posts, and SharePoint file activities #1160

Flow:

• flow remove - removes the specified Microsoft Flow #1063

PowerApps:

• pa solution reference add - adds a project reference to the solution in the current directory #954

SharePoint Online:

• spo apppage set - updates the single-part app page #875
• spo feature enable - enables feature for the specified site or web #675

Microsoft Teams:

• teams message reply list - retrieves replies to a message from a channel in a Microsoft Teams team #1109

Yammer:

• yammer network list - returns a list of networks to which the current user has access #1115
• yammer user get - retrieves the current user or searches for a user by ID or e-mail #1107

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:

• spo contenttypehub get - returns the URL of the SharePoint Content Type Hub of the Tenant #905

Microsoft Teams:

• teams channel remove - removes the specified channel in the Microsoft Teams team #814

PowerApps:

• pa pcf init - Creates new PowerApps component framework project #952
• pa solution init - initializes a directory with a new CDS solution project #953

Global:

• util accesstoken get - gets access token for the specified resource #1072

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:

• spo apppage add - creates a single-part app page #874
• spo homesite remove - removes the current Home Site #1002
• spo orgassetslibrary list - lists all libraries that are assigned as org asset library #1041
• spo get - gets the context URL for the root SharePoint site collection and SharePoint tenant admin site #1071
• spo set - sets the URL of the root SharePoint site collection for use in SPO commands #1070

Microsoft Teams:

• teams report deviceusagedistributionusercounts - gets the number of Microsoft Teams unique users by device type #1012
• teams report deviceusageusercounts - gets the number of Microsoft Teams daily unique users by device type #1011
• teams report useractivityusercounts - gets the number of Microsoft Teams users by activity type #1027
• teams report useractivitycounts - gets the number of Microsoft Teams activities by activity type #1028
• teams report useractivityuserdetail - gets details about Microsoft Teams user activity by user #1029

Microsoft Flow:

• flow disable - disables Microsoft Flow #1055
• flow enable - enables Microsoft Flow #1054

Microsoft 365 groups:

• aad o365group teamify - creates a new Microsoft Teams team under existing Microsoft 365 group #872

Microsoft Graph:

• graph schemaextension get - gets the properties of the specified schema extension definition #14

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:

• spo homesite get - gets information about the Home Site #1000
• spo homesite set - sets the specified site as the Home Site #1001
• spo listitem isrecord - checks if the specified list item is a record #771

Microsoft Graph:

• graph o365group user set - updates role of the specified user in the specified Microsoft 365 Group or Microsoft Teams team #982
• graph planner task list - lists Planner tasks for the currently logged in user #990
• graph report teamsdeviceusageuserdetail - gets information about Microsoft Teams device usage by user #960
• graph teams funsettings set - updates fun settings of a Microsoft Teams team #817

Microsoft 365:

• tenant id get - gets Microsoft 365 tenant ID for the specified domain #998

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:

• spo orgnewssite list - lists all organizational news sites #975
• spo orgnewssite remove - removes a site from the list of organizational news sites #976
• spo orgnewssite set - marks site as an organizational news site #974

Microsoft Graph:

• graph teams set - updates settings of a Microsoft Teams team #815

v1.20.0

New commands

SharePoint Online:

• spo contenttype remove - deletes site content type #904

Microsoft Graph:

• graph o365group user list - lists users for the specified Microsoft 365 group or Microsoft Teams team #802
• graph teams clone - creates a clone of a Microsoft Teams team #924

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:

• spo site commsite enable - enables communication site features on the specified site #937

Microsoft Graph:

• graph o365group renew - renews Microsoft 365 group's expiration #870
• graph o365group user remove - removes the specified user from specified Microsoft 365 Group or Microsoft Teams team #846

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:

• spo contenttype field remove - removes a column from a site- or list content type #673
• spo mail send - sends an e-mail from SharePoint #753

Microsoft Graph:

• graph teams archive - archives specified Microsoft Teams team #899
• graph teams channel get - gets information about the specific Microsoft Teams team channel #808
• graph teams messagingsettings set - updates messaging settings of a Microsoft Teams team #820
• graph teams remove - removes the specified Microsoft Teams team #813
• graph teams unarchive - restores an archived Microsoft Teams team #900

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:

• spo listitem record declare - declares the specified list item as a record #769

Microsoft Graph:

• graph o365group user add - adds user to specified Microsoft 365 Group or Microsoft Teams team #847
• graph schemaextension add - creates a Microsoft Graph schema extension #13
• graph teams add - adds a new Microsoft Teams team #615
• graph teams app uninstall - uninstalls an app from a Microsoft Team team #843
• graph teams channel set - updates properties of the specified channel in the given Microsoft Teams team #816
• graph teams guestsettings set - updates guest settings of a Microsoft Teams team #818
• graph teams tab list - lists tabs in the specified Microsoft Teams channel #849

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:

• spo field remove - removes the specified list- or site column #738
• spo listitem record undeclare - undeclares list item as a record #770
• spo web reindex - requests reindexing the specified subsite #822

Microsoft Graph:

• graph teams app install - installs an app from the catalog to a Microsoft Teams team #842
• graph teams funsettings list - lists fun settings for the specified Microsoft Teams team #809
• graph teams guestsettings list - lists guests settings for a Microsoft Teams team #810
• graph teams membersettings list - lists member settings for a Microsoft Teams team #811
• graph teams membersettings set - updates member settings of a Microsoft Teams team #819
• graph teams messagingsettings list - lists messaging settings for a Microsoft Teams team #812

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:

• spo list label get - gets label set on the specified list #773
• spo list label set - sets classification label on the specified list #772
• spo list view field add - adds the specified field to list view #735
• spo list view field remove - removes the specified field from list view #736
• spo site inplacerecordsmanagement set - activates or deactivates in-place records management for a site collection #774
• spo sitedesign run list - lists information about site designs applied to the specified site #779
• spo sitedesign run status get - gets information about the site scripts executed for the specified site design #780
• spo sitedesign task get - gets information about the specified site design scheduled for execution #782
• spo sitedesign task list - lists site designs scheduled for execution on the specified site #781

Microsoft Graph:

• graph teams app list - lists apps from the Microsoft Teams app catalog #826
• graph teams app publish - publishes Teams app to the organization's app catalog #824
• graph teams app remove - removes a Teams app from the organization's app catalog #825
• graph teams app update - updates Teams app in the organization's app catalog #827
• graph teams channel list - lists channels in the specified Microsoft Teams team #586
• graph teams user remove - removes the specified user from the specified Microsoft Teams team #757
• graph teams user set - updates role of the specified user in the given Microsoft Teams team #760

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:

• spo feature list - lists Features activated in the specified site or site collection #677
• spo file move - moves a file to another location #671
• spo list view list - lists views configured on the specified list #732
• spo list sitescript get - extracts a site script from a SharePoint list #713
• spo list view get - gets information about specific list view #730
• spo list view remove - deletes the specified view from the list #731

Microsoft Graph:

• graph teams message list - lists all messages from a channel in a Microsoft Teams team #588
• graph teams user add - adds user to the specified Microsoft Teams team #690
• graph teams user list - lists users for the specified Microsoft Teams team #689

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:

• spo folder move - moves a folder to another location #672
• spo page text add - adds text to a modern page #365

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:

• spo list webhook add - adds a new webhook to the specified list #652
• spo page header set - sets modern page header #697

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:

• spo field set - updates existing list or site column #661
• spo file add - uploads file to the specified folder #283
• spo list contenttype add - adds content type to list #594
• spo list contenttype list - lists content types configured on the list #595
• spo list contenttype remove - removes content type from list #668
• spo list view set - updates existing list view #662
• spo list webhook remove - removes the specified webhook from the list #650
• spo list webhook set - updates the specified webhook #651
• spo search - executes a search query #316
• spo serviceprincipal grant add - grants the service principal permission to the specified API #590

Microsoft Graph:

• graph siteclassification set - updates site classification configuration #304
• graph teams channel message get - retrieves a message from a channel in a Microsoft Teams team #589

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:

• spo list webhook get - gets information about the specific webhook #590
• spo tenant settings set - sets tenant global settings #549
• spo term add - adds taxonomy term #605
• spo term get - gets information about the specified taxonomy term #604
• spo term list - lists taxonomy terms from the given term set #603
• spo term group add - adds taxonomy term group #598
• spo term set add - adds taxonomy term set #602
• spo term set get - gets information about the specified taxonomy term set #601
• spo term set list - lists taxonomy term sets from the given term group #600

Microsoft Graph:

• graph siteclassification disable - disables site classification #302
• graph siteclassification enable - enables site classification #301
• graph teams channel add - adds a channel to the specified Microsoft Teams team #587

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:

• spo list webhook list - lists all webhooks for the specified list #579
• spo listitem list - gets a list of items from the specified list #268
• spo page column get - get information about a specific column of a modern page #412
• spo page remove - removes a modern page #363
• spo page section add - adds section to modern page #364
• spo site classic remove - removes the specified site #125
• spo tenant settings list - lists the global tenant settings #548
• spo term group get - gets information about the specified taxonomy term group #597
• spo term group list - lists taxonomy term groups #596

Microsoft Graph:

• graph groupsetting remove - removes the particular group setting #452
• graph groupsetting set - removes the particular group setting #451

Azure Management Service:

• azmgmt flow export - exports the specified Microsoft Flow as a file #383
• azmgmt flow run get - gets information about a specific run of the specified Microsoft Flow #400
• azmgmt flow run list - lists runs of the specified Microsoft Flow #399

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:

• spo contenttype field set - adds or updates a site column reference in a site content type #520
• spo page section get - gets information about the specified modern page section #410
• spo page section list - lists sections in the specific modern page #409

Microsoft Graph:

• graph teams list - lists Microsoft Teams in the current tenant #558

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:

• spo contenttype add - adds a new list or site content type #519
• spo contenttype get - retrieves information about the specified list or site content type #532
• spo field add - adds a new list or site column using the CAML field definition #518
• spo field get - retrieves information about the specified list or site column #528
• spo navigation node add - adds a navigation node to the specified site navigation #521
• spo navigation node list - lists nodes from the specified site navigation #522
• spo navigation node remove - removes the specified navigation node #523
• spo page clientsidewebpart add - adds a client-side web part to a modern page #366
• spo page column list - lists columns in the specific section of a modern page #411
• spo web set - updates subsite properties #191

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:

• spo file checkin - checks in specified file #284
• spo file checkout - checks out specified file #285
• spo folder rename - renames a folder #429
• spo listitem get - gets a list item from the specified list #269
• spo listitem set - updates a list item in the specified list #271

SharePoint Framework:

• spfx project upgrade - upgrades SharePoint Framework project to the specified version #471

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:

• spo file copy - copies a file to another location #286
• spo folder add - creates a folder within a parent folder #425
• spo folder copy - copies a folder to another location #424
• spo folder get - gets information about the specified folder #427
• spo folder list - returns all folders under the specified parent folder #428
• spo folder remove - deletes the specified folder #426
• spo hidedefaultthemes get - gets the current value of the HideDefaultThemes setting #341
• spo hidedefaultthemes set - sets the value of the HideDefaultThemes setting #342
• spo site o365group set - connects site collection to an Microsoft 365 Group #431
• spo theme apply - applies theme to the specified site #343

Microsoft Graph:

• graph groupsetting add - creates a group setting #443
• graph groupsetting get - gets information about the particular group setting #450
• graph groupsetting list - lists Azure AD group settings #449
• graph groupsettingtemplate get - gets information about the specified Azure AD group settings template #442
• graph groupsettingtemplate list - lists Azure AD group settings templates #441
• graph user sendmail - sends e-mail on behalf of the current user #328

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:

• spo file remove - removes the specified file #287
• spo hubsite data get - gets hub site data for the specified site #394
• spo hubsite theme sync - applies any theme updates from the parent hub site #401
• spo listitem add - creates a list item in the specified list #270
• spo listitem remove - removes the specified list item #272
• spo page control get - gets information about the specific control on a modern page #414
• spo page control list - lists controls on the specific modern page #413
• spo page get - gets information about the specific modern page #360
• spo propertybag set - sets the value of the specified property in the property bag #393
• spo web clientsidewebpart list - lists available client-side web parts #367

Microsoft Graph:

• graph user get - gets information about the specified user #326
• graph user list - lists users matching specified criteria #327

Changes

• added support for authenticating using credentials solving #388

v1.1.0

New commands

SharePoint Online:

• spo file get - gets information about the specified file #282
• spo page add - creates modern page #361
• spo page list - lists all modern pages in the given site #359
• spo page set - updates modern page properties #362
• spo propertybag remove - removes specified property from the property bag #291
• spo sitedesign apply - applies a site design to an existing site collection #339
• spo theme get - gets custom theme information #349
• spo theme list - retrieves the list of custom themes #332
• spo theme remove - removes existing theme #331
• spo theme set - add or update a theme #330, #340
• spo web get - retrieve information about the specified site #188

Microsoft Graph:

• graph o365group remove - removes an Microsoft 365 Group #309
• graph o365group restore - restores a deleted Microsoft 365 Group #346
• graph siteclassification get - gets site classification configuration #303

Azure Management Service:

• azmgmt login - log in to the Azure Management Service #378
• azmgmt logout - log out from the Azure Management Service #378
• azmgmt status - shows Azure Management Service login status #378
• azmgmt flow environment get - gets information about the specified Microsoft Flow environment #380
• azmgmt flow environment list - lists Microsoft Flow environments in the current tenant #379
• azmgmt flow get - gets information about the specified Microsoft Flow #382
• azmgmt flow list - lists Microsoft Flows in the given environment #381

Updated commands

Microsoft Graph:

• graph o365group list - added support for listing deleted Microsoft 365 Groups #347

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:

• spo file list - lists all available files in the specified folder and site #281
• spo list add - creates list in the specified site #204
• spo list remove - removes the specified list #206
• spo list set - updates the settings of the specified list #205
• spo customaction clear - deletes all custom actions in the collection #231
• spo propertybag get - gets the value of the specified property from the property bag #289
• spo propertybag list - gets property bag values #288
• spo site set - updates properties of the specified site #121
• spo site classic add - creates new classic site #123
• spo site classic set - change classic site settings #124
• spo sitedesign set - updates a site design with new values #251
• spo tenant appcatalogurl get - gets the URL of the tenant app catalog #315
• spo web add - create new subsite #189
• spo web list - lists subsites of the specified site #187
• spo web remove - delete specified subsite #192

Microsoft Graph:

• graph - log in to the Microsoft Graph #10
• graph - log out from the Microsoft Graph #10
• graph - shows Microsoft Graph login status #10
• graph o365group add - creates Microsoft 365 Group #308
• graph o365group get - gets information about the specified Microsoft 365 Group #306
• graph o365group list - lists Microsoft 365 Groups in the current tenant #305
• graph o365group set - updates Microsoft 365 Group properties #307

Changes

• fixed bug in logging dates #317
• fixed typo in the example of the spo cdn origin add command #338

v0.5.0

Breaking changes

• changed the spo site get command to return SPSite properties #293

New commands

SharePoint Online:

• spo sitescript add - adds site script for use with site designs #65
• spo sitescript list - lists site script available for use with site designs #66
• spo sitescript get - gets information about the specified site script #67
• spo sitescript remove - removes the specified site script #68
• spo sitescript set - updates existing site script #216
• spo sitedesign add - adds site design for creating modern sites #69
• spo sitedesign get - gets information about the specified site design #86
• spo sitedesign list - lists available site designs for creating modern sites #85
• spo sitedesign remove - removes the specified site design #87
• spo sitedesign rights grant - grants access to a site design for one or more principals #88
• spo sitedesign rights revoke - revokes access from a site design for one or more principals #89
• spo sitedesign rights list - gets a list of principals that have access to a site design #90
• spo list get - gets information about the specific list #199
• spo customaction remove - removes the specified custom action #21
• spo site classic list - lists sites of the given type #122
• spo list list - lists all available list in the specified site #198
• spo hubsite list - lists hub sites in the current tenant #91
• spo hubsite get - gets information about the specified hub site #92
• spo hubsite register - registers the specified site collection as a hub site #94
• spo hubsite unregister - unregisters the specified site collection as a hub site #95
• spo hubsite set - updates properties of the specified hub site #96
• spo hubsite connect - connects the specified site collection to the given hub site #97
• spo hubsite disconnect - disconnects the specifies site collection from its hub site #98
• spo hubsite rights grant - grants permissions to join the hub site for one or more principals #99
• spo hubsite rights revoke - revokes rights to join sites to the specified hub site for one or more principals #100
• spo customaction set - updates a user custom action for site or site collection #212

Changes

• fixed issue with prompts in non-interactive mode #142
• added information about the current user to status commands #202
• fixed issue with completing input that doesn't match commands #222
• fixed issue with escaping numeric input #226
• changed the aad oauth2grant list, spo app list, spo customaction list, spo site list commands to list all properties for output type JSON #232, #233, #234, #235
• fixed issue with generating clink completion file #252
• added user guide #236, #237, #238, #239

v0.4.0

Breaking changes

• renamed the spo cdn origin set command to spo cdn origin add #184

New commands

SharePoint Online:

• spo customaction list - lists user custom actions for site or site collection #19
• spo site get - gets information about the specific site collection #114
• spo site list - lists modern sites of the given type #115
• spo site add - creates new modern site #116
• spo app remove - removes the specified app from the tenant app catalog #9
• spo site appcatalog add - creates a site collection app catalog in the specified site #63
• spo site appcatalog remove - removes site collection scoped app catalog from site #64
• spo serviceprincipal permissionrequest list - lists pending permission requests #152
• spo serviceprincipal permissionrequest approve - approves the specified permission request #153
• spo serviceprincipal permissionrequest deny - denies the specified permission request #154
• spo serviceprincipal grant list - lists permissions granted to the service principal #155
• spo serviceprincipal grant revoke - revokes the specified set of permissions granted to the service principal #155
• spo serviceprincipal set - enable or disable the service principal #157
• spo customaction add - adds a user custom action for site or site collection #18
• spo externaluser list - lists external users in the tenant #27

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:

• spo customaction get - gets information about the specific user custom action #20

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:

• spo app add - add an app to the specified SharePoint Online app catalog #3
• spo app deploy - deploy the specified app in the tenant app catalog #7
• spo app get - get information about the specific app from the tenant app catalog #2
• spo app install - install an app from the tenant app catalog in the site #4
• spo app list - list apps from the tenant app catalog #1
• spo app retract - retract the specified app from the tenant app catalog #8
• spo app uninstall - uninstall an app from the site #5
• spo app upgrade - upgrade app in the specified site #6

v0.1.1

Changes

• Fixed bug in resolving command paths on Windows

v0.1.0

Initial release.

New commands

SharePoint Online:

• spo cdn get - get Microsoft 365 CDN status
• spo cdn origin list - list Microsoft 365 CDN origins
• spo cdn origin remove - remove Microsoft 365 CDN origin
• spo cdn origin add - add Microsoft 365 CDN origin
• spo cdn policy list - list Microsoft 365 CDN policies
• spo cdn policy set - set Microsoft 365 CDN policy
• spo cdn set - enable/disable Microsoft 365 CDN
• spo login - log in to a SharePoint Online site
• spo logout - log out from SharePoint
• spo status - show SharePoint Online login status
• spo storageentity get - get value of a tenant property
• spo storageentity list - list all tenant properties
• spo storageentity remove - remove a tenant property
• spo storageentity set - set a tenant property