SqlServerDsc

16.1.0-preview0013

Module with DSC resources for deployment and configuration of Microsoft SQL Server.

Minimum PowerShell version

5.0

This is a prerelease version of SqlServerDsc.
There is a newer prerelease version of this module available.
See the version list below for details.

Installation Options

Copy and Paste the following command to install this package using PowerShellGet More Info

Install-Module -Name SqlServerDsc -RequiredVersion 16.1.0-preview0013 -AllowPrerelease

Copy and Paste the following command to install this package using Microsoft.PowerShell.PSResourceGet More Info

Install-PSResource -Name SqlServerDsc -Version 16.1.0-preview0013 -Prerelease

You can deploy this package directly to Azure Automation. Note that deploying packages with dependencies will deploy all the dependencies to Azure Automation. Learn More

Manually download the .nupkg file to your system's default download location. Note that the file won't be unpacked, and won't include any dependencies. Learn More

Owners

Copyright

Copyright the DSC Community contributors. All rights reserved.

Package Details

Author(s)

  • DSC Community

Tags

DesiredStateConfiguration DSC DSCResourceKit DSCResource

Functions

Add-SqlDscNode Complete-SqlDscFailoverCluster Complete-SqlDscImage Connect-SqlDscDatabaseEngine ConvertFrom-SqlDscDatabasePermission ConvertFrom-SqlDscServerPermission ConvertTo-SqlDscDatabasePermission ConvertTo-SqlDscServerPermission Disable-SqlDscAudit Enable-SqlDscAudit Get-SqlDscAudit Get-SqlDscDatabasePermission Get-SqlDscServerPermission Initialize-SqlDscRebuildDatabase Install-SqlDscServer Invoke-SqlDscQuery New-SqlDscAudit Remove-SqlDscAudit Remove-SqlDscNode Repair-SqlDscServer Set-SqlDscAudit Set-SqlDscDatabasePermission Set-SqlDscServerPermission Test-SqlDscIsDatabasePrincipal Test-SqlDscIsLogin Uninstall-SqlDscServer

DSCResources

SqlAudit SqlDatabasePermission SqlPermission SqlAG SqlAGDatabase SqlAgentAlert SqlAgentFailsafe SqlAgentOperator SqlAGListener SqlAGReplica SqlAlias SqlAlwaysOnService SqlConfiguration SqlDatabase SqlDatabaseDefaultLocation SqlDatabaseMail SqlDatabaseObjectPermission SqlDatabaseRole SqlDatabaseUser SqlEndpoint SqlEndpointPermission SqlLogin SqlMaxDop SqlMemory SqlProtocol SqlProtocolTcpIp SqlReplication SqlRole SqlRS SqlRSSetup SqlScript SqlScriptQuery SqlSecureConnection SqlServiceAccount SqlSetup SqlTraceFlag SqlWaitForAG SqlWindowsFirewall

Dependencies

This module has no dependencies.

Release Notes

## [16.1.0-preview0013] - 2023-01-25

### Removed

