Guide

Record set

New-EdnsRecordSet

Suggest Edits

Synopsis

Create record sets.

Syntax

New-EdnsRecordSet -Zone <String> -Name <String> -Type <String> -TTL <String> -RData <Object> [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]

New-EdnsRecordSet -Zone <String> -Body <Object> [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]

Description

Creates one or more new record sets for this zone. Single records can be supplied as individual attributes (Name, Type, TTL, and more) , or you can construct a JSON string or PSCustomObject with a top-level property named recordsets, which is an array of such entries.

If any record set fails to create, for example, because a record set with that name and type already exists, the entire operation fails.

Parameters

‑AccountSwitchKey
String Pipeline input: False

An account credential key that lets you move between accounts when using an API client enabled for multiple accounts. To find account switch keys, use Get-AccountSwitchKey.
‑Body
Conditionally required
Object Parameter sets: postbody Pipeline input: ByValue

A request body, either as a PSCustomObject or a string. This parameter supports pipelining.
‑EdgeRCFile
String Pipeline input: False

Your EdgeGrid resource file to authenticate your command. Defaults to ~/.edgerc.
‑Name
Conditionally required
String Parameter sets: attributes Pipeline input: False

A domain name, including the parent zone.
‑RData
Conditionally required
Object Parameter sets: attributes Pipeline input: False

An array or a comma-separated string. Each entry encodes the rdata for a single record. If you want to have three A records, you need three strings in the array. Each string is encoded in master file format. RFC 1035 defines the master file format for most record types.
‑Section
String Pipeline input: False

The section name in your EdgeGrid resource file to retrieve authentication credentials from. Defaults to default.
‑TTL
Conditionally required
String Parameter sets: attributes Pipeline input: False

The number of seconds that this record should live in a resolver's cache before being refetched.
‑Type
Conditionally required
String Parameter sets: attributes Pipeline input: False

The record set type.
‑Zone
Required
String Pipeline input: False

Your zone's name

Related Links

User Guide: Overview

Updated 10 days ago