A Microsoft platform for building enterprise-level data integration and data transformations solutions.
Referencing those assemblies directly from the SQL Server 2025 installation path (for example, …\Microsoft SQL Server\170\DTS\Binn and …\170\SDK\Assemblies) for compile-time is not the recommended or supported approach going forward.
For SQL Server 2025 (v17), the supported guidance is:
- Prefer the Microsoft.SqlServer.SqlManagementObjects NuGet package
- This package provides the SMO assemblies (including
Microsoft.SqlServer.Smo.dll,Microsoft.SqlServer.SqlEnum.dll, and related dependencies). - It is versioned and maintained specifically for SQL Server compatibility and is strong-named and Authenticode signed.
- This avoids tight coupling to a particular local SQL Server installation path and reduces versioning/build issues.
- This package provides the SMO assemblies (including
- Avoid mixing GAC/installation-path assemblies with NuGet SMO
- Mixing assemblies from
C:\Windows\Microsoft.NET\assembly\GAC_MSILor…\Microsoft SQL Server\170\DTS\Binnwith NuGet-based SMO references leads to version conflicts and build errors (as seen with CS1705 and missing/incorrect versions ofSmoandSqlEnum). - If NuGet-based SMO is used, keep all SMO-related references from that package only.
- Mixing assemblies from
- If GAC/installation-path deployment is mandatory
- Wait for the official SQL Server 2025 Feature Pack or
SharedManagementObjects.msi, which will install the appropriate v17.100+ assemblies into the correct locations. - Those redistributables are the supported way to obtain and redistribute SMO binaries outside of NuGet.
- Wait for the official SQL Server 2025 Feature Pack or
- Use the SDK assemblies for SSIS/maintenance-plan integration
- For SSIS and maintenance-plan–related code, reference SDK assemblies from
C:\Program Files\Microsoft SQL Server\170\SDK\Assemblies\(not SSMS UI orDTS\Binndesign-time binaries) when SDK-based development is required. - Ensure the “Client Tools SDK” feature is installed via SQL Server 2025 setup if that folder is missing.
- For SSIS and maintenance-plan–related code, reference SDK assemblies from
Summary:
- Using
…\170\DTS\Binnassemblies directly as compile-time references is not the supported long-term pattern. - Use Microsoft.SqlServer.SqlManagementObjects (NuGet) for SMO, and the official SQL Server SDK/redistributables for SSIS/maintenance-plan code.
- Avoid mixing installation-path DLLs and NuGet/GAC SMO assemblies to prevent version and build issues.
References:
- Integration Services Programming Overview
- MSSQLSERVER_6522
- Lifecycle FAQ - Microsoft C++ Build Tools, Redistributable, and runtime libraries
- Build errors while adding SQL Server 2025 (Version - 17.x) - Microsoft Q&A
- Build errors when adding SQL Server 2025 (v17) support - Microsoft Q&A
- SQL Server 2025 Public Preview Maintenance Wizard plan runtime error - Microsoft Q&A
- how to fix maintinence plans wizard for SQL Server 2022 this is unavailable - Microsoft Q&A
- SQL Server Express 2025 Fails to install - Microsoft Q&A
- KB5063760 - Description of the security update for SQL Server 2017 GDR: August 12, 2025
- KB5065224 - Description of the security update for SQL Server 2017 GDR: September 9, 2025
- KB5065221 - Description of the security update for SQL Server 2022 GDR: September 9, 2025
- Supported .NET Framework libraries