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 |
|
DLL |
|