xActiveDirectory
3.0.0.0
All of the resources in the D
All of the resources in the DSC Resource Kit are provided AS IS, and are not supported through any Microsoft standard support program or service.
Minimum PowerShell version
4.0
Installation Options
Owners
Copyright
(c) 2014 Microsoft Corporation. All rights reserved.
Package Details
Author(s)
- Microsoft Corporation
Tags
DesiredStateConfiguration DSC DSCResourceKit DSCResource
DSCResources
xADComputer xADDomain xADDomainController xADDomainDefaultPasswordPolicy xADDomainTrust xADForestProperties xADGroup xADKDSKey xADManagedServiceAccount xADObjectEnabledState xADObjectPermissionEntry xADOrganizationalUnit xADRecycleBin xADReplicationSite xADReplicationSiteLink xADReplicationSubnet xADServicePrincipalName xADUser xWaitForADDomain
Dependencies
This module has no dependencies.
Release Notes
- Changes to xActiveDirectory
- Added new helper functions in xADCommon, see each functions comment-based
help for more information.
- Convert-PropertyMapToObjectProperties
- Compare-ResourcePropertyState
- Test-DscPropertyState
- Move the examples in the README.md to Examples folder.
- Fix Script Analyzer rule failures.
- Opt-in to the following DSC Resource Common Meta Tests:
- Common Tests - Custom Script Analyzer Rules
- Common Tests - Required Script Analyzer Rules
- Common Tests - Flagged Script Analyzer Rules
- Common Tests - Validate Module Files ([issue 282](https://github.com/PowerShell/xActiveDirectory/issues/282))
- Common Tests - Validate Script Files ([issue 283](https://github.com/PowerShell/xActiveDirectory/issues/283))
- Common Tests - Relative Path Length ([issue 284](https://github.com/PowerShell/xActiveDirectory/issues/284))
- 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)).
- Removed helper function `Test-ADDomain` since it was not used. The
helper function had design flaws too.
- Now the helper function `Test-Members` outputs all the members that
are not in desired state when verbose output is enabled.
- Update all unit tests to latest unit test template.
- Deleted the obsolete xActiveDirectory_TechNetDocumentation.html file.
- Added new resource xADObjectEnabledState. This resource should be
used to enforce the `Enabled` property of computer accounts. This
resource replaces the deprecated `Enabled` property in the resource
xADComputer.
- Cleanup of code
- Removed semicolon throughout where it is not needed.
- Migrate tests to Pester syntax v4.x ([issue 322](https://github.com/PowerShell/xActiveDirectory/issues/322)).
- Removed `-MockWith {}` in unit tests.
- Use fully qualified type names for parameters and variables
([issue 374](https://github.com/PowerShell/xActiveDirectory/issues/374)).
- Removed unused legacy test files from the root of the repository.
- Updated Example List README with missing resources.
- Added missing examples for xADReplicationSubnet, xADServicePrincipalName and xWaitForADDomain. ([issue 395](https://github.com/PowerShell/xActiveDirectory/issues/395)).
- Changes to xADComputer
- Refactored the resource and the unit tests.
- BREAKING CHANGE: The `Enabled` property is **DEPRECATED** and is no
longer set or enforces with this resource. _If this parameter is_
_used in a configuration a warning message will be outputted saying_
_that the `Enabled` parameter has been deprecated_. The new resource
[xADObjectEnabledState](https://github.com/PowerShell/xActiveDirectoryxadobjectenabledstate)
can be used to enforce the `Enabled` property.
- BREAKING CHANGE: The default value of the enabled property of the
computer account will be set to the default value of the cmdlet
`New-ADComputer`.
- A new parameter was added called `EnabledOnCreation` that will control
if the computer account is created enabled or disabled.
- Moved examples from the README.md to separate example files in the
Examples folder.
- Fix the RestoreFromRecycleBin description.
- Fix unnecessary cast in `Test-TargetResource` ([issue 295](https://github.com/PowerShell/xActiveDirectory/issues/295)).
- Fix ServicePrincipalNames property empty string exception ([issue 382](https://github.com/PowerShell/xActiveDirectory/issues/382)).
- Changes to xADGroup
- Change the description of the property RestoreFromRecycleBin.
- Code cleanup.
- Changes to xADObjectPermissionEntry
- Change the description of the property IdentityReference.
- Fix failure when applied in the same configuration as xADDomain.
- Localize and Improve verbose messaging.
- Code cleanup.
- Changes to xADOrganizationalUnit
- Change the description of the property RestoreFromRecycleBin.
- Code cleanup.
- Fix incorrect verbose message when this resource has Ensure set to Absent ([issue 276](https://github.com/PowerShell/xActiveDirectory/issues/276)).
- Changes to xADUser
- Change the description of the property RestoreFromRecycleBin.
- Added ServicePrincipalNames property ([issue 153](https://github.com/PowerShell/xActiveDirectory/issues/153)).
- Added ChangePasswordAtLogon property ([issue 246](https://github.com/PowerShell/xActiveDirectory/issues/246)).
- Code cleanup.
- Added LogonWorkstations property
- Added Organization property
- Added OtherName property
- Added AccountNotDelegated property
- Added AllowReversiblePasswordEncryption property
- Added CompoundIdentitySupported property
- Added PasswordNotRequired property
- Added SmartcardLogonRequired property
- Added ProxyAddresses property ([Issue 254](https://github.com/PowerShell/xActiveDirectory/issues/254)).
- Fix Password property being updated whenever another property is changed
([issue 384](https://github.com/PowerShell/xActiveDirectory/issues/384)).
- Replace Write-Error with the correct helper function ([Issue 331](https://github.com/PowerShell/xActiveDirectory/issues/331)).
- Changes to xADDomainController
- Change the `Requires` statement in the Examples to require the correct
module.
- Suppressing the Script Analyzer rule `PSAvoidGlobalVars` since the
resource is using the `$global:DSCMachineStatus` variable to trigger
a reboot.
- Code cleanup.
- Changes to xADDomain
- Suppressing the Script Analyzer rule `PSAvoidGlobalVars` since the
resource is using the `$global:DSCMachineStatus` variable to trigger
a reboot.
- Code cleanup.
- Changes to xADDomainTrust
- Replaced New-TerminatingError with Standard Function.
- Code cleanup.
- Changes to xWaitForADDomain
- Suppressing the Script Analyzer rule `PSAvoidGlobalVars` since the
resource is using the `$global:DSCMachineStatus` variable to trigger
a reboot.
- Added missing property schema descriptions ([issue 369](https://github.com/PowerShell/xActiveDirectory/issues/369)).
- Code cleanup.
- Changes to xADRecycleBin
- Remove unneeded example and resource designer files.
- Added missing property schema descriptions ([issue 368](https://github.com/PowerShell/xActiveDirectory/issues/368)).
- Code cleanup.
- It now sets back the `$ErrorActionPreference` that was set prior to
setting it to `"Stop"`.
- Replace Write-Error with the correct helper function ([issue 327](https://github.com/PowerShell/xActiveDirectory/issues/327)).
- Changes to xADReplicationSiteLink
- Fix ADIdentityNotFoundException when creating a new site link.
- Code cleanup.
- Changes to xADReplicationSubnet
- Remove `{ *Present* | Absent }` from the property schema descriptions
which were causing corruption in the Wiki documentation.
- Changes to xADServicePrincipalNames
- Remove `{ *Present* | Absent }` from the property schema descriptions
which were causing corruption in the Wiki documentation.
- Changes to xADDomainDefaultPasswordPolicy
- Code cleanup.
- Changes to xADForestProperties
- Minor style cleanup.
- Changes to xADReplicationSubnet
- Code cleanup.
- Changes to xADKDSKey
- Code cleanup.
- Changes to xADManagedServiceAccount
- Code cleanup.
- Changes to xADServicePrincipalName
- Code cleanup.
FileList
- xActiveDirectory.nuspec
- CHANGELOG.md
- LICENSE
- README.md
- xActiveDirectory.psd1
- DSCResources\MSFT_xADComputer\MSFT_xADComputer.psm1
- DSCResources\MSFT_xADComputer\MSFT_xADComputer.schema.mof
- DSCResources\MSFT_xADComputer\README.md
- DSCResources\MSFT_xADComputer\en-US\MSFT_xADComputer.strings.psd1
- DSCResources\MSFT_xADDomain\MSFT_xADDomain.psm1
- DSCResources\MSFT_xADDomain\MSFT_xADDomain.schema.mof
- DSCResources\MSFT_xADDomain\README.md
- DSCResources\MSFT_xADDomain\en-US\MSFT_xADDomain.strings.psd1
- DSCResources\MSFT_xADDomainController\MSFT_xADDomainController.psm1
- DSCResources\MSFT_xADDomainController\MSFT_xADDomainController.schema.mof
- DSCResources\MSFT_xADDomainController\README.md
- DSCResources\MSFT_xADDomainController\en-US\MSFT_xADDomainController.strings.psd1
- DSCResources\MSFT_xADDomainDefaultPasswordPolicy\MSFT_xADDomainDefaultPasswordPolicy.psm1
- DSCResources\MSFT_xADDomainDefaultPasswordPolicy\MSFT_xADDomainDefaultPasswordPolicy.schema.mof
- DSCResources\MSFT_xADDomainDefaultPasswordPolicy\README.md
- DSCResources\MSFT_xADDomainDefaultPasswordPolicy\en-US\MSFT_xADDomainDefaultPasswordPolicy.strings.psd1
- DSCResources\MSFT_xADDomainTrust\MSFT_xADDomainTrust.psm1
- DSCResources\MSFT_xADDomainTrust\MSFT_xADDomainTrust.schema.mof
- DSCResources\MSFT_xADDomainTrust\README.md
- DSCResources\MSFT_xADDomainTrust\en-US\MSFT_xADDomainTrust.strings.psd1
- DSCResources\MSFT_xADForestProperties\MSFT_xADForestProperties.psm1
- DSCResources\MSFT_xADForestProperties\MSFT_xADForestProperties.schema.mof
- DSCResources\MSFT_xADForestProperties\README.md
- DSCResources\MSFT_xADForestProperties\en-US\MSFT_xADForestProperties.strings.psd1
- DSCResources\MSFT_xADGroup\MSFT_xADGroup.psm1
- DSCResources\MSFT_xADGroup\MSFT_xADGroup.schema.mof
- DSCResources\MSFT_xADGroup\README.md
- DSCResources\MSFT_xADGroup\en-US\MSFT_xADGroup.strings.psd1
- DSCResources\MSFT_xADKDSKey\MSFT_xADKDSKey.psm1
- DSCResources\MSFT_xADKDSKey\MSFT_xADKDSKey.schema.mof
- DSCResources\MSFT_xADKDSKey\README.md
- DSCResources\MSFT_xADKDSKey\en-US\MSFT_xADKDSKey.strings.psd1
- DSCResources\MSFT_xADManagedServiceAccount\MSFT_xADManagedServiceAccount.psm1
- DSCResources\MSFT_xADManagedServiceAccount\MSFT_xADManagedServiceAccount.schema.mof
- DSCResources\MSFT_xADManagedServiceAccount\README.md
- DSCResources\MSFT_xADManagedServiceAccount\en-US\MSFT_xADManagedServiceAccount.strings.psd1
- DSCResources\MSFT_xADObjectEnabledState\MSFT_xADObjectEnabledState.psm1
- DSCResources\MSFT_xADObjectEnabledState\MSFT_xADObjectEnabledState.schema.mof
- DSCResources\MSFT_xADObjectEnabledState\README.md
- DSCResources\MSFT_xADObjectEnabledState\en-US\MSFT_xADObjectEnabledState.strings.psd1
- DSCResources\MSFT_xADObjectPermissionEntry\MSFT_xADObjectPermissionEntry.psm1
- DSCResources\MSFT_xADObjectPermissionEntry\MSFT_xADObjectPermissionEntry.schema.mof
- DSCResources\MSFT_xADObjectPermissionEntry\README.md
- DSCResources\MSFT_xADObjectPermissionEntry\en-US\MSFT_xADObjectPermissionEntry.strings.psd1
- DSCResources\MSFT_xADOrganizationalUnit\MSFT_xADOrganizationalUnit.psm1
- DSCResources\MSFT_xADOrganizationalUnit\MSFT_xADOrganizationalUnit.schema.mof
- DSCResources\MSFT_xADOrganizationalUnit\README.md
- DSCResources\MSFT_xADOrganizationalUnit\en-US\MSFT_xADOrganizationalUnit.strings.psd1
- DSCResources\MSFT_xADRecycleBin\MSFT_xADRecycleBin.psm1
- DSCResources\MSFT_xADRecycleBin\MSFT_xADRecycleBin.schema.mof
- DSCResources\MSFT_xADRecycleBin\README.md
- DSCResources\MSFT_xADRecycleBin\en-US\MSFT_xADRecycleBin.strings.psd1
- DSCResources\MSFT_xADReplicationSite\MSFT_xADReplicationSite.psm1
- DSCResources\MSFT_xADReplicationSite\MSFT_xADReplicationSite.schema.mof
- DSCResources\MSFT_xADReplicationSite\README.md
- DSCResources\MSFT_xADReplicationSite\en-US\MSFT_xADReplicationSite.strings.psd1
- DSCResources\MSFT_xADReplicationSiteLink\MSFT_xADReplicationSiteLink.psm1
- DSCResources\MSFT_xADReplicationSiteLink\MSFT_xADReplicationSiteLink.schema.mof
- DSCResources\MSFT_xADReplicationSiteLink\README.md
- DSCResources\MSFT_xADReplicationSiteLink\en-US\MSFT_xADReplicationSiteLink.strings.psd1
- DSCResources\MSFT_xADReplicationSubnet\MSFT_xADReplicationSubnet.psm1
- DSCResources\MSFT_xADReplicationSubnet\MSFT_xADReplicationSubnet.schema.mof
- DSCResources\MSFT_xADReplicationSubnet\README.md
- DSCResources\MSFT_xADReplicationSubnet\en-US\MSFT_xADReplicationSubnet.strings.psd1
- DSCResources\MSFT_xADServicePrincipalName\MSFT_xADServicePrincipalName.psm1
- DSCResources\MSFT_xADServicePrincipalName\MSFT_xADServicePrincipalName.schema.mof
- DSCResources\MSFT_xADServicePrincipalName\README.md
- DSCResources\MSFT_xADServicePrincipalName\en-US\MSFT_xADServicePrincipalName.strings.psd1
- DSCResources\MSFT_xADUser\MSFT_xADUser.psm1
- DSCResources\MSFT_xADUser\MSFT_xADUser.schema.mof
- DSCResources\MSFT_xADUser\README.md
- DSCResources\MSFT_xADUser\en-US\MSFT_xADUser.strings.psd1
- DSCResources\MSFT_xWaitForADDomain\MSFT_xWaitForADDomain.psm1
- DSCResources\MSFT_xWaitForADDomain\MSFT_xWaitForADDomain.schema.mof
- DSCResources\MSFT_xWaitForADDomain\README.md
- DSCResources\MSFT_xWaitForADDomain\en-US\MSFT_xWaitForADDomain.strings.psd1
- Examples\README.md
- Examples\Resources\xADComputer\1-AddComputerAccount_Config.ps1
- Examples\Resources\xADComputer\2-AddComputerAccountDisabled_Config.ps1
- Examples\Resources\xADComputer\3-AddComputerAccountSpecificPath_Config.ps1
- Examples\Resources\xADComputer\4-AddComputerAccountAndCreateODJRequest_Config.ps1
- Examples\Resources\xADDomain\1-NewForest_Config.ps1
- Examples\Resources\xADDomain\2-NewChildDomain_Config.ps1
- Examples\Resources\xADDomain\3-NewForestwithParentAndChildDomain_Config.ps1
- Examples\Resources\xADDomain\4-NewDomainWithTwoDCs_Config.ps1
- Examples\Resources\xADDomainController\1-AddDomainControllerToDomainMinimal_Config.ps1
- Examples\Resources\xADDomainController\2-AddDomainControllerToDomainAllProperties_Config.ps1
- Examples\Resources\xADDomainController\3-AddDomainControllerToDomainUsingIFM_Config.ps1
- Examples\Resources\xADDomainDefaultPasswordPolicy\1-ConfigureDefaultPasswordPolicy_Config.ps1
- Examples\Resources\xADDomainTrust\1-NewOneWayTrust_Config.ps1
- Examples\Resources\xADForestProperties\1-ReplaceForestProperties_Config.ps1
- Examples\Resources\xADForestProperties\2-AddRemoveForestProperties_Config.ps1
- Examples\Resources\xADGroup\1-NewGroup_Config.ps1
- Examples\Resources\xADGroup\2-NewGroupWithMembers_Config.ps1
- Examples\Resources\xADGroup\3-NewGroupMultidomainMembers_Config.ps1
- Examples\Resources\xADKDSKey\1-CreateKDSRootKey_Config.ps1
- Examples\Resources\xADKDSKey\2-CreateKDSRootKeyInPast_Config.ps1
- Examples\Resources\xADKDSKey\3-CreateKDSRootKeyRemoveLastKey_Config.ps1
- Examples\Resources\xADManagedServiceAccount\1-CreateManagedServiceAccount_Config.ps1
- Examples\Resources\xADManagedServiceAccount\2-CreateGroupManagedServiceAccount_Config.ps1
- Examples\Resources\xADManagedServiceAccount\3-CreateGroupManagedServiceAccountWithMembers_Config.ps1
- Examples\Resources\xADObjectEnabledState\1-EnabledComputerAccount_Config.ps1
- Examples\Resources\xADObjectEnabledState\2-CreateClusterComputerAccount_Config.ps1
- Examples\Resources\xADObjectEnabledState\3-EnabledPrestagedClusterComputerAccount_Config.ps1
- Examples\Resources\xADObjectPermissionEntry\1-DelegateFullControl_Config.ps1
- Examples\Resources\xADObjectPermissionEntry\2-CreateDeleteComputerObject_Config.ps1
- Examples\Resources\xADObjectPermissionEntry\3-ReadWriteComputerObjectProperties_Config.ps1
- Examples\Resources\xADOrganizationalUnit\1-CreateADOU_Config.ps1
- Examples\Resources\xADRecycleBin\1-EnableADRecycleBin_Config.ps1
- Examples\Resources\xADReplicationSite\1-CreateADReplicationSite_Config.ps1
- Examples\Resources\xADReplicationSite\2-CreateADReplicationSiteRenameDefault_Config.ps1
- Examples\Resources\xADReplicationSite\3-RemoveADReplicationSite_Config.ps1
- Examples\Resources\xADReplicationSiteLInk\1-CreateReplicationSiteLink_Config.ps1
- Examples\Resources\xADReplicationSiteLInk\2-ModifyExistingReplicationSiteLink_Config.ps1
- Examples\Resources\xADReplicationSubnet\1-CreateReplicationSubnet_Config.ps1
- Examples\Resources\xADServicePrincipalName\1-AddUserServicePrincipalName_Config.ps1
- Examples\Resources\xADServicePrincipalName\2-AddComputerServicePrincipalName_Config.ps1
- Examples\Resources\xADUser\1-CreateUserAndManagePassword_Config.ps1
- Examples\Resources\xADUser\2-CreateUserAndIgnorePasswordChanges_Config.ps1
- Examples\Resources\xWaitForADDomain\1-WaitForADDomain_Config.ps1
- Modules\xActiveDirectory.Common\xActiveDirectory.Common.psm1
- Modules\xActiveDirectory.Common\en-US\xActiveDirectory.Common.strings.psd1
- Tests\Integration\MSFT_xADComputer.config.ps1
- Tests\Integration\MSFT_xADComputer.Integration.Tests.ps1
- Tests\Integration\MSFT_xADObjectEnabledState.config.ps1
- Tests\Integration\MSFT_xADObjectEnableState.Integration.Tests.ps1
- Tests\Unit\MSFT_xADComputer.Tests.ps1
- Tests\Unit\MSFT_xADDomain.Tests.ps1
- Tests\Unit\MSFT_xADDomainController.Tests.ps1
- Tests\Unit\MSFT_xADDomainDefaultPasswordPolicy.Tests.ps1
- Tests\Unit\MSFT_xADForestProperties.Tests.ps1
- Tests\Unit\MSFT_xADGroup.Tests.ps1
- Tests\Unit\MSFT_xADKDSKey.Tests.ps1
- Tests\Unit\MSFT_xADManagedServiceAccount.Tests.ps1
- Tests\Unit\MSFT_xADObjectEnabledState.Tests.ps1
- Tests\Unit\MSFT_xADObjectPermissionEntry.Tests.ps1
- Tests\Unit\MSFT_xADOrganizationalUnit.Tests.ps1
- Tests\Unit\MSFT_xADRecycleBin.Tests.ps1
- Tests\Unit\MSFT_xADReplicationSite.Tests.ps1
- Tests\Unit\MSFT_xADReplicationSiteLink.tests.ps1
- Tests\Unit\MSFT_xADReplicationSubnet.Tests.ps1
- Tests\Unit\MSFT_xADServicePrincipalName.Tests.ps1
- Tests\Unit\MSFT_xADUser.Tests.ps1
- Tests\Unit\MSFT_xWaitForADDomain.Tests.ps1
- Tests\Unit\xActiveDirectory.Common.Tests.ps1
- Tests\Unit\Stubs\ActiveDirectoryStub.psm1
- Tests\Unit\Stubs\Microsoft.ActiveDirectory.Management.cs
- Tests\Unit\Stubs\Microsoft.DirectoryServices.Deployment.Types.cs
Version History
Version | Downloads | Last updated |
---|---|---|
3.0.0.0 (current version) | 555,713 | 6/26/2019 |
2.26.0.0 | 20,166 | 5/15/2019 |
2.25.0.0 | 28,845 | 4/3/2019 |
2.24.0.0 | 11,330 | 2/20/2019 |
2.23.0.0 | 10,421 | 1/10/2019 |
2.22.0.0 | 9,621 | 10/25/2018 |
2.21.0.0 | 9,017 | 9/5/2018 |
2.20.0.0 | 7,138 | 7/25/2018 |
2.19.0.0 | 151,485 | 6/13/2018 |
2.18.0.0 | 42,414 | 3/22/2018 |
2.17.0.0 | 13,198 | 2/8/2018 |
2.16.0.0 | 78,864 | 1/11/2017 |
2.15.0.0 | 1,297 | 12/14/2016 |
2.14.0.0 | 10,988 | 11/2/2016 |
2.13.0.0 | 5,166 | 8/10/2016 |
2.12.0.0 | 3,439 | 6/29/2016 |
2.11.0.0 | 2,722 | 5/18/2016 |
2.10.0.0 | 2,305 | 3/31/2016 |
2.9.0.0 | 2,098 | 2/2/2016 |
2.8.0.0 | 949 | 12/3/2015 |
2.7.0.0 | 533 | 10/22/2015 |
2.6.0.0 | 1,259 | 9/11/2015 |
2.5.0.0 | 452 | 7/24/2015 |
2.4.0.0 | 203 | 6/17/2015 |
2.3 | 19,106 | 2/19/2015 |
2.2 | 88 | 12/18/2014 |
2.1 | 147 | 8/22/2014 |
2.0 | 109 | 6/6/2014 |
1.0.1 | 76 | 5/13/2014 |
1.0 | 61 | 4/8/2014 |