Record set

Set-EdnsRecordSet

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

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

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

A request body, either as a PSCustomObject or a string. This parameter supports pipelining.

‑Confirm
‑EdgeRCFile

Your EdgeGrid resource file to authenticate your command. Defaults to ~/.edgerc.

‑Name
Conditionally required

A domain name, including the parent zone.

‑RData
Conditionally required

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

The section name in your EdgeGrid resource file to retrieve authentication credentials from. Defaults to default.

‑TTL
Conditionally required

The number of seconds that this record should live in a resolver's cache before being refetched.

‑Type
Conditionally required

The record set type.

‑WhatIf
‑Zone
Required

Your zone's name

Related Links

User Guide: Overview