xDnsServer

2.0.0-preview0017

This module contains DSC resources for the management and configuration of Windows Server DNS Server.

Minimum PowerShell version

5.0

This is a prerelease version of xDnsServer.
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 xDnsServer -RequiredVersion 2.0.0-preview0017 -AllowPrerelease

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

Install-PSResource -Name xDnsServer -Version 2.0.0-preview0017 -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

DSCResources

DnsRecordSrv DnsRecordSrvScoped xDnsRecord xDnsRecordMx xDnsServerADZone xDnsServerClientSubnet xDnsServerConditionalForwarder xDnsServerDiagnostics xDnsServerForwarder xDnsServerPrimaryZone xDnsServerRootHint xDnsServerSecondaryZone xDnsServerSetting xDnsServerZoneAging xDnsServerZoneScope xDnsServerZoneTransfer DnsRecordCname DnsRecordPtr DnsRecordA DnsRecordAaaa DnsRecordCnameScoped DnsRecordMx DnsServerScavenging DnsRecordAaaaScoped DnsRecordAScoped DnsRecordMxScoped

Dependencies

This module has no dependencies.

Release Notes

## [2.0.0-preview0017] - 2021-03-26

### Deprecated

- **The module _xDnsServer_ will be renamed _DnsServerDsc_. Version `2.0.0`
 will be the the last release of _xDnsServer_. Version `3.0.0` will be
 release as _DnsServerDsc_, it will be released shortly after the `2.0.0`
 release** ([issue #179](https://github.com/dsccommunity/xDnsServer/issues/179)).
 The prefix 'x' will be removed from all resources in _DnsServerDsc_.
- xDnsRecord will be removed in the next release (of DnsServerDsc) ([issue #220](https://github.com/dsccommunity/xDnsServer/issues/220)).
 Start migrate to the resources _DnsRecord*_.
- xDnsRecordMx will be removed in the next release (of DnsServerDsc) ([issue #228](https://github.com/dsccommunity/xDnsServer/issues/228)).
 Start migrate to the resources _DnsRecordMx_.
- The properties `DefaultAgingState`, `ScavengingInterval`, `DefaultNoRefreshInterval`,
 and `DefaultRefreshInterval` will be removed from the resource xDnsServerSetting
 in the next release (of DnsServerDsc).
 Migrate to use the resource _DnsServerScavenging_ to enforce these properties.

### Added

- xDnsServer
 - Added automatic release with a new CI pipeline.
 - Add unit tests for the Get-LocalizedData, NewTerminatingError, and
   Assert-Module helper functions.
 - Added description README files for each resource.
 - Add example files for resources
 - OptIn to the following Dsc Resource Meta Tests:
   - Common Tests - Validate Localization
   - Common Tests - Validate Example Files To Be Published
 - Standardize Resource Localization.
 - Added the build task `Publish_GitHub_Wiki_Content` to publish content
   to the GitHub repository wiki.
 - Added new source folder `WikiSource` which content will be published
   to the GitHub repository wiki.
   - Add the markdown file `Home.md` which will be automatically updated
     with the latest version before published to GitHub repository wiki.
 - Updated the prerequisites in the GitHub repository wiki (`Home.md`)
   that _Microsoft DNS Server_ is required on a node targeted by a resource,
   and that the DSC resources requires the [DnsServer](https://docs.microsoft.com/en-us/powershell/module/dnsserver)
   PowerShell module ([issue #37](https://github.com/dsccommunity/xDnsServer/issues/37)).
 - Added the base class `ResourcePropertiesBase` to hold DSC properties that
   can be inherited for all class-based resources.
 - Added the base class `ResourceBase` to hold methods that should be
   inherited for all class-based resources.
 - Added new private function `ConvertTo-TimeSpan` to help when evaluating
   properties that must be passed as strings and then converted to `[System.TimeSpan]`.
 - Added `prefix.ps1` that is used to import dependent modules like _DscResource.Common_.
 - Added new resource
   - _DnsServerScavenging_ - resource to enforce scavenging settings ([issue #189](https://github.com/dsccommunity/xDnsServer/issues/189)).
- xDNSServerClientSubnet
 - Added integration tests.
- xDnsServerPrimaryZone
 - Added integration tests ([issue #173](https://github.com/dsccommunity/xDnsServer/issues/173)).
 - Added more examples.
- xDnsRecordMx
 - Added new resource to manage MX records
- xDnsServerZoneScope
 - Added integration tests ([issue #177](https://github.com/dsccommunity/xDnsServer/issues/177)).
 - New read-only property `ZoneFile` was added to return the zone scope
   file name used for the zone scope.
- xDnsServerZoneAging
 - Added integration tests ([issue #176](https://github.com/dsccommunity/xDnsServer/issues/176)).
- xDnsServerForwarder
 - Added integration tests ([issue #170](https://github.com/dsccommunity/xDnsServer/issues/170)).
- xDnsServerRootHint
 - Added integration tests ([issue #174](https://github.com/dsccommunity/xDnsServer/issues/174)).
- Added a class `DnsRecordBase` that is used as the base class for the resources that create DNS records.
 - Added unit tests to get code coverage on unimplemented method calls (ensuring the `throw` statements get called)
- DnsRecordSrv
 - Added new resource to manage SRV records
- DnsRecordSrvScoped
 - Added new resource to manage scoped SRV records
- DnsRecordA
 - Added new resource to manage A records
- DnsRecordAScoped
 - Added new resource to manage scoped A records
- DnsRecordAaaa
 - Added new resource to manage AAAA records
- DnsRecordAaaaScoped
 - Added new resource to manage scoped AAAA records
- DnsRecordCname
 - Added new resource to manage CNAME records
- DnsRecordCnameScoped
 - Added new resource to manage scoped CNAME records
- DnsRecordPtr
 - Added new resource to manage PTR records
- DnsRecordMx
 - Added new resource to manage MX records
- DnsRecordMxScoped
 - Added new resource to manage scoped MX records

### Changed

- xDnsServer
 - BREAKING CHANGE: Set the minimum required PowerShell version to 5.0 to support classes used in the DnsRecordBase-derived resources.
 - Resolve style guideline violations for hashtables
 - Update pipeline files.
 - Renamed the default branch to `main` ([issue #131](https://github.com/dsccommunity/xDnsServer/issues/131)).
 - Uses `PublishPipelineArtifact` in  _Azure Pipelines_ pipeline.
 - Unit tests are now run in PowerShell 7 in the _Azure Pipelines_
   pipeline ([issue #160](https://github.com/dsccommunity/xDnsServer/issues/160)).
 - Merged the historic changelog into CHANGELOG.md ([issue #163](https://github.com/dsccommunity/xDnsServer/issues/163)).
 - Only add required role in integration tests pipeline.
 - Updated the pipeline to use new deploy tasks.
 - Revert back to using the latest version of module Sampler for the pipeline ([issue #211](https://github.com/dsccommunity/xDnsServer/issues/211)).
 - Fixed the sections in the GitHub issue and pull request templates to
   have a bit higher font size. This makes it easier to distinguish the
   section headers from the text.
- DnsRecordBase
 - Changed class to inherit properties from 'ResourcePropertiesBase`.
- xDnsRecordSrv
 - Now uses `[CimInstance]::new()` both in the resource code and the resource
   unit test to clone the existing DNS record instead of using the method
   `Clone()` that does not exist in PowerShell 7.
- xDnsServerSetting
 - BREAKING CHANGE: The mandatory parameter was replaced by the mandatory
   parameter `DnsServer`. This prevents the resource from being used twice
   in the same configuration using the same value for the parameter `DnsServer`
   ([issue #156](https://github.com/dsccommunity/xDnsServer/issues/156)).
- xDnsServerDiagnostics
 - BREAKING CHANGE: The mandatory parameter was replaced by the mandatory
   parameter `DnsServer`. This prevents the resource from being used twice
   in the same configuration using the same value for the parameter `DnsServer`
   ([issue #157](https://github.com/dsccommunity/xDnsServer/issues/157)).
- xDnsServerPrimaryZone
 - Now the property `Name` is always returned from `Get-TargetResource`
   since it is a `Key` property.
- xDnsServerForwarder
 - When providing an empty collection the resource will enforce that no
   forwarders are present.
- DnsRecordSrv
 - Changed logic for calculating the record's hostname

### Removed

- xDnsServer
 - BREAKING CHANGE: The DSC resource xDnsARecord was removed and are replaced
   by the DSC resource xDnsRecord.
 - Removing resource parameter information from README.md in favor of
   GitHub repository wiki.
 - Remove helper function `Remove-CommonParameter` in favor of the one in
   module _DscResource.Common_ ([issue #166](https://github.com/dsccommunity/xDnsServer/issues/166)).
 - Remove helper function `ConvertTo-CimInstance` in favor of the one in
   module _DscResource.Common_ ([issue #167](https://github.com/dsccommunity/xDnsServer/issues/167)).
 - Remove helper function `ConvertTo-HashTable` in favor of the one in
   module _DscResource.Common_ ([issue #168](https://github.com/dsccommunity/xDnsServer/issues/168)).
- xDnServerSetting
 - BREAKING CHANGE: The properties `LogIPFilterList`, `LogFilePath`, `LogFileMaxSize`,
   and `EventLogLevel` have been removed. Use the resource _xDnsServerDiagnostics_
   with the properties `FilterIPAddressList`, `LogFilePath`, `MaxMBFileSize`,
   and `EventLogLevel` respectively to enforce these settings ([issue #190](https://github.com/dsccommunity/xDnsServer/issues/190)).
   This is done in preparation to support more settings through the cmdlet
   `Get-DnsServerSetting` for the resource _xDnServerSetting_, and these
   values are not available through that cmdlet.

### Fixed

- xDnsServer
 - Enable Unit Tests to be run locally.
 - Rename integration tests so they are run in the pipeline ([issue #134](https://github.com/dsccommunity/xDnsServer/issues/134)).
 - Added back the build task to create releases on GitHub.
 - Fixed property descriptions in schema throughout.
 - Fixed uploading of code coverage that was broken since Sampler had a bug.
 - Fixed examples so the license information point to the correct default branch.
 - Fixed a link in the README.md.
- DnsRecordBase
 - Fixed so that `Compare-DscParameterState` is used in the method `Test()`
   if the record already exist, to compare the properties except `Ensure`
   in the desired state against the actual state ([issue #205](https://github.com/dsccommunity/xDnsServer/issues/205)).
- xDnsServerDiagnostics
 - Fix EnableLogFileRollover Parameter name in README.
- xDnsRecord
 - Fix "Removing a DNS A Record" example.
- xDnsServerDiagnostics
 - Fixed typo in parameter `EnableLogFileRollover`.
 - Updated integration test to correct template.
- xDnsServerSettings
 - Updated integration test to correct template.
- xDnsServerAdZone
 - Now the parameter `ComputerName` can be used without throwing an exception
   ([issue 79](https://github.

FileList

Version History

Version Downloads Last updated
2.0.0 2,292,598 3/26/2021
2.0.0-previe... 20 3/26/2021
2.0.0-previe... (current version) 20 3/26/2021
2.0.0-previe... 22 3/23/2021
2.0.0-previe... 17 3/23/2021
2.0.0-previe... 40 2/28/2021
2.0.0-previe... 17 2/28/2021
2.0.0-previe... 17 2/28/2021
2.0.0-previe... 22 2/20/2021
2.0.0-previe... 17 2/20/2021
2.0.0-previe... 17 2/20/2021
2.0.0-previe... 22 2/17/2021
2.0.0-previe... 19 2/17/2021
2.0.0-previe... 20 2/16/2021
2.0.0-previe... 31 1/30/2021
2.0.0-previe... 161 3/14/2020
1.16.0.0 1,022,763 10/30/2019
1.15.0.0 24,627 9/19/2019
1.14.0.0 13,203 8/8/2019
1.13.0.0 14,465 6/26/2019
1.12.0.0 16,872 5/15/2019
1.11.0.0 84,898 6/13/2018
1.10.0.0 3,118 5/2/2018
1.9.0.0 15,862 11/15/2017
1.8.0.0 1,771 8/23/2017
1.7.0.0 29,024 5/18/2016
1.6.0.0 557 3/31/2016
1.5.0.0 574 2/3/2016
1.4.0.0 260 12/3/2015
1.3.0.0 205 10/22/2015
1.2.0.0 772 9/11/2015
1.1 378 5/2/2015
1.0 254 6/6/2014
Show more