- SqlServerDsc
 - Removed `Assert-ElevatedUser` from private functions ([issue #1797](https://github.com/dsccommunity/SqlServerDsc/issues/1797)).
   - `Assert-ElevatedUser` added to _DscResource.Common_ public functions
     ([issue #82](https://github.com/dsccommunity/DscResource.Common/issues/82)).
 - Removed `Test-IsNumericType` from private functions ([issue #1795](https://github.com/dsccommunity/SqlServerDsc/issues/1795)).
   - `Test-IsNumericType` added to _DscResource.Common_ public functions
   ([issue #87](https://github.com/dsccommunity/DscResource.Common/issues/87)).
 - Removed `Test-ServiceAccountRequirePassword` from private functions ([issue #1794](https://github.com/dsccommunity/SqlServerDsc/issues/1794)
   - Replaced by `Test-AccountRequirePassword` that was added to _DscResource.Common_
     public functions ([issue #93](https://github.com/dsccommunity/DscResource.Common/issues/93)).
 - Removed `Assert-RequiredCommandParameter` from private functions ([issue #1796](https://github.com/dsccommunity/SqlServerDsc/issues/1796)).
   - Replaced by `Assert-BoundParameter` (part of _DscResource.Common_)
     that had a new parameter set added ([issue #92](https://github.com/dsccommunity/DscResource.Common/issues/92)).
 - Removed private function `Test-ResourceDscPropertyIsAssigned` and
   `Test-ResourceHasDscProperty`. Both are replaced by `Test-DscProperty`
   which is now part of the module _DscResource.Common_.
 - Removed private function `Get-DscProperty`. It is replaced by `Get-DscProperty`
   which is now part of the module _DscResource.Common_.
 - The class `ResourceBase` and `Reason` has been removed, they are now
   part of the module _DscResource.Base_.
 - The enum `Ensure` has been removed, is is now part of the module
   _DscResource.Base_.
 - The private functions that the class `ResourceBase` depended on has been
   moved to the module _DscResource.Base_.
   - `ConvertFrom-CompareResult`
   - `ConvertTo-Reason`
   - `Get-ClassName`
   - `Get-LocalizedDataRecursive`
 - Added documentation how to generate stub modules for the unit tests.
   The documentation can be found in ['tests/Unit/Stubs`](https://github.com/dsccommunity/SqlServerDsc/tree/main/tests/Unit/Stubs).

### Added

- SqlServerDsc
 - The following private functions were added to the module (see comment-based
   help for more information):
   - `Assert-SetupActionProperties`
   - `Invoke-SetupAction`
 - The following public functions were added to the module (see comment-based
   help for more information):
   - `Install-SqlDscServer`
   - `Uninstall-SqlDscServer`
   - `Add-SqlDscNode`
   - `Remove-SqlDscNode`
   - `Repair-SqlDscServer`
   - `Complete-SqlDscImage`
   - `Complete-SqlDscFailoverCluster`
   - `Initialize-SqlDscRebuildDatabase`
 - New GitHub issue templates for proposing new public commands, proposing
   an enhancement to an existing command, or having a problem with an existing
   command.
 - Integration tests are now also run on SQL Server 2022 and SQL Server
   Reporting Services 2022.
 - Integration tests now wait for LCM after each It-block, not just at the
   end of a Context-block. Hopefully this will mitigate some of the intermittent
   errors we have seen when running the integration tests in the pipeline.
 - Use preview version of Pester to support the development of Pester as
   this is a code base with a diverse set of tests thar can help catch
   issues in Pester. If preview release of Pester prevents release we
   should temporary shift back to stable.
 - Add the GitHub App _Pull Request Quantifier_ as an experiment to see if it
   brings any value ([issue #1811](https://github.com/dsccommunity/SqlServerDsc/issues/1811)).
   - Updated thresholds, and label names and colors.
 - New QA tests for public commands and private functions.
- SqlDatabase
 - Added compatibility levels for SQL Server 2022 (major version 16).
- SqlSetup
 - Paths for SQL Server 2022 are correctly returned by Get.
- SqlRS
 - Added optional parameter `Encrypt`. Parameter `Encrypt` controls whether
   the connection used by `Invoke-SqlCmd should enforce encryption. This
   parameter can only be used together with the module _SqlServer_ v22.x
   (minimum v22.0.49-preview). The parameter will be ignored if an older
   major versions of the module _SqlServer_ is used.
- SqlScript
 - Added optional parameter `Encrypt`. Parameter `Encrypt` controls whether
   the connection used by `Invoke-SqlCmd should enforce encryption. This
   parameter can only be used together with the module _SqlServer_ v22.x
   (minimum v22.0.49-preview). The parameter will be ignored if an older
   major versions of the module _SqlServer_ is used.
- SqlScriptQuery
 - Added optional parameter `Encrypt`. Parameter `Encrypt` controls whether
   the connection used by `Invoke-SqlCmd should enforce encryption. This
   parameter can only be used together with the module _SqlServer_ v22.x
   (minimum v22.0.49-preview). The parameter will be ignored if an older
   major versions of the module _SqlServer_ is used.
- The public commands `Add-SqlDscNode`, `Complete-SqlDscFailoverCluster`,
 `Complete-SqlDscImage`, `Install-SqlDscServer`, and `Repair-SqlDscServer`
 now support the setup argument `ProductCoveredBySA` ([issue #1798](https://github.com/dsccommunity/SqlServerDsc/issues/1798)).

### Changed

- SqlServerDsc
 - Update Stale GitHub Action to v7.
 - Update to build module in separate folder under `output`.
 - Moved the build step of the pipeline to a Windows build worker when
   running in Azure DevOps.
 - Class-based resources now uses the parent class `ResourceBase` from the
   module _DscResource.Base_ ([issue #1790](https://github.com/dsccommunity/SqlServerDsc/issues/1790)).
 - Settings for the _Visual Studio Code_ extension _Pester Tests_ was changed
   to be able to run all unit tests, and all tests run by the extension
   are now run in a separate process to be able to handle changes in
   class-based resources.
 - The AppVeyor configuration file was updated to include the possibility
   to run integration tests for SQL Server 2022.
 - The stubs in `SqlServerStub.psm1` are now based on the commands from the
   module SqlServer v22.0.49-preview.
- `Install-SqlServerDsc`
 - No longer throws an exception when parameter `AgtSvcAccount` is not specified.
- SqlAgReplica
 - Converted unit test to Pester 5.
 - `Update-AvailabilityGroupReplica` to trigger once within `Set-TargetResource`
   for all AvailabilityReplica changes.
- Private function `Invoke-SetupAction` ([issue #1798](https://github.com/dsccommunity/SqlServerDsc/issues/1798)).
 - Was changed to support the SQL Server 2022 GA feature `AzureExtension`
   (that replaced the feature name `ARC`).
 - Support the setup argument `ProductCoveredBySA`.
 - No longer supports the argument `OnBoardSQLToARC` as it was removed in
   SQL Server 2022 GA.
- `Install-SqlDscServer`
 - Was changed to support the SQL Server 2022 GA feature `AzureExtension`
   (that replaced the feature name `ARC`) ([issue #1798](https://github.com/dsccommunity/SqlServerDsc/issues/1798)).
- `Uninstall-SqlDscServer`
 - Was changed to support the SQL Server 2022 GA feature `AzureExtension`
   (that replaced the feature name `ARC`) ([issue #1798](https://github.com/dsccommunity/SqlServerDsc/issues/1798)).
- SqlReplication
 - The resource now supports SQL Server 2022. The resource will require
   the module _SqlServer_ v22.0.49-preview or newer when used against an
   SQL Server 2022 instance ([issue #1801](https://github.com/dsccommunity/SqlServerDsc/issues/1801)).
- SqlProtocol
 - The resource now supports SQL Server 2022. The resource will require
   the module _SqlServer_ v22.0.49-preview or newer when used against an
   SQL Server 2022 instance ([issue #1802](https://github.com/dsccommunity/SqlServerDsc/issues/1802)).
- SqlProtocolTcpIp
 - The resource now supports SQL Server 2022. The resource will require
   the module _SqlServer_ v22.0.49-preview or newer when used against an
   SQL Server 2022 instance ([issue #1805](https://github.com/dsccommunity/SqlServerDsc/issues/1805)).
- SqlServiceAccount
 - The resource now supports SQL Server 2022. The resource will require
   the module _SqlServer_ v22.0.49-preview or newer when used against an
   SQL Server 2022 instance ([issue #1800](https://github.com/dsccommunity/SqlServerDsc/issues/1800)).
- SqlSetup
 - Integration tests now used _SqlServer_ module version 22.0.49-preview
   when running against _SQL Server 2022_, when testing _SQL Server 2016_,
   _SQL Server 2017_, and _SQL Server 2019_ the module version 21.1.18256
   is used.
 - Integration tests now supports installing preview versions of the module
   _SqlServer_.
- SqlServerDsc.Common
 - `Import-SQLPSModule`
   - Small changed to the localized string verbose message when the preferred
     module (_SqlServer_) is not found.
 - `Invoke-SqlScript`
   - Added the optional parameter `Encrypt` which controls whether the connection
     used by `Invoke-SqlCmd` should enforce encryption. This parameter can
     only be used together with the module _SqlServer_ v22.x (minimum
     v22.0.49-preview). The parameter will be ignored if an older major
     versions of the module _SqlServer_ is used.
 - `Connect-SQL`
   - Was updated to handle both `-ErrorAction 'Stop'` and `-ErrorAction 'SilentlyContinue'`
     when passed to the command ([issue #1837](https://github.com/dsccommunity/SqlServerDsc/issues/1837)).
   - Now returns a more clear error message when the status of a database
     instance is not `Online`.

### Fixed

- SqlServerDsc
 - Localized strings file `en-US/SqlServerDsc.strings.p

FileList

Version History

Version Downloads Last updated
16.6.0-previ... 44 3/3/2024
16.6.0-previ... 45 1/20/2024
16.6.0-previ... 5 1/19/2024
16.5.1-previ... 67 12/15/2023
16.5.1-previ... 90 11/19/2023
16.5.1-previ... 46 11/2/2023
16.5.0 126,352 10/5/2023
16.5.0-previ... 11 10/1/2023
16.5.0-previ... 6 9/29/2023
16.5.0-previ... 46 9/1/2023
16.5.0-previ... 6 8/26/2023
16.4.1-previ... 5 8/25/2023
16.4.0 111,211 8/22/2023
16.4.0-previ... 4 8/20/2023
16.4.0-previ... 4 8/20/2023
16.4.0-previ... 5 8/19/2023
16.4.0-previ... 75 5/18/2023
16.4.0-previ... 19 5/10/2023
16.4.0-previ... 5 5/9/2023
16.4.0-previ... 6 5/8/2023
16.3.1 459,101 5/6/2023
16.3.1-previ... 4 5/6/2023
16.3.1-previ... 8 5/4/2023
16.3.0 42,087 4/26/2023
16.3.0-previ... 6 4/26/2023
16.3.0-previ... 5 4/25/2023
16.3.0-previ... 5 4/24/2023
16.3.0-previ... 5 4/23/2023
16.3.0-previ... 20 4/18/2023
16.3.0-previ... 4 4/16/2023
16.2.1-previ... 6 4/12/2023
16.2.0 74,979 4/10/2023
16.2.0-previ... 4 4/10/2023
16.2.0-previ... 4 4/8/2023
16.2.0-previ... 4 4/8/2023
16.2.0-previ... 9 4/6/2023
16.2.0-previ... 9 4/1/2023
16.2.0-previ... 10 3/28/2023
16.2.0-previ... 9 3/26/2023
16.2.0-previ... 4 3/25/2023
16.2.0-previ... 167 3/19/2023
16.2.0-previ... 26 3/7/2023
16.2.0-previ... 9 3/4/2023
16.1.0 175,421 2/28/2023
16.1.0-previ... 5 2/28/2023
16.1.0-previ... 8 2/25/2023
16.1.0-previ... 5 2/24/2023
16.1.0-previ... 47 2/13/2023
16.1.0-previ... 27 2/12/2023
16.1.0-previ... 24 2/5/2023
16.1.0-previ... 10 2/1/2023
16.1.0-previ... (current version) 28 1/25/2023
16.1.0-previ... 7 1/24/2023
16.1.0-previ... 4 1/24/2023
16.1.0-previ... 11 1/22/2023
16.1.0-previ... 345 1/4/2023
16.1.0-previ... 5 1/3/2023
16.1.0-previ... 14 12/26/2022
16.1.0-previ... 49 12/19/2022
16.1.0-previ... 12 12/17/2022
16.1.0-previ... 114 12/11/2022
16.1.0-previ... 12 12/4/2022
16.1.0-previ... 35 11/26/2022
16.1.0-previ... 10 11/24/2022
16.0.1-previ... 30 11/11/2022
16.0.0 826,475 9/9/2022
16.0.0-previ... 29 8/21/2022
16.0.0-previ... 23 8/13/2022
16.0.0-previ... 14 8/13/2022
16.0.0-previ... 25 8/1/2022
16.0.0-previ... 80 6/14/2022
16.0.0-previ... 24 6/8/2022
16.0.0-previ... 17 6/6/2022
16.0.0-previ... 14 6/6/2022
16.0.0-previ... 88 4/26/2022
16.0.0-previ... 44 3/28/2022
16.0.0-previ... 65 2/12/2022
15.2.0 2,683,332 9/1/2021
15.2.0-previ... 15 9/1/2021
15.2.0-previ... 44 7/23/2021
15.2.0-previ... 75 6/6/2021
15.2.0-previ... 65 4/18/2021
15.2.0-previ... 85 3/12/2021
15.1.1 1,378,211 2/12/2021
15.1.1-previ... 17 2/12/2021
15.1.0 62,247 2/2/2021
15.1.0-previ... 24 2/1/2021
15.1.0-previ... 19 1/31/2021
15.0.2-previ... 18 1/30/2021
15.0.2-previ... 24 1/24/2021
15.0.2-previ... 62 1/21/2021
15.0.2-previ... 61 1/12/2021
15.0.1 143,024 1/9/2021
15.0.1-previ... 58 1/9/2021
15.0.1-previ... 63 1/6/2021
15.0.1-previ... 59 1/6/2021
15.0.1-previ... 68 12/27/2020
15.0.1-previ... 59 12/26/2020
15.0.1-previ... 62 12/23/2020
15.0.1-previ... 70 12/14/2020
15.0.1-previ... 61 12/13/2020
15.0.1-previ... 59 12/12/2020
15.0.1-previ... 60 12/10/2020
15.0.0 213,940 12/6/2020
15.0.0-previ... 60 12/6/2020
15.0.0-previ... 65 11/25/2020
15.0.0-previ... 57 11/22/2020
15.0.0-previ... 61 11/21/2020
14.3.0-previ... 98 10/5/2020
14.3.0-previ... 54 10/3/2020
14.3.0-previ... 60 10/2/2020
14.2.2-previ... 104 8/19/2020
14.2.2-previ... 60 8/16/2020
14.2.1 639,458 8/14/2020
14.2.1-previ... 59 8/13/2020
14.2.1-previ... 60 8/11/2020
14.2.1-previ... 56 8/11/2020
14.2.1-previ... 71 7/31/2020
14.2.1-previ... 59 7/28/2020
14.2.0 72,555 7/23/2020
14.2.0-previ... 62 7/23/2020
14.2.0-previ... 64 7/19/2020
14.2.0-previ... 73 7/13/2020
14.2.0-previ... 64 7/10/2020
14.2.0-previ... 61 7/9/2020
14.1.1-previ... 63 7/9/2020
14.1.0 210,870 7/6/2020
14.1.0-previ... 361 7/5/2020
14.1.0-previ... 60 7/4/2020
14.1.0-previ... 61 7/4/2020
14.1.0-previ... 63 7/3/2020
14.1.0-previ... 65 7/1/2020
14.0.1-previ... 71 6/28/2020
14.0.1-previ... 60 6/26/2020
14.0.0 10,834 6/12/2020
14.0.0-previ... 61 6/12/2020
14.0.0-previ... 67 6/11/2020
14.0.0-previ... 69 6/10/2020
14.0.0-previ... 68 6/10/2020
14.0.0-previ... 102 5/28/2020
14.0.0-previ... 77 5/25/2020
14.0.0-previ... 67 5/25/2020
14.0.0-previ... 79 5/19/2020
14.0.0-previ... 75 5/19/2020
14.0.0-previ... 81 5/17/2020
14.0.0-previ... 70 5/17/2020
14.0.0-previ... 68 5/16/2020
14.0.0-previ... 69 5/14/2020
14.0.0-previ... 71 5/13/2020
14.0.0-previ... 79 5/12/2020
14.0.0-previ... 69 5/12/2020
14.0.0-previ... 69 5/12/2020
14.0.0-previ... 82 5/8/2020
14.0.0-previ... 68 5/6/2020
14.0.0-previ... 72 5/5/2020
14.0.0-previ... 70 5/4/2020
14.0.0-previ... 69 5/3/2020
14.0.0-previ... 68 5/3/2020
14.0.0-previ... 83 4/27/2020
14.0.0-previ... 78 4/26/2020
13.5.0 28,248 4/12/2020
13.5.0-previ... 75 4/11/2020
13.5.0-previ... 77 4/11/2020
13.4.1-previ... 104 3/31/2020
13.4.0 122,338 3/18/2020
13.4.0-previ... 70 3/18/2020
13.3.1-previ... 116 1/18/2020
13.3.0 480,179 1/17/2020
13.3.0-previ... 73 1/17/2020
13.3.0-previ... 78 1/12/2020
13.3.0-previ... 72 1/8/2020
13.3.0-previ... 75 1/7/2020
13.3.0-previ... 72 1/3/2020
13.3.0-previ... 73 1/2/2020
13.3.0-previ... 74 1/2/2020
13.2.0.0 860,064 9/19/2019
13.1.0.0 34,986 8/8/2019
13.0.0.0 26,018 6/26/2019
12.5.0.0 17,323 5/15/2019
12.4.0.0 21,691 4/3/2019
12.3.0.0 40,221 2/20/2019
12.2.0.0 8,924 1/10/2019
12.1.0.0 23,209 10/25/2018
12.0.0.0 21,421 9/5/2018
11.4.0.0 16,150 7/25/2018
11.3.0.0 7,374 6/13/2018
11.2.0.0 4,935 5/2/2018
11.1.0.0 6,197 3/22/2018
11.0.0.0 12,777 2/8/2018
10.0.0.0 3,648 12/14/2017
Show less