Update help.txt

DSCResources/MSFT_ADComputer/en-US/about_ADComputer.help.txt

@@ -1,4 +1,4 @@
-.NAME
+.NAME
     ADComputer
 
 .DESCRIPTION

DSCResources/MSFT_ADDomain/en-US/about_ADDomain.help.txt

@@ -1,4 +1,4 @@
-.NAME
+.NAME
     ADDomain
 
 .DESCRIPTION

DSCResources/MSFT_ADDomainController/en-US/about_ADDomainController.help.txt

@@ -1,4 +1,4 @@
-.NAME
+.NAME
     ADDomainController
 
 .DESCRIPTION

DSCResources/MSFT_ADDomainDefaultPasswordPolicy/en-US/about_ADDomainDefaultPasswordPolicy.help.txt

@@ -1,4 +1,4 @@
-.NAME
+.NAME
     ADDomainDefaultPasswordPolicy
 
 .DESCRIPTION

DSCResources/MSFT_ADDomainTrust/en-US/about_ADDomainTrust.help.txt

@@ -1,4 +1,4 @@
-.NAME
+.NAME
     ADDomainTrust
 
 .DESCRIPTION
@@ -35,12 +35,16 @@
     Key - String
     Specifies the name of the Active Directory domain that is requesting the trust.
 
+.PARAMETER AllowTrustRecreation
+    Write - Boolean
+    Specifies if the is allowed to be recreated if required. Default value is $false.
+
 .EXAMPLE 1
 
 This configuration will create a new one way inbound trust between two
 domains.
 
-Configuration ADDomainTrust_NewOneWayTrust_Config
+Configuration ADDomainTrust_ExternalInboundTrust_Config
 {
     param
     (
@@ -73,4 +77,44 @@ Configuration ADDomainTrust_NewOneWayTrust_Config
     }
 }
 
+.EXAMPLE 2
+
+This configuration will create a new one way inbound trust between two
+domains, and allows the trust to recreated if it should have the wrong
+trust type.
+
+Configuration ADDomainTrust_ExternalInboundTrustWithOptInToRecreate_Config
+{
+    param
+    (
+        [Parameter(Mandatory = $true)]
+        [System.String]
+        $SourceDomain,
+
+        [Parameter(Mandatory = $true)]
+        [System.String]
+        $TargetDomain,
+
+        [Parameter(Mandatory = $true)]
+        [System.Management.Automation.PSCredential]
+        $TargetDomainAdminCred
+    )
+
+    Import-DscResource -module ActiveDirectoryDsc
+
+    node localhost
+    {
+        ADDomainTrust 'Trust'
+        {
+            Ensure               = 'Present'
+            SourceDomainName     = $SourceDomain
+            TargetDomainName     = $TargetDomain
+            TargetCredential     = $TargetDomainAdminCred
+            TrustDirection       = 'Inbound'
+            TrustType            = 'External'
+            AllowTrustRecreation = $true
+        }
+    }
+}
+
 

DSCResources/MSFT_ADForestProperties/en-US/about_ADForestProperties.help.txt

@@ -1,4 +1,4 @@
-.NAME
+.NAME
     ADForestProperties
 
 .DESCRIPTION
@@ -52,7 +52,7 @@ Configuration ADForestProperties_ReplaceForestProperties_Config
 
     node 'localhost'
     {
-        ADForestProperties $Node.ForestName
+        ADForestProperties 'contoso.com'
         {
             ForestName                 = 'contoso.com'
             UserPrincipalNameSuffix    = 'fabrikam.com', 'industry.com'

DSCResources/MSFT_ADGroup/en-US/about_ADGroup.help.txt

@@ -1,4 +1,4 @@
-.NAME
+.NAME
     ADGroup
 
 .DESCRIPTION

DSCResources/MSFT_ADKDSKey/en-US/about_ADKDSKey.help.txt

@@ -1,4 +1,4 @@
-.NAME
+.NAME
     ADKDSKey
 
 .DESCRIPTION

DSCResources/MSFT_ADManagedServiceAccount/en-US/about_ADManagedServiceAccount.help.txt

@@ -1,4 +1,4 @@
-.NAME
+.NAME
     ADManagedServiceAccount
 
 .DESCRIPTION

DSCResources/MSFT_ADObjectEnabledState/en-US/about_ADObjectEnabledState.help.txt

@@ -1,4 +1,4 @@
-.NAME
+.NAME
     ADObjectEnabledState
 
 .DESCRIPTION

DSCResources/MSFT_ADObjectPermissionEntry/en-US/about_ADObjectPermissionEntry.help.txt

@@ -1,4 +1,4 @@
-.NAME
+.NAME
     ADObjectPermissionEntry
 
 .DESCRIPTION

DSCResources/MSFT_ADOrganizationalUnit/en-US/about_ADOrganizationalUnit.help.txt

@@ -1,4 +1,4 @@
-.NAME
+.NAME
     ADOrganizationalUnit
 
 .DESCRIPTION

DSCResources/MSFT_ADRecycleBin/en-US/about_ADRecycleBin.help.txt

@@ -1,4 +1,4 @@
-.NAME
+.NAME
     ADRecycleBin
 
 .DESCRIPTION

DSCResources/MSFT_ADReplicationSite/en-US/about_ADReplicationSite.help.txt

@@ -1,4 +1,4 @@
-.NAME
+.NAME
     ADReplicationSite
 
 .DESCRIPTION

DSCResources/MSFT_ADReplicationSiteLink/en-US/about_ADReplicationSiteLink.help.txt

@@ -1,4 +1,4 @@
-.NAME
+.NAME
     ADReplicationSiteLink
 
 .DESCRIPTION

DSCResources/MSFT_ADReplicationSubnet/en-US/about_ADReplicationSubnet.help.txt

@@ -1,4 +1,4 @@
-.NAME
+.NAME
     ADReplicationSubnet
 
 .DESCRIPTION

DSCResources/MSFT_ADServicePrincipalName/en-US/about_ADServicePrincipalName.help.txt

@@ -1,4 +1,4 @@
-.NAME
+.NAME
     ADServicePrincipalName
 
 .DESCRIPTION

DSCResources/MSFT_ADUser/en-US/about_ADUser.help.txt

@@ -1,4 +1,4 @@
-.NAME
+.NAME
     ADUser
 
 .DESCRIPTION

DSCResources/MSFT_WaitForADDomain/en-US/about_WaitForADDomain.help.txt

@@ -1,4 +1,4 @@
-.NAME
+.NAME
     WaitForADDomain
 
 .DESCRIPTION