< Back
Add-DynDnsZone
Post
NAME Add-DynDnsZone
SYNOPSIS
The Add-DynDnsZone command creates a primary DNS zone in the customer's Dyn DNS Managed account.
SYNTAX
Add-DynDnsZone [-Confirm] -ResponsiblePerson <String> [-SerialStyle {increment | epoch | day | minute}] [-TTL
<Int32>] [-WhatIf] -Zone <String> [<CommonParameters>]
Add-DynDnsZone [-Confirm] [-WhatIf] -Zone <String> [-ZoneFile <String>] [<CommonParameters>]
DESCRIPTION
The command Add-DynDnsZone creates a primary DNS zone in the customer's Dyn DNS Managed account. Note: After
creating the new zone, you must use Publish-DynDnsZoneChanges -Zone <zone_name> -Force to publish the zone before
adding additional records.
PARAMETERS
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the command.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-ResponsiblePerson <String>
The email address of the person responsible for the domain.
The value provided must match the syntax for an email address.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-SerialStyle <String>
Provide the style for the zone's serial.
|Style|Description| |-|-| |increment|Serials are incremented by 1 on every change.| |epoch|Serials will be the
UNIX timestamp at the time of the publish.| |day|Serials will be in the form of YYYYMMDDxx where xx is
incremented by one for each change during that particular day.| |minute|Serials will be in the form of
YYMMDDHHMM.|
Required? false
Position? named
Default value day
Accept pipeline input? False
Accept wildcard characters? false
-TTL <Int32>
The default TTL (Time-To-Live) for records in the zone.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the command runs. The command is not run.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Zone <String>
The fully qualified name of the DNS domain for which to create the a primary zone.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-ZoneFile <String>
The contents of a RFC1035 style Master file. A zone file for BIND or tinydns will also be accepted.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
None
OUTPUTS
None
NOTES
-------------------------- Example 1 --------------------------
PS C:\\> Add-DynDnsZone -Zone 'anovelidea.org' -ResponsiblePerson 'powershell@anovelidea.org' -SerialStyle day -TTL
300
Confirm
Are you sure you want to perform this action?
Performing the operation "Create DNS zone" on target "anovelidea.org".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): y
Zone SerialNumber SerialStyle Type
---- ------------ ----------- ----
anovelidea.org 0 day Primary
PS C:\\> Publish-DynDnsZoneChanges -Zone anovelidea.org -Notes 'Creating zone for module help.' -Force
WARNING: There are no pending zone changes.
Confirm
Are you sure you want to perform this action?
Performing the operation "publish zone changes" on target "anovelidea.org".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): y
Zone SerialNumber SerialStyle Type
---- ------------ ----------- ----
anovelidea.org 2018091600 day Primary
Creates a new primary DNS zone by providing the zone name, responsible person, serial style, and default TTL.
-------------------------- Example 2 --------------------------
PS C:\\> Add-DynDnsZone -Zone anovelidea.org -ResponsiblePerson BadEmailAddress
WARNING: The value provided for ResponsiblePerson does not appear to be a valid email. Please try again.
Demonstrates the use of an invalid email address for ResponsiblePerson.
-------------------------- Example 3 --------------------------
PS C:\\> Add-DynDnsZone -Zone anovelidea.org -ZoneFile C:\\Downloads\\anovelidea.org.zonefile.txt
Confirm
Are you sure you want to perform this action?
Performing the operation "Create DNS zone by ZoneFile method" on target "anovelidea.org".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): y
If you plan to provide your own secondary DNS for the zone, allow notify requests from these IP addresses on your
nameserver: 208.78.68.66, 26000:1::66
Zone anovelidea.org import initiated. This task may take a several minutes to complete.
Please be sure to reassign the zone delegation to us.
Zone is not yet delegated to us
Note: Be sure to use the function Publish-DynDnsZoneChanges in order publish the domain.
Create a primary DNS zone by importing a file.
RELATED LINKS
Online Version: https://powershell.anovelidea.org/modul ... sZone.html
Get-DynDnsZone https://powershell.anovelidea.org/modul ... sZone.html
Remove-DynDnsZone https://powershell.anovelidea.org/modul ... sZone.html
Publish-DynDnsZoneChanges https://powershell.anovelidea.org/modul ... anges.html
Create Primary Zone (API) https://help.dyn.com/create-primary-zone-api/
Upload Zone File (API) https://help.dyn.com/upload-zone-file-api/
SYNOPSIS
The Add-DynDnsZone command creates a primary DNS zone in the customer's Dyn DNS Managed account.
SYNTAX
Add-DynDnsZone [-Confirm] -ResponsiblePerson <String> [-SerialStyle {increment | epoch | day | minute}] [-TTL
<Int32>] [-WhatIf] -Zone <String> [<CommonParameters>]
Add-DynDnsZone [-Confirm] [-WhatIf] -Zone <String> [-ZoneFile <String>] [<CommonParameters>]
DESCRIPTION
The command Add-DynDnsZone creates a primary DNS zone in the customer's Dyn DNS Managed account. Note: After
creating the new zone, you must use Publish-DynDnsZoneChanges -Zone <zone_name> -Force to publish the zone before
adding additional records.
PARAMETERS
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the command.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-ResponsiblePerson <String>
The email address of the person responsible for the domain.
The value provided must match the syntax for an email address.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-SerialStyle <String>
Provide the style for the zone's serial.
|Style|Description| |-|-| |increment|Serials are incremented by 1 on every change.| |epoch|Serials will be the
UNIX timestamp at the time of the publish.| |day|Serials will be in the form of YYYYMMDDxx where xx is
incremented by one for each change during that particular day.| |minute|Serials will be in the form of
YYMMDDHHMM.|
Required? false
Position? named
Default value day
Accept pipeline input? False
Accept wildcard characters? false
-TTL <Int32>
The default TTL (Time-To-Live) for records in the zone.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the command runs. The command is not run.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Zone <String>
The fully qualified name of the DNS domain for which to create the a primary zone.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-ZoneFile <String>
The contents of a RFC1035 style Master file. A zone file for BIND or tinydns will also be accepted.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
None
OUTPUTS
None
NOTES
-------------------------- Example 1 --------------------------
PS C:\\> Add-DynDnsZone -Zone 'anovelidea.org' -ResponsiblePerson 'powershell@anovelidea.org' -SerialStyle day -TTL
300
Confirm
Are you sure you want to perform this action?
Performing the operation "Create DNS zone" on target "anovelidea.org".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): y
Zone SerialNumber SerialStyle Type
---- ------------ ----------- ----
anovelidea.org 0 day Primary
PS C:\\> Publish-DynDnsZoneChanges -Zone anovelidea.org -Notes 'Creating zone for module help.' -Force
WARNING: There are no pending zone changes.
Confirm
Are you sure you want to perform this action?
Performing the operation "publish zone changes" on target "anovelidea.org".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): y
Zone SerialNumber SerialStyle Type
---- ------------ ----------- ----
anovelidea.org 2018091600 day Primary
Creates a new primary DNS zone by providing the zone name, responsible person, serial style, and default TTL.
-------------------------- Example 2 --------------------------
PS C:\\> Add-DynDnsZone -Zone anovelidea.org -ResponsiblePerson BadEmailAddress
WARNING: The value provided for ResponsiblePerson does not appear to be a valid email. Please try again.
Demonstrates the use of an invalid email address for ResponsiblePerson.
-------------------------- Example 3 --------------------------
PS C:\\> Add-DynDnsZone -Zone anovelidea.org -ZoneFile C:\\Downloads\\anovelidea.org.zonefile.txt
Confirm
Are you sure you want to perform this action?
Performing the operation "Create DNS zone by ZoneFile method" on target "anovelidea.org".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): y
If you plan to provide your own secondary DNS for the zone, allow notify requests from these IP addresses on your
nameserver: 208.78.68.66, 26000:1::66
Zone anovelidea.org import initiated. This task may take a several minutes to complete.
Please be sure to reassign the zone delegation to us.
Zone is not yet delegated to us
Note: Be sure to use the function Publish-DynDnsZoneChanges in order publish the domain.
Create a primary DNS zone by importing a file.
RELATED LINKS
Online Version: https://powershell.anovelidea.org/modul ... sZone.html
Get-DynDnsZone https://powershell.anovelidea.org/modul ... sZone.html
Remove-DynDnsZone https://powershell.anovelidea.org/modul ... sZone.html
Publish-DynDnsZoneChanges https://powershell.anovelidea.org/modul ... anges.html
Create Primary Zone (API) https://help.dyn.com/create-primary-zone-api/
Upload Zone File (API) https://help.dyn.com/upload-zone-file-api/