Changes to SqlServerDsc

- The examples in the root of the Examples folder are obsolete. Those examples now have a note saying so, in the comment-based help, until they can be replaced (issue dsccommunity#904).
johlju · Nov 30, 2017 · 183a566 · 183a566
1 parent 99ad8a2
commit 183a566
Show file tree

Hide file tree

Showing 8 changed files with 91 additions and 10 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -10,9 +10,13 @@
   - Impact to all resources
 - Changes to CONTRIBUTING.md
   - Added details to the naming convention used in SqlServerDsc.
+- Changes to SqlServerDsc
+  - The examples in the root of the Examples folder are obsolete. Those examples
+    now have a note saying so, in the comment-based help, until they can be replaced
+    ([issue #904](https://github.com/PowerShell/SqlServerDsc/issues/904)).
 - Changes to SqlAGDatabase
   - Changed the Get-MatchingDatabaseNames function to be case insensitive when
-  matching database names. ([issue #912](https://github.com/PowerShell/SqlServerDsc/issues/912))
+    matching database names. ([issue #912](https://github.com/PowerShell/SqlServerDsc/issues/912))
 
 ## 9.0.0.0
 

diff --git a/Examples/DSCClusterSqlBuild.ps1 b/Examples/DSCClusterSqlBuild.ps1
@@ -1,4 +1,16 @@
-#requires -Version 5
+<#
+    .NOTES
+        THIS EXAMPLE IS OBSOLETE. Due to major changes to the resource modules
+        (this and other modules) over the last few months this example has not
+        been updated to reflect those changes.
+        Please refer to the examples in each individual resource example folder
+        for updated examples.
+        https://github.com/PowerShell/SqlServerDsc/tree/dev/Examples/Resources
+
+        There is an issue open to replace this example, please see issue
+        https://github.com/PowerShell/SqlServerDsc/issues/462
+#>
+
 $StartTime = [System.Diagnostics.Stopwatch]::StartNew()
 Function check-even($num){[bool]!($num%2)}
 

diff --git a/Examples/DSCFCISqlBuild.ps1 b/Examples/DSCFCISqlBuild.ps1
@@ -1,4 +1,16 @@
-#requires -Version 5
+<#
+    .NOTES
+        THIS EXAMPLE IS OBSOLETE. Due to major changes to the resource modules
+        (this and other modules) over the last few months this example has not
+        been updated to reflect those changes.
+        Please refer to the examples in each individual resource example folder
+        for updated examples.
+        https://github.com/PowerShell/SqlServerDsc/tree/dev/Examples/Resources
+
+        There is an issue open to replace this example, please see issue
+        https://github.com/PowerShell/SqlServerDsc/issues/462
+#>
+
 $computers = 'OHSQL9034N1','OHSQL9034N2','OHSQL9034N3'
 $OutputPath = 'F:\DSCConfig'
 

diff --git a/Examples/DSCSQLBuildEncrypted.ps1 b/Examples/DSCSQLBuildEncrypted.ps1
@@ -1,4 +1,15 @@
-#requires -Version 5
+<#
+    .NOTES
+        THIS EXAMPLE IS OBSOLETE. Due to major changes to the resource modules
+        (this and other modules) over the last few months this example has not
+        been updated to reflect those changes.
+        Please refer to the examples in each individual resource example folder
+        for updated examples.
+        https://github.com/PowerShell/SqlServerDsc/tree/dev/Examples/Resources
+
+        There is an issue open to replace this example, please see issue
+        https://github.com/PowerShell/SqlServerDsc/issues/462
+#>
 $StartTime = [System.Diagnostics.Stopwatch]::StartNew()
 
 $computers = 'OHSQL9012'

diff --git a/Examples/DSCSqlBuild.ps1 b/Examples/DSCSqlBuild.ps1
@@ -1,4 +1,15 @@
-#requires -Version 5
+<#
+    .NOTES
+        THIS EXAMPLE IS OBSOLETE. Due to major changes to the resource modules
+        (this and other modules) over the last few months this example has not
+        been updated to reflect those changes.
+        Please refer to the examples in each individual resource example folder
+        for updated examples.
+        https://github.com/PowerShell/SqlServerDsc/tree/dev/Examples/Resources
+
+        There is an issue open to replace this example, please see issue
+        https://github.com/PowerShell/SqlServerDsc/issues/462
+#>
 $StartTime = [System.Diagnostics.Stopwatch]::StartNew()
 
 $computers = 'OHSQL9015'

diff --git a/Examples/SQL-ClusterDB.ps1 b/Examples/SQL-ClusterDB.ps1
@@ -1,5 +1,15 @@
-#requires -Version 5
-
+<#
+    .NOTES
+        THIS EXAMPLE IS OBSOLETE. Due to major changes to the resource modules
+        (this and other modules) over the last few months this example has not
+        been updated to reflect those changes.
+        Please refer to the examples in each individual resource example folder
+        for updated examples.
+        https://github.com/PowerShell/SqlServerDsc/tree/dev/Examples/Resources
+
+        There is an issue open to replace this example, please see issue
+        https://github.com/PowerShell/SqlServerDsc/issues/462
+#>
 [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSAvoidUsingConvertToSecureStringWithPlainText", "")]
 param ()
 

diff --git a/Examples/SQL-Standalone.ps1 b/Examples/SQL-Standalone.ps1
@@ -1,5 +1,15 @@
-#requires -Version 5
-
+<#
+    .NOTES
+        THIS EXAMPLE IS OBSOLETE. Due to major changes to the resource modules
+        (this and other modules) over the last few months this example has not
+        been updated to reflect those changes.
+        Please refer to the examples in each individual resource example folder
+        for updated examples.
+        https://github.com/PowerShell/SqlServerDsc/tree/dev/Examples/Resources
+
+        There is an issue open to replace this example, please see issue
+        https://github.com/PowerShell/SqlServerDsc/issues/462
+#>
 [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSAvoidUsingConvertToSecureStringWithPlainText", "")]
 param ()
 

diff --git a/Examples/SQLPush_SingleServer.ps1 b/Examples/SQLPush_SingleServer.ps1
@@ -1,4 +1,15 @@
-#requires -Version 5
+<#
+    .NOTES
+        THIS EXAMPLE IS OBSOLETE. Due to major changes to the resource modules
+        (this and other modules) over the last few months this example has not
+        been updated to reflect those changes.
+        Please refer to the examples in each individual resource example folder
+        for updated examples.
+        https://github.com/PowerShell/SqlServerDsc/tree/dev/Examples/Resources
+
+        There is an issue open to replace this example, please see issue
+        https://github.com/PowerShell/SqlServerDsc/issues/462
+#>
 $computers = 'OHSQL1016'
 $OutputPath = 'D:\DSCLocal'
 $cim = New-CimSession -ComputerName $computers