RemoveByName method of the PS_DnsServerResourceRecord class

Deletes the specified DNS Resource Record.

Syntax

uint32 RemoveByName(
  [in]  string                  ZoneName,
  [in]  boolean                 PassThru,
  [in]  string                  ComputerName,
  [in]  boolean                 Force,
  [in]  string                  ZoneScope,
  [in]  string                  VirtualizationInstance,
  [in]  string                  RRType,
  [in]  string                  RecordData[],
  [in]  string                  Name,
  [out] DnsServerResourceRecord cmdletOutput[]
);

Parameters

ZoneName [in]

Specifies the name of the zone.

PassThru [in]

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

ComputerName [in]

Specifies the remote computer on which to execute the command.

Force [in]

If specified, overrides the default confirmation before performing the operation.

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 not supported before Windows Server 2016.

RRType [in]

The resource record type.

The possible values are.

A ("A")

Ns ("Ns")

CName ("CName")

Wks ("Wks")

Ptr ("Ptr")

Note

There is a leading space in this value.

HInfo ("HInfo")

Mx ("Mx")

Txt ("Txt")

Rp ("Rp")

Afsdb ("Afsdb")

X25 ("X25")

Isdn ("Isdn")

Rt ("Rt")

AAAA ("AAAA")

Srv ("Srv")

Atma ("Atma")

DName ("DName")

Ds ("Ds")

Rrsig ("Rrsig")

Nsec ("Nsec")

DnsKey ("DnsKey")

DhcId ("DhcId")

Wins ("Wins")

WinsR ("WinsR")

Tlsa ("Tlsa")

Windows Server 2012 R2 and Windows Server 2012: Not supported.

RecordData [in]

Data to be contained in the resource record that needs to be deleted. The record data may be in an object derived from the DnsServerResourceRecord class, such as DnsServerResourceRecordA or DnsServerResourceRecordTxt.

Name [in]

The name of the resource record that needs to be removed.

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