AddByPtr method of the PS_DnsServerResourceRecord class

Adds a type PTR resource record to a DNS server.

Syntax

uint32 AddByPtr(
  [in]  string                  PtrDomainName,
  [in]  string                  ZoneName,
  [in]  datetime                TimeToLive,
  [in]  boolean                 AllowUpdateAny,
  [in]  string                  Name,
  [in]  string                  ComputerName,
  [in]  boolean                 AgeRecord,
  [in]  boolean                 Ptr,
  [in]  boolean                 PassThru,
  [in]  string                  ZoneScope,
  [in]  string                  VirtualizationInstance,
  [out] DnsServerResourceRecord cmdletOutput
);

Parameters

PtrDomainName [in]

Specifies an FQDN for a resource record in the DNS namespace. This value is the response to a reverse lookup using this PTR.

ZoneName [in]

Specifies the name of a reverse lookup zone.

TimeToLive [in]

Specifies the Time to Live (TTL) value, in seconds, for a resource record. Other DNS servers use this length of time to determine how long to cache a record. The Start of Authority (SOA) record defines the default TTL.

AllowUpdateAny [in]

Indicates that any authenticated user can update a resource record that has the same owner name.

Name [in]

Specifies part of the IP address for the host. You can use either an IPv4 or IPv6 address. For example, if an IPv4 class C reverse lookup zone is used, then Name is the last octet of the IP address. If a class B reverse lookup zone is used, then Name is the last two octets.

ComputerName [in]

Specifies a DNS server. If you do not specify this parameter, the command runs on the local system. You can specify an IP address or any value that resolves to an IP address, such as a fully qualified domain name (FQDN), host name, or NETBIOS name.

AgeRecord [in]

Indicates that the DNS server uses a time stamp for the resource record that this method adds. A DNS server can scavenge resource records that have become stale based on a time stamp.

Ptr [in]

If specified, creates a PTR record.

PassThru [in]

true to return the object that was modified by the method. By default, this method does not generate any output.

ZoneScope [in]

Name of the zone scope.

Windows Server 2012: Not supported.

VirtualizationInstance [in]

Unique identifier of the virtualization instance.

Windows Server 2012 R2 and Windows Server 2012: This parameter is unavailable prior to Windows Server 2016.

cmdletOutput [out]

Receives an embedded instance of the DnsServerResourceRecord class.

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_DnsServerResourceRecord