Zone

New-EdnsZone

Synopsis

Create a zone.

Syntax

attributes (Default)

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>]

postbody

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

Account switch key, for use when you have access to multiple accounts and need to specify which one to use. Account switch keys can be found using Get-AccountSwitchKey.

Type: String
Parameter Sets: (All)
Aliases: None
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Body

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

Type: Object
Parameter Sets: postbody
Aliases: None
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Comment

Free-form user comments.

Type: String
Parameter Sets: attributes
Aliases: None
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ContractID

The contract to use for the new zone.

Type: String
Parameter Sets: (All)
Aliases: None
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EdgeRCFile

EdgeRC file to authenticate your command. Defaults to ~/.edgerc.

Type: String
Parameter Sets: (All)
Aliases: None
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EndCustomerID

Free-form user identifier for this zone, often used by resellers.

Type: String
Parameter Sets: attributes
Aliases: None
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-GroupID

Unique identifier for each group.

Type: Int32
Parameter Sets: (All)
Aliases: None
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Masters

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

Type: Object
Parameter Sets: attributes
Aliases: None
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Section

EdgeRC section to retrieve authentication credentials from. Defaults to default.

Type: String
Parameter Sets: (All)
Aliases: None
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SignAndServe

For PRIMARY and SECONDARY zones only. Indicates whether DNSSEC Sign&Serve is enabled. true to enable.

Type: Boolean
Parameter Sets: attributes
Aliases: None
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SignAndServeAlgorithm

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

Type: String
Parameter Sets: attributes
Aliases:
Accepted values: RSA_SHA1, RSA_SHA256, RSA_SHA512, ECDSA_P256_SHA256, ECDSA_P384_SHA384

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-TSIGKeyAlgorithm

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

Type: String
Parameter Sets: attributes
Aliases:
Accepted values: hmac-md5, hmac-sha1, hmac-sha224, hmac-sha256, hmac-sha384, hmac-sha512, HMAC-MD5.SIG-ALG.REG.INT

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-TSIGKeyName

The name of the 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.

Type: String
Parameter Sets: attributes
Aliases: None
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-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.

Type: String
Parameter Sets: attributes
Aliases: None
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-TSIGKeyZoneCount

The number of zones that reference this key.

Type: Int32
Parameter Sets: attributes
Aliases: None
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Target

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

Type: String
Parameter Sets: attributes
Aliases: None
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Type

The record set type.

Type: String
Parameter Sets: attributes
Aliases:
Accepted values: PRIMARY, SECONDARY, ALIAS

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Zone

The name of the zone.

Type: String
Parameter Sets: attributes
Aliases: None
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

System.Object

Outputs