Set method of the PS_DnsServerRecursion class
Sets DNS Server Recursion settings.
Syntax
uint32 Set(
[in] string ComputerName,
[in] uint32 AdditionalTimeout,
[in] uint32 RetryInterval,
[in] uint32 Timeout,
[in] boolean Enable,
[in] boolean PassThru,
[in] boolean SecureResponse,
[out] DnsServerRecursion cmdletOutput
);
Parameters
-
ComputerName [in]
-
Specifies the remote computer on which to execute the command
-
AdditionalTimeout [in]
-
The time interval in seconds for which the DNS server waits while recursing to obtain resource records for use in the additional section of DNS responses from a remote DNS server. The value SHOULD be limited to the range 0x00000000 to 0x0000000F, inclusive, but it MAY be any value. The default value SHOULD be 0x00000004, and the value zero SHOULD be treated as a flag value for the default, but it MAY be allowed and treated literally. Range = 0, 15
-
RetryInterval [in]
-
Elapsed seconds before retrying a recursive look up. If the property is undefined or zero, retries are made after three seconds. Users are discouraged from altering this property. There are certain situations when the property should be changed. one example is when the DNS Server contacts remote servers over a slow link, and the DNS Server is retrying before receiving response from the remote DNS. In this case, raising the time out to be slightly longer than the observed response time from the remote DNS would be reasonable. Range = 1, 15
-
Timeout [in]
-
Determines the number of seconds, 0x1-0xFFFFFFFF, a DNS server waits before discontinuing attempts to contact a remote server. The settings range from 0x1 through 0xFFFFFFFF. The default setting is 0xF, 15 seconds. This value should be increased when recursion occurs over a slow WAN link. Range = 1, 15
-
Enable [in]
-
Enables or Disables recursion
-
PassThru [in]
-
true to return the current instance in the CmdletOutput parameter. The default is false.
-
SecureResponse [in]
-
Indicates if the DNS server SHOULD screen DNS records received in remote query responses against the zone of authority for the remote server to prevent cache pollution.
-
cmdletOutput [out]
-
DNSServerRecursionSettings uint32 RecursionRetry. //Elapsed seconds before retrying a recursive look up. If the property is undefined or zero, retries are made after three seconds. Users are discouraged from altering this property. There are certain situations when the property should be changed. one example is when the DNS Server contacts remote servers over a slow link, and the DNS Server is retrying before receiving response from the remote DNS. In this case, raising the time out to be slightly longer than the observed response time from the remote DNS would be reasonable uint32 RecursionTimeout. //Elapsed seconds before the DNS Server gives up recursive query. If the property is undefined or zero, the DNS Server gives up after 15 seconds. In general, the 15-second time out is sufficient to allow any outstanding response to get back to the DNS Server. Users are discouraged from altering this property. One scenario where the property should be changed is when the DNS Server contacts remote servers over a slow link, and the DNS Server is observed rejecting queries (with SERVER_FAILURE) before responses are received. Client resolvers also retry queries, so careful investigation is required to determine whether remote responses are actually associated with the query that timed out. In this case, raising the time out value to be slightly longer than the observed response time from the remote DNS would be reasonable. boolean NoRecursion. //Indicates whether the DNS Server performs recursive look ups. TRUE indicates recursive look ups are not performed. dnsServerRecursion
Requirements
| Minimum supported client |
None supported |
| Minimum supported server |
Windows Server 2012 |
| Namespace |
Root\Microsoft\Windows\Dns |
| MOF |
|
| DLL |
|