Guide

Record set

Set-EdnsRecordSet

Suggest Edits

Synopsis

Replace a record set.

Syntax

Set-EDNSRecordSet -Zone <String> -Name <String> -Type <String> -TTL <String> -RData <Object> [-AutoIncrementSOA] [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [-WhatIf] [-Confirm] [<CommonParameters>]

Set-EDNSRecordSet -Zone <String> -Body <Object> [-AutoIncrementSOA] [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [-WhatIf] [-Confirm] [<CommonParameters>]

Description

Replaces one or more recordsets with the provided values. When updating an individual record you can provide a PSCustomObject or specify parameter values individually. If you wish to update more than one recordset, you can pipe an array of objects to the function but beware that this will replace the ENTIRE contents of the EdgeDNS zone with ONLY those values you supply (there is a warning in the function about this). If you wish to update multiple records without replacing the entire zone, it is recommended that you pipe your records to Foreach-Object, then call Set-EDNSRecordSet inside the loop.

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.
‑AutoIncrementSOA
Switch Pipeline input: False

When updating all records in a zone you must increase the serial number section of the SOA record before doing so. If this switch is present the existing serial number will be automatically incremented by 1.
‑Body
Conditionally required
Object Parameter sets: postbody Pipeline input: ByValue

A request body, either as a PSCustomObject or a string. This parameter supports pipelining.
‑Confirm
Switch Pipeline input: False
‑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.
‑WhatIf
Switch Pipeline input: False
‑Zone
Required
String Pipeline input: False

Your zone's name

Related Links

User Guide: Overview

Updated 15 days ago