DnsServerDsc
3.0.0-preview0001
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 DnsRecordSrv DnsServerCache DnsServerEDns DnsServerRecursion DnsServerScavenging DnsRecordAaaaScoped DnsRecordAScoped DnsRecordMxScoped DnsRecordSrvScoped DnsServerADZone DnsServerClientSubnet DnsServerConditionalForwarder DnsServerDiagnostics DnsServerForwarder DnsServerPrimaryZone DnsServerRootHint DnsServerSecondaryZone DnsServerSetting DnsServerZoneAging DnsServerZoneScope DnsServerZoneTransfer
Dependencies
This module has no dependencies.
Release Notes
## [3.0.0-preview0001] - 2021-04-23
### 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.
- 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()`.
### 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_.
FileList
- DnsServerDsc.nuspec
- DnsServerDsc.psd1
- DnsServerDsc.psm1
- en-US\about_DnsServerDsc.help.txt
- en-US\about_DnsRecordAScoped.help.txt
- en-US\about_DnsServerScavenging.help.txt
- en-US\DnsRecordMxScoped.strings.psd1
- en-US\about_DnsRecordSrvScoped.help.txt
- en-US\DnsRecordSrv.strings.psd1
- en-US\about_DnsRecordMx.help.txt
- en-US\about_DnsRecordAaaaScoped.help.txt
- en-US\DnsRecordSrvScoped.strings.psd1
- en-US\DnsRecordMx.strings.psd1
- en-US\DnsRecordCnameScoped.strings.psd1
- en-US\DnsServerDsc.strings.psd1
- en-US\about_DnsRecordPtr.help.txt
- en-US\DnsServerScavenging.strings.psd1
- en-US\DnsRecordAaaa.strings.psd1
- en-US\DnsRecordPtr.strings.psd1
- en-US\about_DnsRecordCname.help.txt
- en-US\about_DnsRecordSrv.help.txt
- en-US\ResourceBase.strings.psd1
- en-US\DnsRecordAaaaScoped.strings.psd1
- en-US\DnsServerCache.strings.psd1
- en-US\DnsServerEDns.strings.psd1
- en-US\about_DnsServerRecursion.help.txt
- en-US\ResourcePropertiesBase.strings.psd1
- en-US\about_DnsRecordCnameScoped.help.txt
- en-US\about_DnsServerCache.help.txt
- en-US\DnsRecordAScoped.strings.psd1
- en-US\DnsServerRecursion.strings.psd1
- en-US\DnsRecordCname.strings.psd1
- en-US\about_DnsRecordMxScoped.help.txt
- en-US\DnsRecordA.strings.psd1
- en-US\DnsRecordBase.strings.psd1
- en-US\about_DnsRecordA.help.txt
- en-US\about_DnsServerEDns.help.txt
- en-US\about_DnsRecordAaaa.help.txt
- DSCResources\DSC_DnsServerForwarder\DSC_DnsServerForwarder.psm1
- DSCResources\DSC_DnsServerForwarder\README.md
- DSCResources\DSC_DnsServerForwarder\DSC_DnsServerForwarder.schema.mof
- DSCResources\DSC_DnsServerPrimaryZone\README.md
- DSCResources\DSC_DnsServerPrimaryZone\DSC_DnsServerPrimaryZone.psm1
- DSCResources\DSC_DnsServerPrimaryZone\DSC_DnsServerPrimaryZone.schema.mof
- DSCResources\DSC_DnsServerClientSubnet\DSC_DnsServerClientSubnet.psm1
- DSCResources\DSC_DnsServerClientSubnet\README.md
- DSCResources\DSC_DnsServerClientSubnet\DSC_DnsServerClientSubnet.schema.mof
- DSCResources\DSC_DnsServerZoneTransfer\DSC_DnsServerZoneTransfer.schema.mof
- DSCResources\DSC_DnsServerZoneTransfer\README.md
- DSCResources\DSC_DnsServerZoneTransfer\DSC_DnsServerZoneTransfer.psm1
- DSCResources\DSC_DnsServerDiagnostics\README.md
- DSCResources\DSC_DnsServerDiagnostics\DSC_DnsServerDiagnostics.schema.mof
- DSCResources\DSC_DnsServerDiagnostics\DSC_DnsServerDiagnostics.psm1
- DSCResources\DSC_DnsServerZoneScope\README.md
- DSCResources\DSC_DnsServerZoneScope\DSC_DnsServerZoneScope.schema.mof
- DSCResources\DSC_DnsServerZoneScope\DSC_DnsServerZoneScope.psm1
- DSCResources\DSC_DnsServerRootHint\DSC_DnsServerRootHint.schema.mof
- DSCResources\DSC_DnsServerRootHint\README.md
- DSCResources\DSC_DnsServerRootHint\DSC_DnsServerRootHint.psm1
- DSCResources\DSC_DnsServerSecondaryZone\DSC_DnsServerSecondaryZone.schema.mof
- DSCResources\DSC_DnsServerSecondaryZone\README.md
- DSCResources\DSC_DnsServerSecondaryZone\DSC_DnsServerSecondaryZone.psm1
- DSCResources\DSC_DnsServerZoneAging\README.md
- DSCResources\DSC_DnsServerZoneAging\DSC_DnsServerZoneAging.schema.mof
- DSCResources\DSC_DnsServerZoneAging\DSC_DnsServerZoneAging.psm1
- DSCResources\DSC_DnsServerSetting\DSC_DnsServerSetting.schema.mof
- DSCResources\DSC_DnsServerSetting\DSC_DnsServerSetting.psm1
- DSCResources\DSC_DnsServerSetting\README.md
- DSCResources\DSC_DnsServerADZone\DSC_DnsServerADZone.schema.mof
- DSCResources\DSC_DnsServerADZone\README.md
- DSCResources\DSC_DnsServerADZone\DSC_DnsServerADZone.psm1
- DSCResources\DSC_DnsServerConditionalForwarder\DSC_DnsServerConditionalForwarder.schema.mof
- DSCResources\DSC_DnsServerConditionalForwarder\DSC_DnsServerConditionalForwarder.psm1
- DSCResources\DSC_DnsServerConditionalForwarder\README.md
- Modules\DnsServerDsc.Common\DnsServerDsc.Common.psd1
- Modules\DnsServerDsc.Common\DnsServerDsc.Common.psm1
- DSCResources\DSC_DnsServerForwarder\en-US\DSC_DnsServerForwarder.strings.psd1
- DSCResources\DSC_DnsServerForwarder\en-US\about_DnsServerForwarder.help.txt
- DSCResources\DSC_DnsServerPrimaryZone\en-US\DSC_DnsServerPrimaryZone.strings.psd1
- DSCResources\DSC_DnsServerPrimaryZone\en-US\about_DnsServerPrimaryZone.help.txt
- DSCResources\DSC_DnsServerClientSubnet\en-US\DSC_DnsServerClientSubnet.strings.psd1
- DSCResources\DSC_DnsServerClientSubnet\en-US\about_DnsServerClientSubnet.help.txt
- DSCResources\DSC_DnsServerZoneTransfer\en-US\DSC_DnsServerZoneTransfer.strings.psd1
- DSCResources\DSC_DnsServerZoneTransfer\en-US\about_DnsServerZoneTransfer.help.txt
- DSCResources\DSC_DnsServerDiagnostics\en-US\about_DnsServerDiagnostics.help.txt
- DSCResources\DSC_DnsServerDiagnostics\en-US\DSC_DnsServerDiagnostics.strings.psd1
- DSCResources\DSC_DnsServerZoneScope\en-US\about_DnsServerZoneScope.help.txt
- DSCResources\DSC_DnsServerZoneScope\en-US\DSC_DnsServerZoneScope.strings.psd1
- DSCResources\DSC_DnsServerRootHint\en-US\about_DnsServerRootHint.help.txt
- DSCResources\DSC_DnsServerRootHint\en-US\DSC_DnsServerRootHint.strings.psd1
- DSCResources\DSC_DnsServerSecondaryZone\en-US\about_DnsServerSecondaryZone.help.txt
- DSCResources\DSC_DnsServerSecondaryZone\en-US\DSC_DnsServerSecondaryZone.strings.psd1
- DSCResources\DSC_DnsServerZoneAging\en-US\about_DnsServerZoneAging.help.txt
- DSCResources\DSC_DnsServerZoneAging\en-US\DSC_DnsServerZoneAging.strings.psd1
- DSCResources\DSC_DnsServerSetting\en-US\about_DnsServerSetting.help.txt
- DSCResources\DSC_DnsServerSetting\en-US\DSC_DnsServerSetting.strings.psd1
- DSCResources\DSC_DnsServerADZone\en-US\about_DnsServerADZone.help.txt
- DSCResources\DSC_DnsServerADZone\en-US\DSC_DnsServerADZone.strings.psd1
- DSCResources\DSC_DnsServerConditionalForwarder\en-US\about_DnsServerConditionalForwarder.help.txt
- DSCResources\DSC_DnsServerConditionalForwarder\en-US\DSC_DnsServerConditionalForwarder.strings.psd1
- Modules\DnsServerDsc.Common\en-US\DnsServerDsc.Common.strings.psd1
- Modules\DscResource.Common\0.10.2\DscResource.Common.psm1
- Modules\DscResource.Common\0.10.2\DscResource.Common.psd1
- Modules\DscResource.Common\0.10.2\en-US\about_DscResource.Common.help.txt
- Modules\DscResource.Common\0.10.2\en-US\DscResource.Common.strings.psd1
Version History
Version | Downloads | Last updated |
---|---|---|
3.0.1-previe... | 31 | 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 | 202,482 | 5/26/2021 |
3.0.0-previe... | 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... (current version) | 18 | 4/23/2021 |