< Back

Add-AzureRmDnsRecordConfig

Tue Jan 29, 2019 9:46 pm

NAME Add-AzureRmDnsRecordConfig



SYNOPSIS

Adds a DNS record to a local record set object.





SYNTAX

Add-AzureRmDnsRecordConfig -CaaFlags <Byte> -CaaTag <String> -CaaValue <String> [-DefaultProfile <IAzureContextContainer>] -RecordSet

<DnsRecordSet> [<CommonParameters>]



Add-AzureRmDnsRecordConfig -Cname <String> [-DefaultProfile <IAzureContextContainer>] -RecordSet <DnsRecordSet> [<CommonParameters>]



Add-AzureRmDnsRecordConfig [-DefaultProfile <IAzureContextContainer>] -Exchange <String> -Preference <UInt16> -RecordSet <DnsRecordSet>

[<CommonParameters>]



Add-AzureRmDnsRecordConfig [-DefaultProfile <IAzureContextContainer>] -Ipv4Address <String> -RecordSet <DnsRecordSet> [<CommonParameters>]



Add-AzureRmDnsRecordConfig [-DefaultProfile <IAzureContextContainer>] -Ipv6Address <String> -RecordSet <DnsRecordSet> [<CommonParameters>]



Add-AzureRmDnsRecordConfig [-DefaultProfile <IAzureContextContainer>] -Nsdname <String> -RecordSet <DnsRecordSet> [<CommonParameters>]



Add-AzureRmDnsRecordConfig [-DefaultProfile <IAzureContextContainer>] -Port <UInt16> -Priority <UInt16> -RecordSet <DnsRecordSet> -Target <String>

-Weight <UInt16> [<CommonParameters>]



Add-AzureRmDnsRecordConfig [-DefaultProfile <IAzureContextContainer>] -Ptrdname <String> -RecordSet <DnsRecordSet> [<CommonParameters>]



Add-AzureRmDnsRecordConfig [-DefaultProfile <IAzureContextContainer>] -RecordSet <DnsRecordSet> -Value <String> [<CommonParameters>]





DESCRIPTION

The Add-AzureRmDnsRecordConfig cmdlet adds a Domain Name System (DNS) record to a RecordSet object. The RecordSet object is an offline object, and

changes to it do not change the DNS responses until after you run the Set-AzureRmDnsRecordSet cmdlet to persist the change to the Microsoft Azure

DNS service.



SOA records are created when a DNS zone is created, and are removed when the DNS zone is deleted. You cannot add or remove SOA records, but you

can edit them.



You can pass the RecordSet object to this cmdlet as a parameter or by using the pipeline operator.





PARAMETERS

-CaaFlags <Byte>

The flags for the CAA record to add. Must be a number between 0 and 255.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-CaaTag <String>

The tag field of the CAA record to add.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-CaaValue <String>

The value field for the CAA record to add.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Cname <String>

Specifies the domain name for a canonical name (CNAME) record.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-DefaultProfile <IAzureContextContainer>

The credentials, account, tenant, and subscription used for communication with azure



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Exchange <String>

Specifies the mail exchange server name for a mail exchange (MX) record.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Ipv4Address <String>

Specifies an IPv4 address for an A record.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Ipv6Address <String>

Specifies an IPv6 address for an AAAA record.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Nsdname <String>

Specifies the name server name for a name server (NS) record.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Port <UInt16>

Specifies the port for a service (SRV) record.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Preference <UInt16>

Specifies the preference for an MX record.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Priority <UInt16>

Specifies the priority for an SRV record.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Ptrdname <String>

Specifies the target domain name of a pointer resource (PTR) record.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-RecordSet <DnsRecordSet>

Specifies the RecordSet object to edit.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByValue)

Accept wildcard characters? false



-Target <String>

Specifies the target for an SRV record.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Value <String>

Specifies the value for a TXT record.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Weight <UInt16>

