AddBySrv method of the PS_DnsServerResourceRecord class

Adds the record to a specified zone in a DNS server.


uint32 AddBySrv(
  [in]  string                  DomainName,
  [in]  uint16                  Priority,
  [in]  uint16                  Weight,
  [in]  string                  ZoneName,
  [in]  uint16                  Port,
  [in]  datetime                TimeToLive,
  [in]  boolean                 AllowUpdateAny,
  [in]  string                  Name,
  [in]  string                  ComputerName,
  [in]  boolean                 AgeRecord,
  [in]  boolean                 Srv,
  [in]  boolean                 PassThru,
  [in]  string                  ZoneScope,
  [out] DnsServerResourceRecord cmdletOutput


DomainName [in]

Name of the domain

Priority [in]

Specifies the priority of a DNS server. Clients try to contact the server that has the lowest priority.

Weight [in]

Specifies a value for the weight of the target host for a resource record. You can use this parameter when you have multiple hosts that have an identical priority. Use of the host is proportional to its weight.

ZoneName [in]

Specifies the name of the DNS zone.

Port [in]

Specifies the port where the server listens for the service.

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.

AllowUpdateAny [in]

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

Name [in]

Specifies the name of a DNS server resource record object.

ComputerName [in]

Specifies the 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.

Srv [in]

If specified, creates an SRV DNS Server resource 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.

cmdletOutput [out]

Receives an embedded instance of the DnsServerResourceRecord class.


Minimum supported client

None supported

Minimum supported server

Windows Server 2012







See also