Documentation
Table of Contents
Description
This is an auto-generated module, using the Puppet DSC Builder to vendor and expose the PowerShell module's DSC resources as Puppet resources. The functionality of this module comes entirely from the vendored PowerShell resources, which are pinned at v1.16.0.0. The PowerShell module describes itself like this:
Module with DSC Resources for DNS Server area
For information on troubleshooting to determine whether any encountered problems are with the Puppet wrapper or the DSC resource, see the troubleshooting section below.
Requirements
This module, like all auto-generated Puppetized DSC modules, relies on two important technologies in the Puppet stack: the Puppet Resource API and the puppetlabs/pwshlib Puppet module.
The Resource API provides a simplified option for writing types and providers and is responsible for how this module is structured. The Resource API ships inside of Puppet starting with version 6. While it is technically possible to add the Resource API functionality to Puppet 5.5.x, the DSC functionality has not been tested in this setup. For more information on the Resource API, review the documentation.
The module also depends on the pwshlib module. This Puppet module includes two important things: the ruby-pwsh library for running PowerShell code from ruby and the base provider for DSC resources, which this module leverages.
All of the actual work being done to call the DSC resources vendored with this module is in this file from the pwshlib module. This is important for troubleshooting and bug reporting, but doesn't impact your use of the module except that the end result will be that nothing works, as the dependency is not installed alongside this module!
Usage
You can specify any of the DSC resources from this module like a normal Puppet resource in your manifests. The examples below use DSC resources from from the PowerShellGet repository, regardless of what module you're looking at here; the syntax, not the specifics, is what's important.
For reference documentation about the DSC resources exposed in this module, see the Reference Forge tab, or the REFERENCE.md file.
# Include a meaningful title for your resource declaration
dsc_psrepository { 'Add team module repo':
dsc_name => 'foo',
dsc_ensure => present,
# This location is nonsense, can be any valid folder on your
# machine or in a share, any location the SourceLocation param
# for the DSC resource will accept.
dsc_sourcelocation => 'C:\Program Files',
# You must always pass an enum fully lower-cased;
# Puppet is case sensitive even when PowerShell isn't
dsc_installationpolicy => untrusted,
}
dsc_psrepository { 'Trust public gallery':
dsc_name => 'PSGallery',
dsc_ensure => present,
dsc_installationpolicy => trusted,
}
dsc_psmodule { 'Make Ruby manageable via uru':
dsc_name => 'RubyInstaller',
dsc_ensure => present,
}
For more information about using a built module, check out our narrative documentation.
Properties
Note that the only properties specified in a resource declaration which are passed to Invoke-Dsc are all prepended with dsc.
If a property does _not start with dsc_ it is used to control how Puppet interacts with DSC/other Puppet resources - for example,
specifying a unique name for the resource for Puppet to distinguish between declarations or Puppet metaparameters (notifies,
before, etc).
Troubleshooting
In general, there are three broad categories of problems:
- Problems with the way the underlying DSC resource works.
- Problems with the type definition, where you can't specify a valid set of properties for the DSC resource
- Problems with calling the underlying DSC resource - the parameters aren't being passed correctly or the resource can't be found
Unfortunately, problems with the way the underlying DSC resource works are something we can't help directly with. You'll need to file an issue with the upstream maintainers for the PowerShell module.
Problems with the type definition are when a value that should be valid according to the DSC resource's documentation and code is not accepted by the Puppet wrapper. If and when you run across one of these, please file an issue with the Puppet DSC Builder; this is where the conversion happens and once we know of a problem we can fix it and regenerate the Puppet modules. To help us identify the issue, please specify the DSC module, version, resource, property and values that are giving you issues. Once a fix is available we will regenerate and release updated versions of this Puppet wrapper.
Problems with calling the underlying DSC resource become apparent by comparing <value passed in in puppet>
with <value received by DSC>
.
In this case, please file an issue with the puppetlabs/pwshlib module, which is where the DSC base provider actually lives.
We'll investigate and prioritize a fix and update the puppetlabs/pwshlib module.
Updating to the pwshlib version with the fix will immediately take advantage of the improved functionality without waiting for this module to be reconverted and published.
For specific information on troubleshooting a generated module, check the troubleshooting guide for the puppet.dsc module.
Known Limitations
Currently, because of the way Puppet caches files on agents, use of the legacy puppetlabs-dsc
module is not compatible with this or any auto-generated DSC module.
Inclusion of both will lead to pluginsync conflicts.
Reference
Table of Contents
Resource types
dsc_xdnsarecord
: The DSC xDnsARecord resource type. Automatically generated from version 1.16.0.0dsc_xdnsrecord
: The DSC xDnsRecord resource type. Automatically generated from version 1.16.0.0dsc_xdnsserveradzone
: The DSC xDnsServerADZone resource type. Automatically generated from version 1.16.0.0dsc_xdnsserverclientsubnet
: The DSC xDnsServerClientSubnet resource type. Automatically generated from version 1.16.0.0dsc_xdnsserverconditionalforwarder
: The DSC xDnsServerConditionalForwarder resource type. Automatically generated from version 1.16.0.0dsc_xdnsserverdiagnostics
: The DSC xDnsServerDiagnostics resource type. Automatically generated from version 1.16.0.0dsc_xdnsserverforwarder
: The DSC xDnsServerForwarder resource type. Automatically generated from version 1.16.0.0dsc_xdnsserverprimaryzone
: The DSC xDnsServerPrimaryZone resource type. Automatically generated from version 1.16.0.0dsc_xdnsserverroothint
: The DSC xDnsServerRootHint resource type. Automatically generated from version 1.16.0.0dsc_xdnsserversecondaryzone
: The DSC xDnsServerSecondaryZone resource type. Automatically generated from version 1.16.0.0dsc_xdnsserversetting
: The DSC xDnsServerSetting resource type. Automatically generated from version 1.16.0.0dsc_xdnsserverzoneaging
: The DSC xDnsServerZoneAging resource type. Automatically generated from version 1.16.0.0dsc_xdnsserverzonescope
: The DSC xDnsServerZoneScope resource type. Automatically generated from version 1.16.0.0dsc_xdnsserverzonetransfer
: The DSC xDnsServerZoneTransfer resource type. Automatically generated from version 1.16.0.0
Resource types
dsc_xdnsarecord
The DSC xDnsARecord resource type. Automatically generated from version 1.16.0.0
Properties
The following properties are available in the dsc_xdnsarecord
type.
dsc_ensure
Data type: Optional[Enum['Present', 'Absent']]
Should this DNS resource record be present or absent
dsc_target
Data type: String
Parameters
The following parameters are available in the dsc_xdnsarecord
type.
dsc_name
namevar
Data type: String
dsc_psdscrunascredential
Data type: Optional[Struct[{ user => String[1], password => Sensitive[String[1]] }]]
dsc_zone
namevar
Data type: String
name
namevar
Data type: String
Description of the purpose for this resource declaration.
dsc_xdnsrecord
The DSC xDnsRecord resource type. Automatically generated from version 1.16.0.0
Properties
The following properties are available in the dsc_xdnsrecord
type.
dsc_ensure
Data type: Optional[Enum['Present', 'Absent']]
Should this DNS resource record be present or absent
dsc_type
Data type: Enum['ARecord', 'CName']
Parameters
The following parameters are available in the dsc_xdnsrecord
type.
dsc_name
namevar
Data type: String
dsc_psdscrunascredential
Data type: Optional[Struct[{ user => String[1], password => Sensitive[String[1]] }]]
dsc_target
namevar
Data type: String
dsc_zone
namevar
Data type: String
name
namevar
Data type: String
Description of the purpose for this resource declaration.
dsc_xdnsserveradzone
The DSC xDnsServerADZone resource type. Automatically generated from version 1.16.0.0
Properties
The following properties are available in the dsc_xdnsserveradzone
type.
dsc_computername
Data type: Optional[String]
DNS Server name
dsc_directorypartitionname
Data type: Optional[String]
Directory partition name
dsc_dynamicupdate
Data type: Optional[Enum['None', 'NonsecureAndSecure', 'Secure']]
Dynamic zone update option
dsc_ensure
Data type: Optional[Enum['Present', 'Absent']]
Whether the DNS zone should be available or removed
dsc_replicationscope
Data type: Enum['Custom', 'Domain', 'Forest', 'Legacy']
Replication scope option
Parameters
The following parameters are available in the dsc_xdnsserveradzone
type.
dsc_credential
Data type: Optional[Struct[{ user => String[1], password => Sensitive[String[1]] }]]
Credential used to set zone
dsc_name
namevar
Data type: String
DNS Server zone name
dsc_psdscrunascredential
Data type: Optional[Struct[{ user => String[1], password => Sensitive[String[1]] }]]
name
namevar
Data type: String
Description of the purpose for this resource declaration.
dsc_xdnsserverclientsubnet
The DSC xDnsServerClientSubnet resource type. Automatically generated from version 1.16.0.0
Properties
The following properties are available in the dsc_xdnsserverclientsubnet
type.
dsc_ensure
Data type: Optional[Enum['Present', 'Absent']]
Should this DNS server client subnet be present or absent
dsc_ipv4subnet
Data type: Optional[Array[String]]
Specify an array (1 or more values) of IPv4 Subnet addresses in CIDR Notation.
dsc_ipv6subnet
Data type: Optional[Array[String]]
Specify an array (1 or more values) of IPv6 Subnet addresses in CIDR Notation.
Parameters
The following parameters are available in the dsc_xdnsserverclientsubnet
type.
dsc_name
namevar
Data type: String
Specifies the name of the client subnet.
dsc_psdscrunascredential
Data type: Optional[Struct[{ user => String[1], password => Sensitive[String[1]] }]]
name
namevar
Data type: String
Description of the purpose for this resource declaration.
dsc_xdnsserverconditionalforwarder
The DSC xDnsServerConditionalForwarder resource type. Automatically generated from version 1.16.0.0
Properties
The following properties are available in the dsc_xdnsserverconditionalforwarder
type.
dsc_directorypartitionname
Data type: Optional[String]
The name of the directory partition to use when the ReplicationScope is Custom. This value is ignored for all other replication scopes.
dsc_ensure
Data type: Optional[Enum['Present', 'Absent']]
Ensure whether the zone is absent or present.
dsc_masterservers
Data type: Optional[Array[String]]
The IP addresses the forwarder should use. Mandatory if Ensure is present.
dsc_replicationscope
Data type: Optional[Enum['None', 'Custom', 'Domain', 'Forest', 'Legacy']]
Whether the conditional forwarder should be replicated in AD, and the scope of that replication. Default is None.
dsc_zonetype
Data type: Optional[String]
The zone type
Parameters
The following parameters are available in the dsc_xdnsserverconditionalforwarder
type.
dsc_name
namevar
Data type: String
The name of the zone to manage.
dsc_psdscrunascredential
Data type: Optional[Struct[{ user => String[1], password => Sensitive[String[1]] }]]
name
namevar
Data type: String
Description of the purpose for this resource declaration.
dsc_xdnsserverdiagnostics
The DSC xDnsServerDiagnostics resource type. Automatically generated from version 1.16.0.0
Properties
The following properties are available in the dsc_xdnsserverdiagnostics
type.
dsc_answers
Data type: Optional[Boolean]
Specifies whether to enable the logging of DNS responses.
dsc_enablelogfilerollover
Data type: Optional[Boolean]
Specifies whether to enable log file rollover.
dsc_enableloggingforlocallookupevent
Data type: Optional[Boolean]
Specifies whether the DNS server logs local lookup events.
dsc_enableloggingforplugindllevent
Data type: Optional[Boolean]
Specifies whether the DNS server logs dynamic link library (DLL) plug-in events.
dsc_enableloggingforrecursivelookupevent
Data type: Optional[Boolean]
Specifies whether the DNS server logs recursive lookup events.
dsc_enableloggingforremoteserverevent
Data type: Optional[Boolean]
Specifies whether the DNS server logs remote server events.
dsc_enableloggingforserverstartstopevent
Data type: Optional[Boolean]
Specifies whether the DNS server logs server start and stop events.
dsc_enableloggingfortombstoneevent
Data type: Optional[Boolean]
Specifies whether the DNS server logs tombstone events.
dsc_enableloggingforzonedatawriteevent
Data type: Optional[Boolean]
Specifies Controls whether the DNS server logs zone data write events.
dsc_enableloggingforzoneloadingevent
Data type: Optional[Boolean]
Specifies whether the DNS server logs zone load events.
dsc_enableloggingtofile
Data type: Optional[Boolean]
Specifies whether the DNS server logs logging-to-file.
dsc_eventloglevel
Data type: Optional[Integer[0, 4294967295]]
Specifies an event log level. Valid values are Warning, Error, and None.
dsc_filteripaddresslist
Data type: Optional[Array[String]]
Specifies an array of IP addresses to filter. When you enable logging, traffic to and from these IP addresses is logged. If you do not specify any IP addresses, traffic to and from all IP addresses is logged.
dsc_fullpackets
Data type: Optional[Boolean]
Specifies whether the DNS server logs full packets.
dsc_logfilepath
Data type: Optional[String]
Specifies a log file path.
dsc_maxmbfilesize
Data type: Optional[Integer[0, 4294967295]]
Specifies the maximum size of the log file. This parameter is relevant if you set EnableLogFileRollover and EnableLoggingToFile to $True.
dsc_notifications
Data type: Optional[Boolean]
Specifies whether the DNS server logs notifications.
dsc_queries
Data type: Optional[Boolean]
Specifies whether the DNS server allows query packet exchanges to pass through the content filter, such as the IPFilterList parameter.
dsc_questiontransactions
Data type: Optional[Boolean]
Specifies whether the DNS server logs queries.
dsc_receivepackets
Data type: Optional[Boolean]
Specifies whether the DNS server logs receive packets.
dsc_savelogstopersistentstorage
Data type: Optional[Boolean]
Specifies whether the DNS server saves logs to persistent storage.
dsc_sendpackets
Data type: Optional[Boolean]
Specifies whether the DNS server logs send packets.
dsc_tcppackets
Data type: Optional[Boolean]
Specifies whether the DNS server logs TCP packets.
dsc_udppackets
Data type: Optional[Boolean]
Specifies whether the DNS server logs UDP packets.
dsc_unmatchedresponse
Data type: Optional[Boolean]
Specifies whether the DNS server logs unmatched responses.
dsc_update
Data type: Optional[Boolean]
Specifies whether the DNS server logs updates.
dsc_usesystemeventlog
Data type: Optional[Boolean]
Specifies whether the DNS server uses the system event log for logging.
dsc_writethrough
Data type: Optional[Boolean]
Specifies whether the DNS server logs write-throughs.
Parameters
The following parameters are available in the dsc_xdnsserverdiagnostics
type.
dsc_name
namevar
Data type: String
Key for the resource. It doesn't matter what it is as long as it's unique within the configuration.
dsc_psdscrunascredential
Data type: Optional[Struct[{ user => String[1], password => Sensitive[String[1]] }]]
name
namevar
Data type: String
Description of the purpose for this resource declaration.
dsc_xdnsserverforwarder
The DSC xDnsServerForwarder resource type. Automatically generated from version 1.16.0.0
Properties
The following properties are available in the dsc_xdnsserverforwarder
type.
dsc_ipaddresses
Data type: Optional[Array[String]]
dsc_useroothint
Data type: Optional[Boolean]
Validate if you want to use root hint on DNS Server.
Parameters
The following parameters are available in the dsc_xdnsserverforwarder
type.
dsc_issingleinstance
namevar
Data type: Enum['Yes']
Specifies the resource is a single instance, the value must be 'Yes'
dsc_psdscrunascredential
Data type: Optional[Struct[{ user => String[1], password => Sensitive[String[1]] }]]
name
namevar
Data type: String
Description of the purpose for this resource declaration.
dsc_xdnsserverprimaryzone
The DSC xDnsServerPrimaryZone resource type. Automatically generated from version 1.16.0.0
Properties
The following properties are available in the dsc_xdnsserverprimaryzone
type.
dsc_dynamicupdate
Data type: Optional[Enum['None', 'NonsecureAndSecure']]
Dynamic zone update option
dsc_ensure
Data type: Optional[Enum['Present', 'Absent']]
Whether the DNS zone should be available or removed
dsc_zonefile
Data type: Optional[String]
DNS Server primary zone file
Parameters
The following parameters are available in the dsc_xdnsserverprimaryzone
type.
dsc_name
namevar
Data type: String
DNS Server primary zone name
dsc_psdscrunascredential
Data type: Optional[Struct[{ user => String[1], password => Sensitive[String[1]] }]]
name
namevar
Data type: String
Description of the purpose for this resource declaration.
dsc_xdnsserverroothint
The DSC xDnsServerRootHint resource type. Automatically generated from version 1.16.0.0
Properties
The following properties are available in the dsc_xdnsserverroothint
type.
dsc_nameserver
Data type: Array[Struct[{ key => Optional[String], value => Optional[String], }]]
Parameters
The following parameters are available in the dsc_xdnsserverroothint
type.
dsc_issingleinstance
namevar
Data type: Enum['Yes']
Specifies the resource is a single instance, the value must be 'Yes'
dsc_psdscrunascredential
Data type: Optional[Struct[{ user => String[1], password => Sensitive[String[1]] }]]
name
namevar
Data type: String
Description of the purpose for this resource declaration.
dsc_xdnsserversecondaryzone
The DSC xDnsServerSecondaryZone resource type. Automatically generated from version 1.16.0.0
Properties
The following properties are available in the dsc_xdnsserversecondaryzone
type.
dsc_ensure
Data type: Optional[Enum['Present', 'Absent']]
Should this resource be present or absent
dsc_masterservers
Data type: Array[String]
IP address or DNS name of the secondary DNS servers
dsc_type
Data type: Optional[String]
Type of the DNS server zone
Parameters
The following parameters are available in the dsc_xdnsserversecondaryzone
type.
dsc_name
namevar
Data type: String
Name of the secondary zone
dsc_psdscrunascredential
Data type: Optional[Struct[{ user => String[1], password => Sensitive[String[1]] }]]
name
namevar
Data type: String
Description of the purpose for this resource declaration.
dsc_xdnsserversetting
The DSC xDnsServerSetting resource type. Automatically generated from version 1.16.0.0
Properties
The following properties are available in the dsc_xdnsserversetting
type.
dsc_addressanswerlimit
Data type: Optional[Integer[0, 4294967295]]
Maximum number of host records returned in response to an address request. Values between 5 and 28 are valid.
dsc_allowupdate
Data type: Optional[Integer[0, 4294967295]]
Specifies whether the DNS Server accepts dynamic update requests.
dsc_autocacheupdate
Data type: Optional[Boolean]
Indicates whether the DNS Server attempts to update its cache entries using data from root servers.
dsc_autoconfigfilezones
Data type: Optional[Integer[0, 4294967295]]
Indicates which standard primary zones that are authoritative for the name of the DNS Server must be updated when the name server changes.
dsc_bindsecondaries
Data type: Optional[Boolean]
Determines the AXFR message format when sending to non-Microsoft DNS Server secondaries
dsc_bootmethod
Data type: Optional[Integer[0, 4294967295]]
Initialization method for the DNS Server.
dsc_defaultagingstate
Data type: Optional[Boolean]
Default ScavengingInterval value set for all Active Directory-integrated zones created on this DNS Server.
dsc_defaultnorefreshinterval
Data type: Optional[Integer[0, 4294967295]]
No-refresh interval, in hours, set for all Active Directory-integrated zones created on this DNS Server.
dsc_defaultrefreshinterval
Data type: Optional[Integer[0, 4294967295]]
Refresh interval, in hours, set for all Active Directory-integrated zones created on this DNS Server.
dsc_disableautoreversezones
Data type: Optional[Boolean]
Indicates whether the DNS Server automatically creates standard reverse look up zones.
dsc_disjointnets
Data type: Optional[Boolean]
Indicates whether the default port binding for a socket used to send queries to remote DNS Servers can be overridden.
dsc_dsavailable
Data type: Optional[Boolean]
Indicates whether there is an available DS on the DNS Server.
dsc_dspollinginterval
Data type: Optional[Integer[0, 4294967295]]
Interval, in seconds, to poll the DS-integrated zones.
dsc_dstombstoneinterval
Data type: Optional[Integer[0, 4294967295]]
Lifetime of tombstoned records in Directory Service integrated zones, expressed in seconds.
dsc_ednscachetimeout
Data type: Optional[Integer[0, 4294967295]]
Lifetime, in seconds, of the cached information describing the EDNS version supported by other DNS Servers.
dsc_enabledirectorypartitions
Data type: Optional[Boolean]
Specifies whether support for application directory partitions is enabled on the DNS Server.
dsc_enablednssec
Data type: Optional[Integer[0, 4294967295]]
Specifies whether the DNS Server includes DNSSEC-specific RRs, KEY, SIG, and NXT in a response.
dsc_enableednsprobes
Data type: Optional[Boolean]
Specifies the behavior of the DNS Server. When TRUE, the DNS Server always responds with OPT resource records according to RFC 2671, unless the remote server has indicated it does not support EDNS in a prior exchange. If FALSE, the DNS Server responds to queries with OPTs only if OPTs are sent in the original query.
dsc_eventloglevel
Data type: Optional[Integer[0, 4294967295]]
Indicates which events the DNS Server records in the Event Viewer system log.
dsc_forwarddelegations
Data type: Optional[Integer[0, 4294967295]]
Specifies whether queries to delegated sub-zones are forwarded.
dsc_forwarders
Data type: Optional[Array[String]]
Enumerates the list of IP addresses of Forwarders to which the DNS Server forwards queries.
dsc_forwardingtimeout
Data type: Optional[Integer[0, 4294967295]]
Time, in seconds, a DNS Server forwarding a query will wait for resolution from the forwarder before attempting to resolve the query itself.
dsc_isslave
Data type: Optional[Boolean]
TRUE if the DNS server does not use recursion when name-resolution through forwarders fails.
dsc_listenaddresses
Data type: Optional[Array[String]]
Enumerates the list of IP addresses on which the DNS Server can receive queries.
dsc_localnetpriority
Data type: Optional[Boolean]
Indicates whether the DNS Server gives priority to the local net address when returning A records.
dsc_logfilemaxsize
Data type: Optional[Integer[0, 4294967295]]
Size of the DNS Server debug log, in bytes.
dsc_logfilepath
Data type: Optional[String]
File name and path for the DNS Server debug log.
dsc_logipfilterlist
Data type: Optional[Array[String]]
List of IP addresses used to filter DNS events written to the debug log.
dsc_loglevel
Data type: Optional[Integer[0, 4294967295]]
Indicates which policies are activated in the Event Viewer system log.
dsc_loosewildcarding
Data type: Optional[Boolean]
Indicates whether the DNS Server performs loose wildcarding.
dsc_maxcachettl
Data type: Optional[Integer[0, 4294967295]]
Maximum time, in seconds, the record of a recursive name query may remain in the DNS Server cache.
dsc_maxnegativecachettl
Data type: Optional[Integer[0, 4294967295]]
Maximum time, in seconds, a name error result from a recursive query may remain in the DNS Server cache.
dsc_namecheckflag
Data type: Optional[Integer[0, 4294967295]]
Indicates the set of eligible characters to be used in DNS names.
dsc_norecursion
Data type: Optional[Boolean]
Indicates whether the DNS Server performs recursive look ups. TRUE indicates recursive look ups are not performed.
dsc_recursionretry
Data type: Optional[Integer[0, 4294967295]]
Elapsed seconds before retrying a recursive look up.
dsc_recursiontimeout
Data type: Optional[Integer[0, 4294967295]]
Elapsed seconds before the DNS Server gives up recursive query.
dsc_roundrobin
Data type: Optional[Boolean]
Indicates whether the DNS Server round robins multiple A records.
dsc_rpcprotocol
Data type: Optional[Integer[-32768, 32767]]
RPC protocol or protocols over which administrative RPC runs.
dsc_scavenginginterval
Data type: Optional[Integer[0, 4294967295]]
Interval, in hours, between two consecutive scavenging operations performed by the DNS Server.
dsc_secureresponses
Data type: Optional[Boolean]
Indicates whether the DNS Server exclusively saves records of names in the same subtree as the server that provided them.
dsc_sendport
Data type: Optional[Integer[0, 4294967295]]
Port on which the DNS Server sends UDP queries to other servers.
dsc_strictfileparsing
Data type: Optional[Boolean]
Indicates whether the DNS Server parses zone files strictly.
dsc_updateoptions
Data type: Optional[Integer[0, 4294967295]]
Restricts the type of records that can be dynamically updated on the server, used in addition to the AllowUpdate settings on Server and Zone objects.
dsc_writeauthorityns
Data type: Optional[Boolean]
Specifies whether the DNS Server writes NS and SOA records to the authority section on successful response.
dsc_xfrconnecttimeout
Data type: Optional[Integer[0, 4294967295]]
Time, in seconds, the DNS Server waits for a successful TCP connection to a remote server when attempting a zone transfer.
Parameters
The following parameters are available in the dsc_xdnsserversetting
type.
dsc_name
namevar
Data type: String
Key for the resource. It doesn't matter what it is as long as it's unique within the configuration.
dsc_psdscrunascredential
Data type: Optional[Struct[{ user => String[1], password => Sensitive[String[1]] }]]
name
namevar
Data type: String
Description of the purpose for this resource declaration.
dsc_xdnsserverzoneaging
The DSC xDnsServerZoneAging resource type. Automatically generated from version 1.16.0.0
Properties
The following properties are available in the dsc_xdnsserverzoneaging
type.
dsc_enabled
Data type: Boolean
Option to enable scavenge stale resource records on the zone.
dsc_norefreshinterval
Data type: Optional[Integer[0, 4294967295]]
No-refresh interval for record scavencing in hours. Default value is 7 days.
dsc_refreshinterval
Data type: Optional[Integer[0, 4294967295]]
Refresh interval for record scavencing in hours. Default value is 7 days.
Parameters
The following parameters are available in the dsc_xdnsserverzoneaging
type.
dsc_name
namevar
Data type: String
Name of the DNS forward or reverse loookup zone.
dsc_psdscrunascredential
Data type: Optional[Struct[{ user => String[1], password => Sensitive[String[1]] }]]
name
namevar
Data type: String
Description of the purpose for this resource declaration.
dsc_xdnsserverzonescope
The DSC xDnsServerZoneScope resource type. Automatically generated from version 1.16.0.0
Properties
The following properties are available in the dsc_xdnsserverzonescope
type.
dsc_ensure
Data type: Optional[Enum['Present', 'Absent']]
Should this DNS Server Zone Scope be present or absent
Parameters
The following parameters are available in the dsc_xdnsserverzonescope
type.
dsc_name
namevar
Data type: String
Specifies the name of the Zone Scope.
dsc_psdscrunascredential
Data type: Optional[Struct[{ user => String[1], password => Sensitive[String[1]] }]]
dsc_zonename
namevar
Data type: String
Specify the existing DNS Zone to add a scope to.
name
namevar
Data type: String
Description of the purpose for this resource declaration.
dsc_xdnsserverzonetransfer
The DSC xDnsServerZoneTransfer resource type. Automatically generated from version 1.16.0.0
Properties
The following properties are available in the dsc_xdnsserverzonetransfer
type.
dsc_secondaryserver
Data type: Optional[Array[String]]
IP address or DNS name of DNS servers where zone information can be transfered
dsc_type
Data type: Enum['None', 'Any', 'Named', 'Specific']
Type of transfer allowed
Parameters
The following parameters are available in the dsc_xdnsserverzonetransfer
type.
dsc_name
namevar
Data type: String
Name of the DNS zone
dsc_psdscrunascredential
Data type: Optional[Struct[{ user => String[1], password => Sensitive[String[1]] }]]
name
namevar
Data type: String
Description of the purpose for this resource declaration.
- Changes to XDnsServerADZone
- Raise an exception if
DirectoryPartitionName
is specified andReplicationScope
is notCustom
. (issue 110). - Enforce the
ReplicationScope
parameter being passed toSet-DnsServerPrimaryZone
ifDirectoryPartitionName
has changed.
- Raise an exception if
- xDnsServer:
- OptIn to the following Dsc Resource Meta Tests:
- Common Tests - Relative Path Length
- Common Tests - Validate Markdown Links
- Common Tests - Custom Script Analyzer Rules
- Common Tests - Required Script Analyzer Rules
- Common Tests - Flagged Script Analyzer Rules
- OptIn to the following Dsc Resource Meta Tests:
Dependencies
- puppetlabs/pwshlib (>= 0.7.0 < 2.0.0)