ADC CLI Commands

dns-txtRec

The following operations can be performed on “dns-txtRec”:

rm show add

rm dns txtRec

Removes the specified TXT record from the specified domain. For EDNS Client Subnet (ECS) records, a subnet needs to be specified to remove a TXT record which is cached for that particular subnet.

Synopsis

rm dns txtRec ( ... | -recordId @) [-ecsSubnet <ip_addr[/prefix]|ipv6_addr[/prefix]>]

Arguments

domain Name of the domain for the TXT record.

string Complete set of text strings in the TXT record, entered in the order in which they are stored in the record. Mutually exclusive with the record ID parameter.

recordId Unique, internally generated record ID. View the details of the TXT record to obtain its record ID. Mutually exclusive with the string parameter. Minimum value: 1 Maximum value: 65535

ecsSubnet Subnet for which the cached TXT record need to be removed.

Example

rm dns txtRec spf.m.test. “v=spf1 ip4:1.2.3.0/24 ip4:1.3.4.0/24 ?all” rm dns txtRec comments.m.test. “This is a CHARSTR” “This is another CHARSTR” rm dns txtRec comments.m.test. -recordId 1411

show dns txtRec

Displays TXT records owned by the specified domain. If no domain name is specified, all configured TXT records are shown.

Synopsis

show dns txtRec [ | -type ]

Arguments

domain Name of the domain for the TXT record.

type Type of records to display. Available settings function as follows:

  • ADNS - Display all authoritative address records.
  • PROXY - Display all proxy address records.
  • ALL - Display all address records.

Possible values: ALL, ADNS, PROXY Default value: ADNS

Output

string Information to store in the TXT resource record. Enclose the string in single or double quotation marks. A TXT resource record can contain up to six strings, each of which can contain up to 255 characters. If you want to add a string of more than 255 characters, evaluate whether splitting it into two or more smaller strings, subject to the six-string limit, works for you.

ecsSubnet Subnet for which this particular record is cached. Subnet caching will occur for responses with EDNS Client Subnet (ECS) option. Applies to resource records obtained through proxy configurations only

TTL Time to Live (TTL), in seconds, for the record. TTL is the time for which the record must be cached by DNS proxies. The specified TTL is applied to all the resource records that are of the same record type and belong to the specified domain name. For example, if you add an address record, with a TTL of 36000, to the domain name example.com, the TTLs of all the address records of example.com are changed to 36000. If the TTL is not specified, the Citrix ADC uses either the DNS zone’s minimum TTL or, if the SOA record is not available on the appliance, the default value of 3600.

recordId authType Authentication type.

devno count stateflag

Example

show dns txtRec spf.m.test. show dns txtRec

add dns txtRec

Creates a text (TXT) record for the specified domain name. Each resource record is stored with a unique, internally generated record ID, which you can view and use to delete the record. You cannot modify a TXT resource record.

Synopsis

add dns txtRec ... [-TTL ]

Arguments

domain Name of the domain for the TXT record.

string Information to store in the TXT resource record. Enclose the string in single or double quotation marks. A TXT resource record can contain up to six strings, each of which can contain up to 255 characters. If you want to add a string of more than 255 characters, evaluate whether splitting it into two or more smaller strings, subject to the six-string limit, works for you.

TTL Time to Live (TTL), in seconds, for the record. TTL is the time for which the record must be cached by DNS proxies. The specified TTL is applied to all the resource records that are of the same record type and belong to the specified domain name. For example, if you add an address record, with a TTL of 36000, to the domain name example.com, the TTLs of all the address records of example.com are changed to 36000. If the TTL is not specified, the Citrix ADC uses either the DNS zone’s minimum TTL or, if the SOA record is not available on the appliance, the default value of 3600. Default value: 3600 Maximum value: 2147483647

Example

add dns txtRec spf.m.test. “v=spf1 ip4:1.2.3.0/24 ip4:1.3.4.0/24 ?all” add dns txtRec comments.m.test. “This is a CHARSTR” “This is another CHARSTR”

dns-txtRec