xActiveDirectory: OptIn to the "Common Tests - Validate Example Files…

… To Be Published" (#364)

- Changes to xActiveDirectory
  - Opt-in to the following DSC Resource Common Meta Tests:
    - Common Tests - Validate Example Files To Be Published (issue #311)

.MetaTestOptIn.json

@@ -8,5 +8,6 @@
         "Common Tests - Required Script Analyzer Rules",
         "Common Tests - Flagged Script Analyzer Rules",
         "Common Tests - Validate Localization",
-        "Common Tests - Validate Example Files"
+        "Common Tests - Validate Example Files",
+        "Common Tests - Validate Example Files To Be Published"
 ]

CHANGELOG.md

@@ -20,6 +20,7 @@
     - Common Tests - Validate Markdown Links ([Issue #280](https://github.com/PowerShell/xActiveDirectory/issues/280))
     - Common Tests - Validate Localization ([Issue #281](https://github.com/PowerShell/xActiveDirectory/issues/281))
     - Common Tests - Validate Example Files ([Issue #279](https://github.com/PowerShell/xActiveDirectory/issues/279))
+    - Common Tests - Validate Example Files To Be Published ([Issue #311](https://github.com/PowerShell/xActiveDirectory/issues/311))
   - Move resource descriptions to Wiki using auto-documentation ([Issue #289](https://github.com/PowerShell/xActiveDirectory/issues/289))
   - Move helper functions from MSFT_xADCommon to the module
     xActiveDirectory.Common ([issue #288](https://github.com/PowerShell/xActiveDirectory/issues/288))

Examples/Resources/xADComputer/1-AddComputerAccount_Config.ps1

@@ -22,6 +22,7 @@
         This configuration will create two Active Directory computer accounts
         enabled. The property Enabled will not be enforced in either case.
 #>
+
 Configuration AddComputerAccount_Config
 {
     param

Examples/Resources/xADComputer/2-AddComputerAccountDisabled_Config.ps1

@@ -22,6 +22,7 @@
         This configuration will create an Active Directory computer account
         disabled. The property Enabled will not be enforced.
 #>
+
 Configuration AddComputerAccountDisabled_Config
 {
     param

Examples/Resources/xADComputer/3-AddComputerAccountSpecificPath_Config.ps1

@@ -23,6 +23,7 @@
         on the specified domain controller and in the specific organizational
         unit.
 #>
+
 Configuration AddComputerAccountSpecificPath_Config
 {
     param

Examples/Resources/xADComputer/4-AddComputerAccountAndCreateODJRequest_Config.ps1

@@ -24,6 +24,7 @@
         unit. After the account is create an Offline Domain Join Request file
         is created to the specified path.
 #>
+
 Configuration AddComputerAccountAndCreateODJRequest_Config
 {
     param

Examples/Resources/xADDomain/1-NewForest.ps1 → Examples/Resources/xADDomain/1-NewForest_Config.ps1

@@ -1,18 +1,29 @@
+<#PSScriptInfo
+.VERSION 1.0
+.GUID 86c0280c-6b48-4689-815d-5bc0692845a4
+.AUTHOR Microsoft Corporation
+.COMPANYNAME Microsoft Corporation
+.COPYRIGHT (c) Microsoft Corporation. All rights reserved.
+.TAGS DSCConfiguration
+.LICENSEURI https://github.com/PowerShell/xActiveDirectory/blob/master/LICENSE
+.PROJECTURI https://github.com/PowerShell/xActiveDirectory
+.ICONURI
+.EXTERNALMODULEDEPENDENCIES
+.REQUIREDSCRIPTS
+.EXTERNALSCRIPTDEPENDENCIES
+.RELEASENOTES
+.PRIVATEDATA
+#>
+
+#Requires -module xActiveDirectory
+
 <#
-    .EXAMPLE
-        This example will create a new domain with a new forest and a forest functional level of Server 2016
+    .DESCRIPTION
+        This configuration will create a new domain with a new forest and a forest
+        functional level of Server 2016.
 #>
-$ConfigurationData = @{
-    AllNodes = @(
-        @{
-            NodeName   = 'localhost'
-            FFL        = 'WinThreshold'
-            DomainName = 'contoso.com'
-        }
-    )
-}
 
-configuration NewForest
+Configuration NewForest_Config
 {
     param
     (
@@ -47,3 +58,13 @@ configuration NewForest
         }
     }
 }
+
+$ConfigurationData = @{
+    AllNodes = @(
+        @{
+            NodeName   = 'localhost'
+            FFL        = 'WinThreshold'
+            DomainName = 'contoso.com'
+        }
+    )
+}

Examples/Resources/xADDomain/2-NewChildDomain.ps1 → Examples/Resources/xADDomain/2-NewChildDomain_Config.ps1

@@ -1,19 +1,29 @@
+<#PSScriptInfo
+.VERSION 1.0
+.GUID 40a01066-4c01-4115-b7a8-c21b51ac4ed3
+.AUTHOR Microsoft Corporation
+.COMPANYNAME Microsoft Corporation
+.COPYRIGHT (c) Microsoft Corporation. All rights reserved.
+.TAGS DSCConfiguration
+.LICENSEURI https://github.com/PowerShell/xActiveDirectory/blob/master/LICENSE
+.PROJECTURI https://github.com/PowerShell/xActiveDirectory
+.ICONURI
+.EXTERNALMODULEDEPENDENCIES
+.REQUIREDSCRIPTS
+.EXTERNALSCRIPTDEPENDENCIES
+.RELEASENOTES
+.PRIVATEDATA
+#>
+
+#Requires -module xActiveDirectory
+
 <#
-    .EXAMPLE
-        This example will create a new child domain in an existing forest with a Domain Functional Level of Windows Server 2012R2
+    .DESCRIPTION
+        This configuration will create a new child domain in an existing forest with
+        a Domain Functional Level of Windows Server 2012R2.
 #>
-$ConfigurationData = @{
-    AllNodes = @(
-        @{
-            NodeName     = 'localhost'
-            DFL          = 'Win2012R2'
-            DomainName   = 'child'
-            ParentDomain = 'contoso.com'
-        }
-    )
-}
 
-configuration NewChildDomain
+Configuration NewChildDomain_Config
 {
     param
     (
@@ -49,3 +59,14 @@ configuration NewChildDomain
         }
     }
 }
+
+$ConfigurationData = @{
+    AllNodes = @(
+        @{
+            NodeName     = 'localhost'
+            DFL          = 'Win2012R2'
+            DomainName   = 'child'
+            ParentDomain = 'contoso.com'
+        }
+    )
+}

Examples/Resources/xADDomain/3-NewForestwithParentAndChildDomain.ps1 → Examples/Resources/xADDomain/3-NewForestwithParentAndChildDomain_Config.ps1

@@ -1,8 +1,29 @@
+<#PSScriptInfo
+.VERSION 1.0
+.GUID aad067ec-0e7a-4a41-874d-432a3ff73437
+.AUTHOR Microsoft Corporation
+.COMPANYNAME Microsoft Corporation
+.COPYRIGHT (c) Microsoft Corporation. All rights reserved.
+.TAGS DSCConfiguration
+.LICENSEURI https://github.com/PowerShell/xActiveDirectory/blob/master/LICENSE
+.PROJECTURI https://github.com/PowerShell/xActiveDirectory
+.ICONURI
+.EXTERNALMODULEDEPENDENCIES
+.REQUIREDSCRIPTS
+.EXTERNALSCRIPTDEPENDENCIES
+.RELEASENOTES
+.PRIVATEDATA
+#>
+
+#Requires -module xActiveDirectory
+
 <#
-    .EXAMPLE
-        In this example, we create a domain, and then create a child domain on another node.
+    .DESCRIPTION
+        This configuration will create a domain, and then create a child domain on
+        another node.
 #>
-Configuration NewForestwithParentAndChildDomain
+
+Configuration NewForestwithParentAndChildDomain_Config
 {
     param
     (

Examples/Resources/xADDomain/4-NewDomainWithTwoDCs.ps1 → Examples/Resources/xADDomain/4-NewDomainWithTwoDCs_Config.ps1

@@ -1,9 +1,31 @@
+<#PSScriptInfo
+.VERSION 1.0
+.GUID 400370df-41bc-44d4-8730-0aa9a135383f
+.AUTHOR Microsoft Corporation
+.COMPANYNAME Microsoft Corporation
+.COPYRIGHT (c) Microsoft Corporation. All rights reserved.
+.TAGS DSCConfiguration
+.LICENSEURI https://github.com/PowerShell/xActiveDirectory/blob/master/LICENSE
+.PROJECTURI https://github.com/PowerShell/xActiveDirectory
+.ICONURI
+.EXTERNALMODULEDEPENDENCIES
+.REQUIREDSCRIPTS
+.EXTERNALSCRIPTDEPENDENCIES
+.RELEASENOTES
+.PRIVATEDATA
+#>
+
+#Requires -module xActiveDirectory
+
 <#
-    .EXAMPLE
-        In the following example configuration, a highly available domain is created by adding a second domain controller to the newly created domain.
-        This example uses the xWaitForDomain resource to ensure that the domain is present before the second domain controller is added.
+    .DESCRIPTION
+        This configuration will create a highly available domain by adding
+        a second domain controller to the newly created domain.
+        The xWaitForDomain resource is used to ensure that the domain is
+        present before the second domain controller is added.
 #>
-Configuration NewDomainWithTwoDCs
+
+Configuration NewDomainWithTwoDCs_Config
 {
     param
     (
@@ -74,6 +96,7 @@ Configuration NewDomainWithTwoDCs
         }
     }
 }
+
 # Configuration Data for AD
 $ConfigurationData = @{
     AllNodes = @(

Examples/Resources/xADDomainController/1-AddDomainControllerToDomainMinimal.ps1 → Examples/Resources/xADDomainController/1-AddDomainControllerToDomainMinimal_Config.ps1

@@ -22,7 +22,8 @@
         This configuration will add a domain controller to the domain
         contoso.com.
 #>
-Configuration AddDomainControllerToDomainMinimal
+
+Configuration AddDomainControllerToDomainMinimal_Config
 {
     param
     (

Examples/Resources/xADDomainController/2-AddDomainControllerToDomainAllProperties.ps1 → Examples/Resources/xADDomainController/2-AddDomainControllerToDomainAllProperties_Config.ps1

@@ -22,7 +22,8 @@
         This configuration will add a domain controller to the domain
         contoso.com, specifying all properties of the resource.
 #>
-Configuration AddDomainControllerToDomainAllProperties
+
+Configuration AddDomainControllerToDomainAllProperties_Config
 {
     param
     (

Examples/Resources/xADDomainController/3-AddDomainControllerToDomainUsingIFM.ps1 → Examples/Resources/xADDomainController/3-AddDomainControllerToDomainUsingIFM_Config.ps1

@@ -22,7 +22,8 @@
         This configuration will add a domain controller to the domain
         contoso.com using the information from media.
 #>
-Configuration AddDomainControllerToDomainUsingIFM
+
+Configuration AddDomainControllerToDomainUsingIFM_Config
 {
     param
     (

Examples/Resources/xADDomainDefaultPasswordPolicy/1-ConfigureDefaultPasswordPolicy_Config.ps1

@@ -0,0 +1,54 @@
+<#PSScriptInfo
+.VERSION 1.0
+.GUID 96b94fc3-2b96-47b7-82e8-d0551ec2e738
+.AUTHOR Microsoft Corporation
+.COMPANYNAME Microsoft Corporation
+.COPYRIGHT (c) Microsoft Corporation. All rights reserved.
+.TAGS DSCConfiguration
+.LICENSEURI https://github.com/PowerShell/xActiveDirectory/blob/master/LICENSE
+.PROJECTURI https://github.com/PowerShell/xActiveDirectory
+.ICONURI
+.EXTERNALMODULEDEPENDENCIES
+.REQUIREDSCRIPTS
+.EXTERNALSCRIPTDEPENDENCIES
+.RELEASENOTES
+.PRIVATEDATA
+#>
+
+#Requires -module xActiveDirectory
+
+<#
+    .DESCRIPTION
+        This configuration will set an Active Directory domain's default password
+        policy to set the minimum password length and complexity.
+#>
+
+Configuration ConfigureDefaultPasswordPolicy_Config
+{
+    Param
+    (
+        [parameter(Mandatory = $true)]
+        [System.String]
+        $DomainName,
+
+        [parameter(Mandatory = $true)]
+        [System.Boolean]
+        $ComplexityEnabled,
+
+        [parameter(Mandatory = $true)]
+        [System.Int32]
+        $MinPasswordLength
+    )
+
+    Import-DscResource -Module xActiveDirectory
+
+    Node $AllNodes.NodeName
+    {
+        xADDomainDefaultPasswordPolicy 'DefaultPasswordPolicy'
+        {
+            DomainName        = $DomainName
+            ComplexityEnabled = $ComplexityEnabled
+            MinPasswordLength = $MinPasswordLength
+        }
+    }
+}

Examples/Resources/xADDomainTrust/1-NewOneWayTrust.ps1 → Examples/Resources/xADDomainTrust/1-NewOneWayTrust_Config.ps1

@@ -1,9 +1,29 @@
+<#PSScriptInfo
+.VERSION 1.0
+.GUID 2caf2b93-d87e-426d-8c44-9f1d0452be10
+.AUTHOR Microsoft Corporation
+.COMPANYNAME Microsoft Corporation
+.COPYRIGHT (c) Microsoft Corporation. All rights reserved.
+.TAGS DSCConfiguration
+.LICENSEURI https://github.com/PowerShell/xActiveDirectory/blob/master/LICENSE
+.PROJECTURI https://github.com/PowerShell/xActiveDirectory
+.ICONURI
+.EXTERNALMODULEDEPENDENCIES
+.REQUIREDSCRIPTS
+.EXTERNALSCRIPTDEPENDENCIES
+.RELEASENOTES
+.PRIVATEDATA
+#>
+
+#Requires -module xActiveDirectory
+
 <#
-    .EXAMPLE
-        This example will create a new one way inbound trust between two domains.
+    .DESCRIPTION
+        This configuration will create a new one way inbound trust between two
+        domains.
 #>
 
-Configuration NewOneWayTrust
+Configuration NewOneWayTrust_Config
 {
     param
     (