Share via


Set method of the PS_DhcpServerv4DnsSetting class

Sets how the DNS server should be updated by the DHCP server with client-related information.

Syntax

uint32 Set(
  [in]  string                 ComputerName,
  [in]  boolean                NameProtection,
  [in]  boolean                UpdateDnsRRForOlderClients,
  [in]  boolean                DeleteDnsRROnLeaseExpiry,
  [in]  string                 DynamicUpdates,
  [in]  string                 IPAddress,
  [in]  string                 ScopeId,
  [in]  boolean                PassThru,
  [in]  string                 PolicyName,
  [in]  boolean                DisableDnsPtrRRUpdate,
  [in]  string                 DnsSuffix,
  [out] DhcpServerv4DnsSetting cmdletOutput
);

Parameters

ComputerName [in]

DNS name or IP address of the target computer running the DHCP server service.

NameProtection [in]

Enable/Disable name protection on the DHCP server. If Name protection is enabled and if there is an existing DNS record already by the same name, the DNS update for the client will fail instead of being overwritten.

UpdateDnsRRForOlderClients [in]

Enable/Disable DNS registration of A and PTR records for older clients which do not request DNS updates

DeleteDnsRROnLeaseExpiry [in]

Specifies if the DHCP server should delete the client's DNS resource records after the lease expires.Valid values are true, false. Can only be set if DynamicUpdates is set to Always or OnClientRequest.

DynamicUpdates [in]

Specifies the conditions under which to perform dynamic updates on the DNS server. Valid values are Always, Never, OnClientRequest. Always: The DHCP server will always perform dynamic DNS registration of A and PTR records for the clients. Never: DHCP will not perform any dynamic DNS registration. OnClientRequest: DHCP server will perform dynamic DNS registration of A and PTR records if the client has requested for the same in the DHCP client message.

Always ("Always")

Never ("Never")

OnClientRequest ("OnClientRequest")

IPAddress [in]

IP address of the reservation for which the specified DNS update settings are to be set

ScopeId [in]

Scope identifier (in IPv4 address format) for which the DNS update settings are to be set

PassThru [in]

Specifies whether the cmdlet returns the PowerShell object which is modified.

PolicyName [in]

Specifies the policy for which DNS settings are to be modified.

Windows Server 2012: This parameter is supported beginning with Windows Server 2012 R2.

DisableDnsPtrRRUpdate [in]

If True, disables DNS dynamic updates for PTR records. Allowed only when the ScopeID or PolicyName parameters are specified. Not allowed if the IPAddress parameter is specified.

Windows Server 2012: This parameter is supported beginning with Windows Server 2012 R2.

DnsSuffix [in]

Contains guest domain for registering DHCP clients. Accepts domain names in the format as specified in RFC 1035. Allowed only when the PolicyName parameter is specified.

Windows Server 2012: This parameter is supported beginning with Windows Server 2012 R2.

cmdletOutput [out]

An embedded instance of a DhcpServerv4DnsSetting object.

Requirements

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

See also

PS_DhcpServerv4DnsSetting