{"id":2738,"date":"2019-03-29T09:13:35","date_gmt":"2019-03-29T17:13:35","guid":{"rendered":"https:\/\/developer.microsoft.com\/en-us\/office\/blogs\/?p=2738"},"modified":"2019-03-29T09:13:35","modified_gmt":"2019-03-29T17:13:35","slug":"new-sharepoint-csom-version-released-for-sharepoint-online-march-2019","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/new-sharepoint-csom-version-released-for-sharepoint-online-march-2019\/","title":{"rendered":"New SharePoint CSOM version released for SharePoint Online &#8211; March 2019"},"content":{"rendered":"<p>We are happy to announce the availability of new\u00a0SharePoint 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.<\/p>\n<p>You can find the latest CSOM package for SharePoint Online, including the Project Online CSOM assembly, from the\u00a0<a href=\"https:\/\/www.nuget.org\/packages\/Microsoft.SharePointOnline.CSOM\">NuGet gallery<\/a>\u00a0with an id of &#8216;<strong><em>Microsoft.SharePointOnline.CSOM<\/em><\/strong>&#8216;. We do recommend you to use the NuGet Package to gain access to the latest version, rather than downloading\u00a0the SDK to your machine as we do not update the separate MSI installer for SharePoint Online CSOM anymore.<\/p>\n<p>The version of the newly released CSOM package is\u00a0<strong>16.1.8715.1200<\/strong>. Previous\u00a0versions of the NuGet have\u00a0<strong>not<\/strong>\u00a0been removed so that your existing solutions will continue working without issues and you can decide when the new version is taken into use.\u00a0Notice 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\u00a0<em>File Version attribute<\/em>, which aligns with the NuGet version.<\/p>\n<p><img decoding=\"async\" class=\"alignnone wp-image-2740 size-full\" src=\"https:\/\/officedevblogs.wpengine.com\/wp-content\/uploads\/2019\/03\/csom-16-1-8715-1200.png\" alt=\"\" width=\"799\" height=\"481\" srcset=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2019\/03\/csom-16-1-8715-1200.png 799w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2019\/03\/csom-16-1-8715-1200-300x181.png 300w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2019\/03\/csom-16-1-8715-1200-768x462.png 768w\" sizes=\"(max-width: 799px) 100vw, 799px\" \/><\/p>\n<p><a href=\"https:\/\/www.powershellgallery.com\/packages\/Microsoft.Online.SharePoint.PowerShell\">SharePoint Online Management Shell<\/a>\u00a0has been also updated to match with this CSOM release from the API perspective with few new cmdlets.<\/p>\n<p><strong><em>Notice<\/em><\/strong>\u00a0that since this NuGet\u00a0package is targeted to <strong>SharePoint Online<\/strong>, 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\u00a0dependency\u00a0on\u00a0your target environment are clarified in following blog post &#8211;\u00a0<a href=\"http:\/\/dev.office.com\/blogs\/using-correct-csom-version-for-sharepoint-customizations\">Using correct Client-Side Object Model (CSOM) version for SharePoint customizations<\/a>.\u00a0We have released separate NuGet packages for on-premises. See following blog post for additional details &#8211;\u00a0<a href=\"https:\/\/developer.microsoft.com\/en-us\/sharepoint\/blogs\/updated-versions-of-the-sharepoint-on-premises-csom-nuget-packages\/\">Updated versions of the SharePoint on-premises CSOM NuGet packages<\/a>.<\/p>\n<h2>New properties and methods\u00a0across assemblies<\/h2>\n<p>Here&#8217;s a raw list of all the changes in the classes,\u00a0properties and methods within this package.<\/p>\n<h2>Microsoft.SharePoint.Client<\/h2>\n<p>Following properties, classes and methods have been\u00a0<strong>added.<\/strong><\/p>\n<ul>\n<li>public <strong>class<\/strong> Microsoft.SharePoint.Administration.SPSiteCreationAuditContext<\/li>\n<li>public <strong>enum<\/strong> Microsoft.SharePoint.Administration.SPSiteCreationSource<\/li>\n<li>public <strong>method<\/strong> Microsoft.SharePoint.Client.File.OpenBinaryStreamWithOptions<\/li>\n<li>public <strong>class<\/strong> Microsoft.SharePoint.Client.PortalAndOrgNewsSiteReference<\/li>\n<li>public <strong>enum<\/strong> Microsoft.SharePoint.Client.SearchScopeType &#8211; Enum values are:\u00a0<em>DefaultScope<\/em>, <em>Tenant<\/em>, <em>Hub<\/em>, <em>Site<\/em><\/li>\n<li>public <strong>class<\/strong> Microsoft.SharePoint.Client.SPHSite<\/li>\n<li>public <strong>class<\/strong> Microsoft.SharePoint.Client.SPHSiteReference<\/li>\n<li>public <strong>enum<\/strong> Microsoft.SharePoint.Client.SPOpenBinaryOptions<\/li>\n<li>public <strong>property<\/strong> Microsoft.SharePoint.Client.Web.DisableRecommendedItems<\/li>\n<li>public <strong>property<\/strong> Microsoft.SharePoint.Client.Web.SearchScope &#8211; To set the default scope in site level<\/li>\n<\/ul>\n<h2>Microsoft.Online.SharePoint.Client.Tenant<\/h2>\n<p>Following properties, classes and methods have been\u00a0<strong>added.<\/strong><\/p>\n<ul>\n<li>public <strong>property<\/strong> Microsoft.Online.SharePoint.TenantAdministration.SiteProperties.GroupId<\/li>\n<li>public <strong>property<\/strong> Microsoft.Online.SharePoint.TenantAdministration.SiteProperties.RelatedGroupId<\/li>\n<li>public <strong>method<\/strong> Microsoft.Online.SharePoint.TenantAdministration.Tenant.EnableCommSite<\/li>\n<li>public <strong>property<\/strong> Microsoft.Online.SharePoint.TenantAdministration.Tenant.EnablePromotedFileHandlers<\/li>\n<li>public <strong>method<\/strong> Microsoft.Online.SharePoint.TenantAdministration.Tenant.GetSPHSiteUrl<\/li>\n<li>public <strong>method<\/strong> Microsoft.Online.SharePoint.TenantAdministration.Tenant.RemoveSPHSite<\/li>\n<li>public <strong>method<\/strong> Microsoft.Online.SharePoint.TenantAdministration.Tenant.SetOrgAssets<\/li>\n<li>public <strong>method<\/strong> Microsoft.Online.SharePoint.TenantAdministration.Tenant.SetSPHSite<\/li>\n<li>public <strong>property<\/strong> Microsoft.Online.SharePoint.TenantManagement.Office365Tenant.EnablePromotedFileHandlers<\/li>\n<li>public <strong>method<\/strong> Microsoft.Online.SharePoint.TenantManagement.Office365Tenant.SetOrgAssetsLib<\/li>\n<\/ul>\n<h2>New cmdlets in SharePoint Online Management Shell<\/h2>\n<p>Here&#8217;s a list of new cmdlets included in the <a href=\"https:\/\/www.powershellgallery.com\/packages\/Microsoft.Online.SharePoint.PowerShell\">SharePoint Online Management Shell release<\/a>. 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.<\/p>\n<ul>\n<li><em>Enable-SPOCommSite<\/em> &#8211; Can be used to transform existing classic team site from the root site collection of a tenant as a communication site\n<ul>\n<li>\n<div>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 <a href=\"https:\/\/www.microsoft.com\/en-us\/microsoft-365\/roadmap?featureid=46338\">Microsoft 365 roadmap<\/a>.<\/div>\n<\/li>\n<\/ul>\n<\/li>\n<li><em>Get-SPOHomeSite<\/em><\/li>\n<li><em>Remove-SPOHomeSite<\/em><\/li>\n<li><em>Set-SPOHomeSite<\/em><\/li>\n<li><em>Set-SPOOrgAssetsLibrary<\/em><\/li>\n<\/ul>\n<p><span style=\"font-size: large\"><em>\u201cSharing is caring\u201d<\/em><\/span><\/p>\n<p>&nbsp;<\/p>\n<hr \/>\n<p><i>SharePoint Team, Microsoft &#8211; 29th of March 2019<\/i><\/p>\n","protected":false},"excerpt":{"rendered":"<p>We are happy to announce the availability of new\u00a0SharePoint Client-Side Object Model (CSOM) version targeted for the Office 365 or more specifically for SharePoint and Project Online. March 2019 release.<\/p>\n","protected":false},"author":69078,"featured_media":2741,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[],"class_list":["post-2738","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-microsoft-365-developer"],"acf":[],"blog_post_summary":"<p>We are happy to announce the availability of new\u00a0SharePoint Client-Side Object Model (CSOM) version targeted for the Office 365 or more specifically for SharePoint and Project Online. March 2019 release.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/2738","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\/69078"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=2738"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/2738\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/2741"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=2738"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=2738"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=2738"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}