DnsServerDsc
3.0.0-preview0005
This module contains DSC resources for the management and configuration of Windows Server DNS Server.
Minimum PowerShell version
5.0
See the version list below for details.
Installation Options
Owners
Copyright
Copyright the DSC Community contributors. All rights reserved.
Package Details
Author(s)
- DSC Community
Tags
DesiredStateConfiguration DSC DSCResourceKit DSCResource
DSCResources
DnsRecordCname DnsRecordPtr DnsRecordA DnsRecordAaaa DnsRecordCnameScoped DnsRecordMx DnsRecordNs DnsRecordSrv DnsServerCache DnsServerDsSetting DnsServerEDns DnsServerRecursion DnsServerScavenging DnsRecordAaaaScoped DnsRecordAScoped DnsRecordMxScoped DnsRecordNsScoped DnsRecordSrvScoped DnsServerADZone DnsServerClientSubnet DnsServerConditionalForwarder DnsServerDiagnostics DnsServerForwarder DnsServerPrimaryZone DnsServerRootHint DnsServerSecondaryZone DnsServerSetting DnsServerSettingLegacy DnsServerZoneAging DnsServerZoneScope DnsServerZoneTransfer
Dependencies
This module has no dependencies.
Release Notes
## [3.0.0-preview0005] - 2021-05-26
### Removed
- xDnsRecord
- BREAKING CHANGE: The resource has been replaced by _DnsServerA_, _DnsServerPtr_,
and _DnsServerCName_ ([issue #221](https://github.com/dsccommunity/DnsServerDsc/issues/221)).
- xDnsServerMx
- BREAKING CHANGE: The resource has been replaced by _DnsServerMx_ ([issue #228](https://github.com/dsccommunity/DnsServerDsc/issues/228)).
- DnsServerSetting
- BREAKING CHANGE: The properties `Forwarders` and `ForwardingTimeout` has
been removed ([issue #192](https://github.com/dsccommunity/DnsServerDsc/issues/192)).
Use the resource _DnsServerForwarder_ to enforce these properties.
- BREAKING CHANGE: The properties `EnableEDnsProbes` and `EDnsCacheTimeout` has
been removed ([issue #195](https://github.com/dsccommunity/DnsServerDsc/issues/195)).
Use the resource _DnsServerEDns_ to enforce these properties.
- BREAKING CHANGE: The properties `SecureResponses`, `MaxCacheTTL`, and
`MaxNegativeCacheTTL` has been removed ([issue #197](https://github.com/dsccommunity/DnsServerDsc/issues/197)).
To enforce theses properties, use resource _DnsServerEDns_ using the
properties `EnablePollutionProtection`, `MaxTtl`, and `MaxNegativeTtl`
respectively.
- BREAKING CHANGE: The properties `DefaultAgingState`, `ScavengingInterval`,
`DefaultNoRefreshInterval`, and `DefaultRefreshInterval` have been removed.
Use the resource _DnsServerScavenging_ to enforce this properties ([issue #193](https://github.com/dsccommunity/DnsServerDsc/issues/193)).
- BREAKING CHANGE: The properties `NoRecursion`, `RecursionRetry`, and
`RecursionTimeout` has been removed ([issue #200](https://github.com/dsccommunity/DnsServerDsc/issues/200)).
To enforce theses properties, use resource _DnsServerRecursion_ using the
properties `Enable`, `RetryInterval`, and `Timeout` respectively.
- BREAKING CHANGE: A few properties that are not supported by any DNS
Server PowerShell cmdlet was moved to the new resource _DnsServerSettingLegacy_.
- BREAKING CHANGE: The properties `DsPollingInterval` and `DsTombstoneInterval`
has been removed ([issue #252](https://github.com/dsccommunity/DnsServerDsc/issues/252)).
Use the resource _DnsServerDsSetting_ to enforce these properties.
- ResourceBase
- For the method `Get()` the overload that took a `[Microsoft.Management.Infrastructure.CimInstance]`
was removed as it is not the correct pattern going forward.
### Added
- DnsServerDsc
- Added new resource
- _DnsServerCache_ - resource to enforce cache settings ([issue #196](https://github.com/dsccommunity/DnsServerDsc/issues/196)).
- _DnsServerRecursion_ - resource to enforce recursion settings ([issue #198](https://github.com/dsccommunity/DnsServerDsc/issues/198)).
- Added new private function `Get-ClassName` that returns the class name
or optionally an array with the class name and all inherited base class
named.
- Added new private function `Get-LocalizedDataRecursive` that gathers
all localization strings from an array of class names. This can be used
in classes to be able to inherit localization strings from one or more
base class. If a localization string key exist in a parent class's
localization string file it will override the localization string key
in any base class.
- Fixed code coverage in the pipeline ([issue #246](https://github.com/dsccommunity/DnsServerDsc/issues/246)).
- ResourceBase
- Added new method `Assert()` tha calls `Assert-Module` and `AssertProperties()`.
- DnsRecordNs
- Added new resource to manage NS records
- DnsRecordNsScoped
- Added new resource to manage scoped NS records
- DnsServerDsSetting
- Added new resource to manage AD-integrated DNS settings
- DnsServerSettingLegacy
- A new resource to manage legacy DNS Server settings that are not supported
by any DNS Server PowerShell cmdlet.
### Changed
- DnsServerDsc
- BREAKING CHANGE: Renamed the module to DnsServerDsc ([issue #179](https://github.com/dsccommunity/DnsServerDsc/issues/179)).
- BREAKING CHANGE: Removed the prefix 'x' from all MOF-based resources
([issue #179](https://github.com/dsccommunity/DnsServerDsc/issues/179)).
- Renamed a MOF-based resource to use the prefix 'DSC' ([issue #225](https://github.com/dsccommunity/DnsServerDsc/issues/225)).
- Fix stub `Get-DnsServerResourceRecord` so it throws if it is not mocked
correctly ([issue #204](https://github.com/dsccommunity/DnsServerDsc/issues/204)).
- Switch the order in the deploy pipeline so that creating the GitHub release
is made after a successful release.
- Updated stub functions to throw if they are used (when missing a mock in
unit test) ([issue #235](https://github.com/dsccommunity/DnsServerDsc/issues/235)).
- ResourceBase
- Added support for inherit localization strings and also able to override
a localization string that exist in a base class.
- Moved more logic from the resources into the base class for the method
`Test()`, `Get()`, and `Set()`. The base class now have three methods
`AssertProperties()`, `Modify()`, and `GetCurrentState()` where the
two latter ones must be overridden by a resource if calling the base
methods `Set()` and `Get()`.
- Moved the `Assert-Module` from the constructor to a new method `Assert()`
that is called from `Get()`, `Test()`, and `Set()`. The method `Assert()`
also calls the method `AssertProperties()`. The method `Assert()` is not
meant to be overridden, but can if there is a reason not to run
`Assert-Module` and or `AssertProperties()`.
- Integration tests
- Added commands in the DnsRecord* integration tests to wait for the LCM
before moving to the next test.
- DnsServerCache
- Moved to the same coding pattern as _DnsServerRecursion_.
- DnsServerEDns
- Moved to the same coding pattern as _DnsServerRecursion_.
- DnsServerScavenging
- Moved to the same coding pattern as _DnsServerRecursion_.
- DnsServerSetting
- Changed to use `Get-DnsServerSetting` and `Set-DnsServerSetting`
([issue #185](https://github.com/dsccommunity/xDnsServer/issues/185)).
- BREAKING CHANGE: The property `DisableAutoReverseZones` have been renamed
to `DisableAutoReverseZone`.
- BREAKING CHANGE: The property `ListenAddresses` have been renamed
to `ListeningIPAddress`.
- BREAKING CHANGE: The property `AllowUpdate` was changed to a boolean
value (`$true` or `$false`) since that is what the cmdlet `Set-DnsServerSetting`
is expecting (related to [issue #101](https://github.com/dsccommunity/xDnsServer/issues/101)).
- BREAKING CHANGE: The property `EnableDnsSec` was changed to a boolean
value (`$true` or `$false`) since that is what the cmdlet `Set-DnsServerSetting`
is expecting.
- BREAKING CHANGE: The property `ForwardDelegations` was changed to a boolean
value (`$true` or `$false`) since that is what the cmdlet `Set-DnsServerSetting`
is expecting.
### Fixed
- Logic bug in DnsRecordPtr.expandIPv6String($string) (#255)
- Supporting tests added
FileList
- DnsServerDsc.nuspec
- DnsServerDsc.psm1
- DnsServerDsc.psd1
- en-US\ResourcePropertiesBase.strings.psd1
- en-US\about_DnsRecordSrv.help.txt
- en-US\DnsRecordA.strings.psd1
- en-US\DnsRecordNsScoped.strings.psd1
- en-US\DnsServerEDns.strings.psd1
- en-US\DnsServerDsSetting.strings.psd1
- en-US\DnsServerScavenging.strings.psd1
- en-US\about_DnsServerCache.help.txt
- en-US\DnsServerCache.strings.psd1
- en-US\about_DnsRecordCnameScoped.help.txt
- en-US\DnsRecordCname.strings.psd1
- en-US\about_DnsRecordAaaa.help.txt
- en-US\DnsRecordMxScoped.strings.psd1
- en-US\DnsRecordAaaa.strings.psd1
- en-US\DnsServerDsc.strings.psd1
- en-US\ResourceBase.strings.psd1
- en-US\DnsRecordSrv.strings.psd1
- en-US\about_DnsRecordPtr.help.txt
- en-US\about_DnsRecordNsScoped.help.txt
- en-US\DnsServerRecursion.strings.psd1
- en-US\about_DnsRecordA.help.txt
- en-US\about_DnsServerEDns.help.txt
- en-US\DnsRecordSrvScoped.strings.psd1
- en-US\about_DnsRecordCname.help.txt
- en-US\DnsRecordAaaaScoped.strings.psd1
- en-US\DnsRecordAScoped.strings.psd1
- en-US\about_DnsRecordAScoped.help.txt
- en-US\about_DnsRecordAaaaScoped.help.txt
- en-US\DnsRecordNs.strings.psd1
- en-US\about_DnsServerScavenging.help.txt
- en-US\about_DnsRecordMx.help.txt
- en-US\about_DnsServerDsSetting.help.txt
- en-US\DnsRecordCnameScoped.strings.psd1
- en-US\about_DnsRecordNs.help.txt
- en-US\DnsRecordMx.strings.psd1
- en-US\about_DnsRecordMxScoped.help.txt
- en-US\DnsRecordPtr.strings.psd1
- en-US\about_DnsRecordSrvScoped.help.txt
- en-US\about_DnsServerDsc.help.txt
- en-US\DnsRecordBase.strings.psd1
- en-US\about_DnsServerRecursion.help.txt
- DSCResources\DSC_DnsServerRootHint\DSC_DnsServerRootHint.psm1
- DSCResources\DSC_DnsServerRootHint\DSC_DnsServerRootHint.schema.mof
- DSCResources\DSC_DnsServerRootHint\README.md
- DSCResources\DSC_DnsServerForwarder\DSC_DnsServerForwarder.schema.mof
- DSCResources\DSC_DnsServerForwarder\README.md
- DSCResources\DSC_DnsServerForwarder\DSC_DnsServerForwarder.psm1
- DSCResources\DSC_DnsServerDiagnostics\DSC_DnsServerDiagnostics.psm1
- DSCResources\DSC_DnsServerDiagnostics\DSC_DnsServerDiagnostics.schema.mof
- DSCResources\DSC_DnsServerDiagnostics\README.md
- DSCResources\DSC_DnsServerSettingLegacy\DSC_DnsServerSettingLegacy.psm1
- DSCResources\DSC_DnsServerSettingLegacy\DSC_DnsServerSettingLegacy.schema.mof
- DSCResources\DSC_DnsServerSettingLegacy\README.md
- DSCResources\DSC_DnsServerSetting\DSC_DnsServerSetting.psm1
- DSCResources\DSC_DnsServerSetting\README.md
- DSCResources\DSC_DnsServerSetting\DSC_DnsServerSetting.schema.mof
- DSCResources\DSC_DnsServerZoneTransfer\DSC_DnsServerZoneTransfer.schema.mof
- DSCResources\DSC_DnsServerZoneTransfer\DSC_DnsServerZoneTransfer.psm1
- DSCResources\DSC_DnsServerZoneTransfer\README.md
- DSCResources\DSC_DnsServerConditionalForwarder\DSC_DnsServerConditionalForwarder.schema.mof
- DSCResources\DSC_DnsServerConditionalForwarder\README.md
- DSCResources\DSC_DnsServerConditionalForwarder\DSC_DnsServerConditionalForwarder.psm1
- DSCResources\DSC_DnsServerSecondaryZone\README.md
- DSCResources\DSC_DnsServerSecondaryZone\DSC_DnsServerSecondaryZone.schema.mof
- DSCResources\DSC_DnsServerSecondaryZone\DSC_DnsServerSecondaryZone.psm1
- DSCResources\DSC_DnsServerZoneScope\DSC_DnsServerZoneScope.psm1
- DSCResources\DSC_DnsServerZoneScope\README.md
- DSCResources\DSC_DnsServerZoneScope\DSC_DnsServerZoneScope.schema.mof
- DSCResources\DSC_DnsServerADZone\DSC_DnsServerADZone.psm1
- DSCResources\DSC_DnsServerADZone\README.md
- DSCResources\DSC_DnsServerADZone\DSC_DnsServerADZone.schema.mof
- DSCResources\DSC_DnsServerPrimaryZone\DSC_DnsServerPrimaryZone.psm1
- DSCResources\DSC_DnsServerPrimaryZone\DSC_DnsServerPrimaryZone.schema.mof
- DSCResources\DSC_DnsServerPrimaryZone\README.md
- DSCResources\DSC_DnsServerZoneAging\DSC_DnsServerZoneAging.schema.mof
- DSCResources\DSC_DnsServerZoneAging\DSC_DnsServerZoneAging.psm1
- DSCResources\DSC_DnsServerZoneAging\README.md
- DSCResources\DSC_DnsServerClientSubnet\DSC_DnsServerClientSubnet.schema.mof
- DSCResources\DSC_DnsServerClientSubnet\DSC_DnsServerClientSubnet.psm1
- DSCResources\DSC_DnsServerClientSubnet\README.md
- Modules\DnsServerDsc.Common\DnsServerDsc.Common.psd1
- Modules\DnsServerDsc.Common\DnsServerDsc.Common.psm1
- DSCResources\DSC_DnsServerRootHint\en-US\about_DnsServerRootHint.help.txt
- DSCResources\DSC_DnsServerRootHint\en-US\DSC_DnsServerRootHint.strings.psd1
- DSCResources\DSC_DnsServerForwarder\en-US\DSC_DnsServerForwarder.strings.psd1
- DSCResources\DSC_DnsServerForwarder\en-US\about_DnsServerForwarder.help.txt
- DSCResources\DSC_DnsServerDiagnostics\en-US\about_DnsServerDiagnostics.help.txt
- DSCResources\DSC_DnsServerDiagnostics\en-US\DSC_DnsServerDiagnostics.strings.psd1
- DSCResources\DSC_DnsServerSettingLegacy\en-US\DSC_DnsServerSettingLegacy.strings.psd1
- DSCResources\DSC_DnsServerSettingLegacy\en-US\about_DnsServerSettingLegacy.help.txt
- DSCResources\DSC_DnsServerSetting\en-US\about_DnsServerSetting.help.txt
- DSCResources\DSC_DnsServerSetting\en-US\DSC_DnsServerSetting.strings.psd1
- DSCResources\DSC_DnsServerZoneTransfer\en-US\about_DnsServerZoneTransfer.help.txt
- DSCResources\DSC_DnsServerZoneTransfer\en-US\DSC_DnsServerZoneTransfer.strings.psd1
- DSCResources\DSC_DnsServerConditionalForwarder\en-US\DSC_DnsServerConditionalForwarder.strings.psd1
- DSCResources\DSC_DnsServerConditionalForwarder\en-US\about_DnsServerConditionalForwarder.help.txt
- DSCResources\DSC_DnsServerSecondaryZone\en-US\about_DnsServerSecondaryZone.help.txt
- DSCResources\DSC_DnsServerSecondaryZone\en-US\DSC_DnsServerSecondaryZone.strings.psd1
- DSCResources\DSC_DnsServerZoneScope\en-US\about_DnsServerZoneScope.help.txt
- DSCResources\DSC_DnsServerZoneScope\en-US\DSC_DnsServerZoneScope.strings.psd1
- DSCResources\DSC_DnsServerADZone\en-US\DSC_DnsServerADZone.strings.psd1
- DSCResources\DSC_DnsServerADZone\en-US\about_DnsServerADZone.help.txt
- DSCResources\DSC_DnsServerPrimaryZone\en-US\about_DnsServerPrimaryZone.help.txt
- DSCResources\DSC_DnsServerPrimaryZone\en-US\DSC_DnsServerPrimaryZone.strings.psd1
- DSCResources\DSC_DnsServerZoneAging\en-US\DSC_DnsServerZoneAging.strings.psd1
- DSCResources\DSC_DnsServerZoneAging\en-US\about_DnsServerZoneAging.help.txt
- DSCResources\DSC_DnsServerClientSubnet\en-US\about_DnsServerClientSubnet.help.txt
- DSCResources\DSC_DnsServerClientSubnet\en-US\DSC_DnsServerClientSubnet.strings.psd1
- Modules\DnsServerDsc.Common\en-US\DnsServerDsc.Common.strings.psd1
- Modules\DscResource.Common\0.10.2\DscResource.Common.psd1
- Modules\DscResource.Common\0.10.2\DscResource.Common.psm1
- Modules\DscResource.Common\0.10.2\en-US\DscResource.Common.strings.psd1
- Modules\DscResource.Common\0.10.2\en-US\about_DscResource.Common.help.txt
Version History
Version | Downloads | Last updated |
---|---|---|
3.0.1-previe... | 34 | 8/19/2024 |
3.0.1-previe... | 5 | 8/19/2024 |
3.0.1-previe... | 469 | 7/9/2021 |
3.0.1-previe... | 35 | 6/29/2021 |
3.0.0 | 213,099 | 5/26/2021 |
3.0.0-previe... (current version) | 15 | 5/26/2021 |
3.0.0-previe... | 98 | 5/19/2021 |
3.0.0-previe... | 28 | 5/15/2021 |
3.0.0-previe... | 76 | 4/23/2021 |
3.0.0-previe... | 18 | 4/23/2021 |