ActiveDirectoryDsc

5.0.0-preview0005

The ActiveDirectoryDsc module contains DSC resources for deployment and configuration of Active Directory.

These DSC resources allow you to configure new domains, child domains, and high availability domain controllers, establish cross-domain trusts and manage users, groups and OUs.

Minimum PowerShell version

4.0

This is a prerelease version of ActiveDirectoryDsc.
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 ActiveDirectoryDsc -RequiredVersion 5.0.0-preview0005 -AllowPrerelease

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

Install-PSResource -Name ActiveDirectoryDsc -Version 5.0.0-preview0005 -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

Find-DomainController

DSCResources

ADComputer ADDomain ADDomainController ADDomainControllerProperties ADDomainDefaultPasswordPolicy ADDomainFunctionalLevel ADDomainTrust ADForestFunctionalLevel ADForestProperties ADGroup ADKDSKey ADManagedServiceAccount ADObjectEnabledState ADObjectPermissionEntry ADOptionalFeature ADOrganizationalUnit ADReplicationSite ADReplicationSiteLink ADServicePrincipalName ADUser WaitForADDomain

Dependencies

This module has no dependencies.

Release Notes

# Change log for ActiveDirectoryDsc

The format is based on and uses the types of changes according to [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

For older change log history see the [historic changelog](HISTORIC_CHANGELOG.md).

## [Unreleased]

### Added

- ADServicePrincipalName
 - Added Integration tests ([issue #358](https://github.com/PowerShell/ActiveDirectoryDsc/issues/358)).
- ADManagedServiceAccount
 - Added Integration tests.
- ADKDSKey
 - Added Integration tests ([issue #351](https://github.com/PowerShell/ActiveDirectoryDsc/issues/351)).

### Changed

- ADManagedServiceAccount
 - KerberosEncryptionType property added. ([issue #511](https://github.com/PowerShell/ActiveDirectoryDsc/issues/511)).
 - BREAKING CHANGE: AccountType parameter ValidateSet changed from ('Group', 'Single') to ('Group', 'Standalone') - Standalone is the correct terminology. Ref: [Service Accounts](https://docs.microsoft.com/en-us/windows/security/identity-protection/access-control/service-accounts).
 ([issue #515](https://github.com/PowerShell/ActiveDirectoryDsc/issues/515)).
 - BREAKING CHANGE: AccountType parameter default of Single removed. - Enforce positive choice of account type.
 - BREAKING CHANGE: MembershipAttribute parameter ValidateSet member SID changed to ObjectSid to match result property of Get-AdObject. Previous code does not work if SID is specified.
 - BREAKING CHANGE: AccountTypeForce parameter removed - unnecessary complication.
 - BREAKING CHANGE: Members parameter renamed to ManagedPasswordPrincipals - to closer match Get-AdServiceAccount result property PrincipalsAllowedToRetrieveManagedPassword. This is so that a DelegateToAccountPrincipals parameter can be added later.
 - Common Compare-ResourcePropertyState function used to replace function specific Compare-TargetResourceState and code refactored.
 ([issue #512](https://github.com/PowerShell/ActiveDirectoryDsc/issues/512)).
 - Resource unit tests refactored to use nested contexts and follow the logic of the module.
- ActiveDirectoryDsc
 - Updated PowerShell help files.
 - Updated Wiki link in README.md.
 - Remove verbose parameters from unit tests.
 - Fix PowerShell script file formatting and culture string alignment.
 - Add the `pipelineIndentationStyle` setting to the Visual Studio Code settings file.

### Fixed

- ActiveDirectoryDsc
 - Fix tests ErrorAction on DscResource.Test Import-Module.
- ADObjectPermissionEntry
 - Updated Assert-ADPSDrive with PSProvider Checks ([issue #527](https://github.com/PowerShell/ActiveDirectoryDsc/issues/527)).
- ADReplicationSite
 - Fixed incorrect evaluation of site configuration state when no description is defined ([issue #534](https://github.com/dsccommunity/ActiveDirectoryDsc/issues/534)).
- ADReplicationSiteLink
 - Fix RemovingSites verbose message ([issue #518](https://github.com/PowerShell/ActiveDirectoryDsc/issues/518)).
- ADComputer
 - Fixed the SamAcountName property description ([issue #529](https://github.com/dsccommunity/ActiveDirectoryDsc/issues/529)).

## 4.2.0.0

### Added

- ADReplicationSite
 - Added 'Description' attribute parameter ([issue #500](https://github.com/PowerShell/ActiveDirectoryDsc/issues/500)).
 - Added Integration testing ([issue #355](https://github.com/PowerShell/ActiveDirectoryDsc/issues/355)).
- ADReplicationSubnet
 - Added 'Description' attribute parameter ([issue #503](https://github.com/PowerShell/ActiveDirectoryDsc/issues/500)).
 - Added Integration testing ([issue #357](https://github.com/PowerShell/ActiveDirectoryDsc/issues/357)).
- ADReplicationSiteLink
 - Added Integration testing ([issue #356](https://github.com/PowerShell/ActiveDirectoryDsc/issues/356)).
 - Added ability to set 'Options' such as Change Notification Replication ([issue #504](https://github.com/PowerShell/ActiveDirectoryDsc/issues/504)).

### Fixed

- ActiveDirectoryDsc
 - Resolved custom Script Analyzer rules that was added to the test framework.
- ActiveDirectoryDsc.Common
 - Fix `Test-DscPropertyState` Failing when Comparing $Null and Arrays. ([issue #513](https://github.com/PowerShell/ActiveDirectoryDsc/issues/513)).
- ADReplicationSite
 - Correct value returned for RenameDefaultFirstSiteName ([issue #502](https://github.com/PowerShell/ActiveDirectoryDsc/issues/502)).

FileList

Version History

Version Downloads Last updated
6.6.0 31,520 9/29/2024
6.6.0-previe... 53 9/2/2024
6.5.1-previe... 44 8/19/2024
6.5.1-previe... 9 8/18/2024
6.5.0 57,472 5/17/2024
6.5.0-previe... 7 5/17/2024
6.4.1-previe... 82 4/8/2024
6.4.0 205,835 2/14/2024
6.4.0-previe... 10 2/14/2024
6.3.1-previe... 16 2/12/2024
6.3.0 381,801 8/24/2023
6.3.0-previe... 10 8/24/2023
6.3.0-previe... 2,672 5/26/2022
6.3.0-previe... 177 5/17/2022
6.2.0 3,634,834 5/1/2022
6.2.0-previe... 159 5/1/2022
6.2.0-previe... 157 5/1/2022
6.2.0-previe... 158 5/1/2022
6.2.0-previe... 164 4/30/2022
6.2.0-previe... 163 4/30/2022
6.2.0-previe... 2,448 1/24/2021
6.1.0-previe... 305,658 10/10/2020
6.1.0-previe... 636 7/13/2020
6.1.0-previe... 294 6/30/2020
6.1.0-previe... 194 6/23/2020
6.1.0-previe... 232 5/2/2020
6.1.0-previe... 191 5/2/2020
6.0.2-previe... 187 5/2/2020
6.0.2-previe... 202 4/27/2020
6.0.2-previe... 194 4/26/2020
6.0.2-previe... 193 4/25/2020
6.0.1 1,314,353 4/16/2020
6.0.1-previe... 199 4/9/2020
6.0.1-previe... 226 3/12/2020
6.0.0 10,067 3/12/2020
6.0.0-previe... 189 3/11/2020
6.0.0-previe... 190 3/10/2020
6.0.0-previe... 189 3/9/2020
6.0.0-previe... 189 3/9/2020
6.0.0-previe... 191 3/9/2020
6.0.0-previe... 189 3/9/2020
6.0.0-previe... 189 3/9/2020
6.0.0-previe... 195 2/28/2020
6.0.0-previe... 199 2/12/2020
5.1.0-previe... 194 2/10/2020
5.1.0-previe... 190 2/8/2020
5.1.0-previe... 192 2/7/2020
5.1.0-previe... 190 2/5/2020
5.1.0-previe... 195 1/20/2020
5.0.0 15,017 1/14/2020
5.0.0-previe... 190 1/14/2020
5.0.0-previe... (current version) 190 1/13/2020
5.0.0-previe... 189 1/12/2020
5.0.0-previe... 189 1/12/2020
5.0.0-previe... 189 1/12/2020
5.0.0-previe... 191 1/10/2020
4.2.0.0 20,891 10/30/2019
4.1.0.0 10,934 9/19/2019
4.0.0.0 9,104 8/8/2019
Show less