Share via


Set method of the PS_DnsServerDsSetting class

Sets Active Directory settings.

Syntax

uint32 Set(
  [in]  datetime           DirectoryPartitionAutoEnlistInterval,
  [in]  uint32             LazyUpdateInterval,
  [in]  uint32             MinimumBackgroundLoadThreads,
  [in]  uint32             RemoteReplicationDelay,
  [in]  string             ComputerName,
  [in]  uint32             PollingInterval,
  [in]  datetime           TombstoneInterval,
  [in]  boolean            PassThru,
  [out] DnsServerDsSetting cmdletOutput
);

Parameters

DirectoryPartitionAutoEnlistInterval [in]

The interval in seconds at which the DNS server will attempt to enlist itself in the DNS domain partition and DNS forest partition if it is not already enlisted. The value should be limited to the range 0x00000E10 (1 hour) to 0x00ED4E00 (180 days), inclusive, but it may be any value. The default value must be 0x00015180 (1 day), and the value zero should be treated as a flag value for the default, but it may be allowed and treated literally.

LazyUpdateInterval [in]

A value in seconds indicating how frequently the DNS server will submit updates to the directory server without specifying the LDAP_SERVER_LAZY_COMMIT_OID control ([MS-ADTS] section 3.1.1.3.4.1.7) while processing DNS dynamic update requests. This control instructs the directory server that it may sacrifice durability guarantees on updates to improve performance and is meant to improve DNS server update performance. This control must only be sent by the DNS server to the directory server attached to an LDAP update initiated by the DNS server in response to a DNS dynamic update request. If the value is nonzero, LDAP updates performed while processing DNS dynamic update requests must not specify the LDAP_SERVER_LAZY_COMMIT_OID control, if a period of fewer than DsLazyUpdateInterval seconds has passed since the last LDAP update specifying this control. If a period of time greater than DsLazyUpdateInterval seconds passes in which the DNS server does not perform an LDAP update specifying this control, the DNS server must specify this control on the next update. The value should be limited to the range 0x00000000 to 0x0000003c. The default value must be 0x00000003, and the value zero must be treated as indicating that the DNS server must not specify the LDAP_SERVER_LAZY_COMMIT_OID control while processing any DNS dynamic update requests

MinimumBackgroundLoadThreads [in]

The minimum number of background threads that the DNS server will use to load zone data from the directory service. The value must be limited to the range 0x00000000 to 0x00000005, inclusive. The default value must be 0x00000001, and the value zero must be treated as a flag value for the default.

RemoteReplicationDelay [in]

The minimum interval in seconds that the DNS server must wait between the time it determines that a single object has changed on a remote directory server and the time it attempts to replicate the single object change. The value must be limited to the range 0x00000005 to 0x00000E10, inclusive. The default value must be 0x0000001E, and the value zero must be treated as a flag value for the default.

ComputerName [in]

Specifies the remote computer on which to execute the command.

PollingInterval [in]

Specifies how often the DNS server polls Active Directory for changes in Active Directory-integrated zones. Interval, in seconds, to poll the DS-integrated zones. The interval in seconds at which the DNS server will poll a directory server to obtain updated information for any changes that may have occurred to zones loaded in the server. The values must be between 30 and 3600 seconds inclusive. Range = 30 to 3600.

TombstoneInterval [in]

Amount of time in seconds to keep tombstoned records in Active Directory alive. The age at which tombstone objects in the directory service will be deleted. The value should be limited to the range 0x0003F480 (3 days) to 0x0049D400 (8 weeks), inclusive, but it may be any value. The default value should be 0x00127500 (14 days), and the value of zero should be treated as a flag value for the default, but it may be allowed and treated literally. Every day at 2:00 AM local time the DNS server must conduct a search of all zones stored in the directory server for nodes which have the dnsTombstoned attribute set to TRUE and an EntombedTime (section 2.2.2.2.3.23 of MS-DNSP) value greater than DsTombstoneInterval seconds in the past. Any such nodes must be permanently deleted from the directory server Range = 295200 to 4838400. The default value = 0x00127500.

PassThru [in]

true to return the current instance in the CmdletOutput parameter. The default is false.

cmdletOutput [out]

On return, contains an instance of the current object. This parameter returns a value only if PassThru is set to true.

Requirements

Minimum supported client
None supported
Minimum supported server
Windows Server 2012
Namespace
Root\Microsoft\Windows\Dns
MOF
DnsServerPSProvider.mof
DLL
DnsServerPSProvider.dll

See also

PS_DnsServerDsSetting