Specifies the weight for an SRV record.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

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 (http://go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

Microsoft.Azure.Commands.Dns.DnsRecordSet

You can pipe a RecordSet object to this cmdlet. This is an offline representation of the RecordSet , and changes to it do not change DNS

responses until after you run the Set-AzureRmDnsRecordSet cmdlet.





OUTPUTS

Microsoft.Azure.Commands.Dns.DnsRecordSet

This cmdlet returns the modified RecordSet object. In addition, the object passed in is modified directly.





NOTES









Example 1: Add an A record to a record set



PS C:\\> $RecordSet = Get-AzureRmDnsRecordSet -Name www -RecordType A -ResouceGroupName MyResourceGroup -ZoneName myzone.com

PS C:\\> Add-AzureRmDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 1.2.3.4

PS C:\\> Set-AzureRmDnsRecordSet -RecordSet $RecordSet



# You can also pipe the above sequence:



PS C:\\> Get-AzureRmDnsRecordSet -Name www -RecordType A -ResouceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzureRmDnsRecordConfig

-Ipv4Address 1.2.3.4 | Set-AzureRmDnsRecordSet



This example adds an A record to an existing record set.





Example 2: Add an AAAA record to a record set



PS C:\\> $RecordSet = Get-AzureRmDnsRecordSet -Name www -RecordType AAAA -ResouceGroupName MyResourceGroup -ZoneName myzone.com

PS C:\\> Add-AzureRmDnsRecordConfig -RecordSet $RecordSet -Ipv6Address 2001:DB80:4009:1803::1005

PS C:\\> Set-AzureRmDnsRecordSet -RecordSet $RecordSet



# You can also pipe the above sequence:



PS C:\\> Get-AzureRmDnsRecordSet -Name www -RecordType AAAA -ResouceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzureRmDnsRecordConfig

-Ipv6Address 2001:DB80:4009:1803::1005 | Set-AzureRmDnsRecordSet



This example adds an AAAA record to an existing record set.





Example 3: Add a CNAME record to a record set



PS C:\\>$RecordSet = Get-AzureRmDnsRecordSet -Name www -RecordType CNAME -ResouceGroupName MyResourceGroup -ZoneName myzone.com

PS C:\\> Add-AzureRmDnsRecordConfig -RecordSet $RecordSet -Cname contoso.com

PS C:\\> Set-AzureRmDnsRecordSet -RecordSet $RecordSet



# You can also pipe the above sequence:



PS C:\\> Get-AzureRmDnsRecordSet -Name www -RecordType CNAME -ResouceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzureRmDnsRecordConfig

-Cname contoso.com | Set-AzureRmDnsRecordSet



This example adds a CNAME record to an existing record set. Because a CNAME record set can contain at most one record, it must initially be an

empty record set, or existing records must be removed using Remove-AzureRmDnsRecordConfig.





Example 4: Add an MX record to a record set



PS C:\\> $RecordSet = Get-AzureRmDnsRecordSet -Name "@" -RecordType MX -ResouceGroupName MyResourceGroup -ZoneName myzone.com

PS C:\\> Add-AzureRmDnsRecordConfig -Exchange mail.microsoft.com -Preference 5 -RecordSet $RecordSet

PS C:\\> Set-AzureRmDnsRecordSet -RecordSet $RecordSet



# You can also pipe the above sequence:



PS C:\\> Get-AzureRmDnsRecordSet -Name "@" -RecordType MX -ResouceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzureRmDnsRecordConfig

-Exchange mail.microsoft.com -Preference 5 | Set-AzureRmDnsRecordSet



This example adds an MX record to an existing record set. The record name "@" indicates a record set at the zone apex.





Example 5: Add an NS record to a record set



PS C:\\>$RecordSet = Get-AzureRmDnsRecordSet -Name abc -RecordType NS -ResouceGroupName MyResourceGroup -ZoneName myzone.com

PS C:\\> Add-AzureRmDnsRecordConfig -Nsdname ns1.myzone.com -RecordSet $RecordSet

PS C:\\> Set-AzureRmDnsRecordSet -RecordSet $RecordSet



# You can also pipe the above sequence:



PS C:\\> Get-AzureRmDnsRecordSet -Name abc -RecordType NS -ResouceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzureRmDnsRecordConfig

-Nsdname ns1.myzone.com | Set-AzureRmDnsRecordSet



This example adds an NS record to an existing record set.





Example 6: Add a PTR record to a record set



PS C:\\>$RecordSet = Get-AzureRmDnsRecordSet -Name 4 -RecordType PTR -ResouceGroupName MyResourceGroup -ZoneName 3.2.1.in-addr.arpa

PS C:\\> Add-AzureRmDnsRecordConfig -Ptrdname www.contoso.com -RecordSet $RecordSet

PS C:\\> Set-AzureRmDnsRecordSet -RecordSet $RecordSet



# The above sequence can also be piped:



PS C:\\> Get-AzureRmDnsRecordSet -Name 4 -RecordType PTR -ResouceGroupName MyResourceGroup -ZoneName 3.2.1.in-addr.arpa |

Add-AzureRmDnsRecordConfig -Ptrdname www.contoso.com | Set-AzureRmDnsRecordSet



This example adds a PTR record to an existing record set.





Example 7: Add an SRV record to a record set



PS C:\\>$RecordSet = Get-AzureRmDnsRecordSet -Name _sip._tcp -RecordType SRV -ResouceGroupName MyResourceGroup -ZoneName myzone.com

PS C:\\> Add-AzureRmDnsRecordConfig -RecordSet $RecordSet -Priority 0 -Weight 5 -Port 8080 -Target target.example.com

PS C:\\> Set-AzureRmDnsRecordSet -RecordSet $RecordSet



# The above sequence can also be piped:



PS C:\\> Get-AzureRmDnsRecordSet -Name _sip._tcp -RecordType SRV -ResouceGroupName MyResourceGroup -ZoneName myzone.com |

Add-AzureRmDnsRecordConfig -Priority 0 -Weight 5 -Port 8080 -Target target.example.com | Set-AzureRmDnsRecordSet



This example adds an SRV record to an existing record set.





Example 8: Add a TXT record to a record set



PS C:\\>$RecordSet = Get-AzureRmDnsRecordSet -Name text -RecordType TXT -ResouceGroupName MyResourceGroup -ZoneName myzone.com

PS C:\\> Add-AzureRmDnsRecordConfig -RecordSet $RecordSet -Value "This is a TXT Record"

PS C:\\> Set-AzureRmDnsRecordSet -RecordSet $RecordSet



# The above sequence can also be piped:



PS C:\\> Get-AzureRmDnsRecordSet -Name text -RecordType TXT -ResouceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzureRmDnsRecordConfig

-Value "This is a TXT Record" | Set-AzureRmDnsRecordSet



This example adds a TXT record to an existing record set.







RELATED LINKS

Online Version: https://docs.microsoft.com/en-us/powers ... cordconfig

Get-AzureRmDnsRecordSet

Remove-AzureRmDnsRecordConfig

Set-AzureRmDnsRecordSet