If you’re looking to create your own CloudFlare API v4-based PowerShell module, and would like some syntax examples, here’s a simplified breakdown of my CloudFlareDynDns module on github, which I discuss in “Use PowerShell and CloudFlare API v4 to Dynamically Update CloudFlare DNS to your External IP“.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 |
# Set auth and subdomain information $token = "1234567893feefc5f0q5000bfo0c38d90bbeb" $domain = "example.com" $record = "homelab" # Get external IP $ipaddr = Invoke-RestMethod http://ipinfo.io/json | Select-Object -ExpandProperty ip $baseurl = "https://api.cloudflare.com/client/v4/zones" $zoneurl = "$baseurl/?name=$domain" # To login use... $headers = @{ 'X-Auth-Key' = $token 'X-Auth-Email ' = $email } # Get Zone info $zone = Invoke-RestMethod -Uri $zoneurl -Method Get -Headers $headers $zoneid = $zone.result.id $recordurl = "$baseurl/$zoneid/dns_records/?name=$record.$domain" # Get current DNS record $dnsrecord = Invoke-RestMethod -Uri $recordurl -Method Get -Headers $headers # If it exists, update, if not, add if ($dnsrecord.result.count -gt 0) { $recordid = $dnsrecord.result.id $dnsrecord.result | Add-Member "content" $ipaddr -Force $body = $dnsrecord.result | ConvertTo-Json $updateurl = "$baseurl/$zoneid/dns_records/$recordid/" $result = Invoke-RestMethod -Uri $updateurl -Method Put -Headers $headers -Body $body Write-Output "Record $record.$domain has been updated to the IP $($result.result.content)" } else { $newrecord = @{ "type" = "A" "name" = "$record.$domain" "content" = $ipaddr } $body = $newrecord | ConvertTo-Json $newrecordurl = "$baseurl/$zoneid/dns_records" $request = Invoke-RestMethod -Uri $newrecordurl -Method Post -Headers $headers -Body $body -ContentType "application/json" Write-Output "New record $record.$domain has been created with the ID $($request.result.id)" } |
Chrissy is a Cloud and Datacenter Management & Data Platform MVP who has worked in IT for over 20 years. She is the creator of the popular SQL PowerShell module dbatools, holds a master's degree in Systems Engineering and is coauthor of Learn dbatools in a Month of Lunches. Chrissy is certified in SQL Server, Linux, SharePoint and network security. You can follow her on Twitter at @cl.
join chrissy on twitch
This is an awesome script thanks. what would the syntax be to update an @ or catch all record without a prefix like http://www.?
I love your script and it woks well, but how would I use it to update “domain.com” instead of “home.domain.com”?
I figured it out. If you add replace the “$recordurl = ” line with this code:
if ($record) {
$recordurl = “$baseurl/$zoneid/dns_records/?name=$record.$domain”
} else {
$recordurl = “$baseurl/$zoneid/dns_records/?name=$domain&type=A”
}
When $record = “”, it works great.