Zone

New-EdnsZone

Synopsis

Create a zone.

Syntax

New-EdnsZone -Zone <String> -Type <String> -ContractID <String> -GroupID <Int32> [-Comment <String>] [-EndCustomerID <String>] [-Masters <Object>] [-SignAndServe <Boolean>] [-SignAndServeAlgorithm <String>] [-Target <String>] [-TSIGKeyAlgorithm <String>] [-TSIGKeyName <String>] [-TSIGKeySecret <String>] [-TSIGKeyZoneCount <Int32>] [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
New-EdnsZone -ContractID <String> -GroupID <Int32> -Body <Object> [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]

Description

Creates a new zone. You can provide the zone attributes as individual parameters or pass the entire request with the Body parameter.

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.

‑Body
Conditionally required

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

‑Comment

Free-form user comments.

‑ContractID
Required

Your contract's ID.

‑EdgeRCFile

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

‑EndCustomerID

A free-form user's ID for this zone, often used by resellers.

‑GroupID
Required

Your group's ID.

‑Masters

For SECONDARY zones only. The names or addresses of the customer's nameservers that the zone data should be retrieved from.

‑Section

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

‑SignAndServe

For PRIMARY and SECONDARY zones only. Enables DNSSEC Sign&Serve.

‑SignAndServeAlgorithm

The algorithm currently or last used for DNSSEC Sign&Serve. Absent if no algorithm has ever been assigned to a given zone.

‑TSIGKeyAlgorithm

The algorithm used to encode the TSIG key's secret data.

‑TSIGKeyName

The name of your TSIG key. This is a name that's unique across all of Akamai's customers. Since the key name is treated like a DNS name, the value is lowercase and the server removes any trailing dots.

‑TSIGKeySecret

A Base64-encoded string of data. When decoded, it needs to contain the correct number of bits for the chosen algorithm. If the input is not correctly padded, the server applies the padding.

‑TSIGKeyZoneCount

The number of zones that reference a given key.

‑Target

For ALIAS zones only. The name of the zone whose configuration a given zone will copy.

‑Type
Conditionally required

The record set type.

‑Zone
Conditionally required

Your zone's name

Related Links