Share via


Add method of the PS_DnsServerResourceRecordCName class

Adds a record for mapping an alias DNS domain name to another primary or canonical name.

Syntax

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

Parameters

HostNameAlias [in]

Alias Name

AllowUpdateAny [in]

Allow any authenticated user to update DNS record with same owner name

Name [in]

Specifies the FQDN of any valid DNS host or domain name in the namespace. For FQDN's, a trailing period (.) is used to fully qualify the name.

ComputerName [in]

Specifies the DNS server , represented by local computer syntax, FQDN, or Host name. If omitted, the local server is used.

TimeToLive [in]

TTL

ZoneName [in]

Specifies the name of the zone.

AgeRecord [in]

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

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 DnsServerResourceRecordCName 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_DnsServerResourceRecordCName