Share via


Add method of the PS_DnsServerResourceRecordMX class

Add a mail exchanger (MX) resource record.

Syntax

uint32 Add(
  [in]  string                  Name,
  [in]  string                  MailExchange,
  [in]  uint16                  Preference,
  [in]  string                  ComputerName,
  [in]  datetime                TimeToLive,
  [in]  string                  ZoneName,
  [in]  boolean                 AgeRecord,
  [in]  boolean                 AllowUpdateAny,
  [in]  boolean                 PassThru,
  [in]  string                  ZoneScope,
  [in]  string                  VirtualizationInstance,
  [out] DnsServerResourceRecord cmdletOutput
);

Parameters

Name [in]

The name of the record.

MailExchange [in]

Specifies the fully qualified domain name (FQDN) for a mail exchanger. The value entered here must resolve to a corresponding host (A) resource record in this zone.

Preference [in]

Specifies a numeric value (between 0 and 65535) that indicates the mail exchange server's priority with respect to the other mail exchange servers. Lower numbers are given greater preference.

ComputerName [in]

Specifies the remote computer on which to execute the command.

TimeToLive [in]

Specifies the Time-To-Live (TTL) setting for the resource record. (The default TTL is defined in SOA resource record). Indicates a length of time used by other DNS servers to determine how long to cache information for a record before expiring and discarding it.

ZoneName [in]

Specifies the name of the zone.

AgeRecord [in]

Specifies that this resource record is able to be aged and scavenged. If this command is used, this resource record is able to be aged and scavenged. If this command is not used, the resource record remains in the DNS database unless it is manually updated or removed.

AllowUpdateAny [in]

Allows any authenticated user to update DNS record with same owner name.

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 and embedded instance of the DnsServerResourceRecordMX 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_DnsServerResourceRecordMX