New SharePoint CSOM version released for SharePoint Online - March 2019

We are happy to announce the availability of new SharePoint Client-Side Object Model (CSOM) version targeted for the Office 365 or more specifically for SharePoint and Project Online. This release contains a few new important APIs and cmdlets for new capabilities. Please note that the provided APIs and cmdlets will not work until the feature is enabled.

You can find the latest CSOM package for SharePoint Online, including the Project Online CSOM assembly, from the NuGet gallery with an id of ‘Microsoft.SharePointOnline.CSOM‘. We do recommend you to use the NuGet Package to gain access to the latest version, rather than downloading the SDK to your machine as we do not update the separate MSI installer for SharePoint Online CSOM anymore.

The version of the newly released CSOM package is 16.1.8715.1200. Previous versions of the NuGet have not been removed so that your existing solutions will continue working without issues and you can decide when the new version is taken into use. Notice that even though the NuGet version is increased to 16.1.8715.1200, actual assembly version of the released assemblies is 16.1.0.0. You can also check the version of the assemblies from the File Version attribute, which aligns with the NuGet version.

SharePoint Online Management Shell has been also updated to match with this CSOM release from the API perspective with few new cmdlets.

Notice that since this NuGet package is targeted to SharePoint Online, you cannot use it directly in on-premises environments (SharePoint 2013, 2016 or 2019). This is because of the server side dependencies of the APIs. CSOM versioning model and dependency on your target environment are clarified in following blog post – Using correct Client-Side Object Model (CSOM) version for SharePoint customizations. We have released separate NuGet packages for on-premises. See following blog post for additional details – Updated versions of the SharePoint on-premises CSOM NuGet packages.

New properties and methods across assemblies

Here’s a raw list of all the changes in the classes, properties and methods within this package.

Microsoft.SharePoint.Client

Following properties, classes and methods have been added.

public class Microsoft.SharePoint.Administration.SPSiteCreationAuditContext
public enum Microsoft.SharePoint.Administration.SPSiteCreationSource
public method Microsoft.SharePoint.Client.File.OpenBinaryStreamWithOptions
public class Microsoft.SharePoint.Client.PortalAndOrgNewsSiteReference
public enum Microsoft.SharePoint.Client.SearchScopeType – Enum values are: DefaultScope, Tenant, Hub, Site
public class Microsoft.SharePoint.Client.SPHSite
public class Microsoft.SharePoint.Client.SPHSiteReference
public enum Microsoft.SharePoint.Client.SPOpenBinaryOptions
public property Microsoft.SharePoint.Client.Web.DisableRecommendedItems
public property Microsoft.SharePoint.Client.Web.SearchScope – To set the default scope in site level

Microsoft.Online.SharePoint.Client.Tenant

Following properties, classes and methods have been added.

public property Microsoft.Online.SharePoint.TenantAdministration.SiteProperties.GroupId
public property Microsoft.Online.SharePoint.TenantAdministration.SiteProperties.RelatedGroupId
public method Microsoft.Online.SharePoint.TenantAdministration.Tenant.EnableCommSite
public property Microsoft.Online.SharePoint.TenantAdministration.Tenant.EnablePromotedFileHandlers
public method Microsoft.Online.SharePoint.TenantAdministration.Tenant.GetSPHSiteUrl
public method Microsoft.Online.SharePoint.TenantAdministration.Tenant.RemoveSPHSite
public method Microsoft.Online.SharePoint.TenantAdministration.Tenant.SetOrgAssets
public method Microsoft.Online.SharePoint.TenantAdministration.Tenant.SetSPHSite
public property Microsoft.Online.SharePoint.TenantManagement.Office365Tenant.EnablePromotedFileHandlers
public method Microsoft.Online.SharePoint.TenantManagement.Office365Tenant.SetOrgAssetsLib

New cmdlets in SharePoint Online Management Shell

Here’s a list of new cmdlets included in the SharePoint Online Management Shell release. These cmdlets are not yet active in targeted released or normal tenants, but they will be enabled soon when the actual feature will be released. Documentation for these will be provided when capabilities will be enabled.

Enable-SPOCommSite – Can be used to transform existing classic team site from the root site collection of a tenant as a communication site
- This cmdlet can be used to enable the modern communication site experience in the classic team site collection at the root of a tenant. This feature is not yet enabled and will be gradually rolled out in the coming weeks. Please look for updates in your Office 365 Message Center or in the Microsoft 365 roadmap.
Get-SPOHomeSite
Remove-SPOHomeSite
Set-SPOHomeSite
Set-SPOOrgAssetsLibrary