{"id":21071833,"url":"https://github.com/devblackops/poshorigin_activedirectorydns","last_synced_at":"2026-04-23T12:32:04.644Z","repository":{"id":142026127,"uuid":"48200081","full_name":"devblackops/POSHOrigin_ActiveDirectoryDNS","owner":"devblackops","description":"DSC resources to manage Active Directory DNS records with POSHOrigin","archived":false,"fork":false,"pushed_at":"2016-05-31T19:29:50.000Z","size":51,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-14T03:09:02.364Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devblackops.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-12-17T21:50:29.000Z","updated_at":"2022-06-10T15:04:08.000Z","dependencies_parsed_at":null,"dependency_job_id":"2e69eb44-69d9-4a86-9907-1305ab42e10d","html_url":"https://github.com/devblackops/POSHOrigin_ActiveDirectoryDNS","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/devblackops/POSHOrigin_ActiveDirectoryDNS","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devblackops%2FPOSHOrigin_ActiveDirectoryDNS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devblackops%2FPOSHOrigin_ActiveDirectoryDNS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devblackops%2FPOSHOrigin_ActiveDirectoryDNS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devblackops%2FPOSHOrigin_ActiveDirectoryDNS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devblackops","download_url":"https://codeload.github.com/devblackops/POSHOrigin_ActiveDirectoryDNS/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devblackops%2FPOSHOrigin_ActiveDirectoryDNS/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32181365,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-23T11:42:27.955Z","status":"ssl_error","status_checked_at":"2026-04-23T11:42:18.877Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-19T18:54:22.121Z","updated_at":"2026-04-23T12:32:04.616Z","avatar_url":"https://github.com/devblackops.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build status](https://ci.appveyor.com/api/projects/status/w3h64v1fk7psfke8/branch/master?svg=true)](https://ci.appveyor.com/project/devblackops/poshorigin-activedirectorydns/branch/master)\n\n[![Stories in Ready](https://badge.waffle.io/devblackops/POSHOrigin_ActiveDirectoryDNS.png?label=ready\u0026title=Ready)](https://waffle.io/devblackops/POSHOrigin_ActiveDirectoryDNS)\n\n# POSHOrigin_ActiveDirectoryDNS\nPOSHOrigin_ActiveDirectoryDNS is a set of PowerShell 5 based DSC resources for managing Active Directory DNS objects via DSC.\n\n## Overview\nPOSHOrigin_ActiveDirectoryDNS is a set of PowerShell 5 based DSC resources for managing Active Directory DNS objects via DSC. These resources are designed to be used with [POSHOrigin](https://github.com/devblackops/POSHOrigin) as a Infrastructure as Code framework, but can be used natively by standard DSC configurations as well. Integration with [POSHOrigin](https://github.com/devblackops/POSHOrigin) is accomplished via a separate 'Invoke.ps1' script included in the module.\n\n## Resources\n* **ARecord** Manages an A record\n* **CNAME** Manages a CNAME record\n* **MX** manages an MX record\n\n### ARecord\n\nCreated, modifies, or deletes a A record object on an Active Directory DNS server.\n\nParameters\n----------\n\n| Name            | Type         | Required | Description\n| :---------------|:-------------|:---------|:-----------|\n| Name            | string       | True     | The hostname for the record\n| Ensure          | string       | False    | Denotes if resource should exist or not exist\n| DnsServer       | string       | True     | The Active Directory DNS server to connect to\n| Credential      | pscredential | True     | Credentials with rights to manage Active Directory DNS records. In a POSHOrigin, credentials can be included under the 'secrets' hashtable or defined inline\n| IPAddress       | string       | True     | IPv4 address for A record\n| ZoneName        | string       | True     | DNS zone the record is associated with\n| TTL             | int          | False    | Time to live for A record\n| CreatePtr       | bool         | False    | Indicates that the DNS server automatically creates an associated pointer (PTR) resource record for an A record. Default: True\n| AllowUpdateAny  | bool         | False    | Indicates that any authenticated user can update a resource record that has the same owner name.. Default: False\n| AgeRecord       | bool         | False    | Indicates that the DNS server uses a time stamp for the resource record that this cmdlet adds. A DNS server can scavenge resource records that have become stale based on a time stamp. Default value: False\n\n### CName\n\nCreated, modifies, or deletes a CNAME record object on an Active Directory DNS server.\n\nParameters\n----------\n\n| Name            | Type         | Required | Description\n| :---------------|:-------------|:---------|:-----------|\n| Name            | string       | True     | The alias name for the record\n| Ensure          | string       | False    | Denotes if resource should exist or not exist\n| DnsServer       | string       | True     | The Active Directory DNS server to connect to\n| Credential      | pscredential | True     | Credentials with rights to manage Active Directory DNS records. In a POSHOrigin, credentials can be included under the 'secrets' hashtable or defined inline\n| FQDN            | string       | True     | Fully Qualified Domain Name the CNAME should point to\n| ZoneName        | string       | True     | DNS zone the record is associated with\n| TTL             | int          | False    | Time to live for A record\n| AllowUpdateAny  | bool         | False    | Indicates that any authenticated user can update a resource record that has the same owner name.. Default: False\n| AgeRecord       | bool         | False    | Indicates that the DNS server uses a time stamp for the resource record that this cmdlet adds. A DNS server can scavenge resource records that have become stale based on a time stamp. Default value: False\n\n## POSHOrigin Example\n\nThis example shows how to use the **ARecord** resource within the context of a [POSHOrigin](https://github.com/devblackops/POSHOrigin) configuration file.\n\n```PowerShell\nresource 'POSHOrigin_ActiveDirectoryDNS:ARecord' 'serverxyz' @{\n    ZoneName = 'mydomain.local'\n    IpAddress = '10.45.195.254'\n    DnsServer = 'dc01.mydomain.local'\n    CreatePtr = $true\n    Credential = Get-POSHOriginSecret 'pscredential' @{\n        username = 'mydomain\\administrator'\n        password = 'K33p1t53cr3tK33p1t5@f3'\n    }\n}\n```\n\n## Traditional DSC example\n\nThis example show how to use the **ARecord** resource within a traditional DSC configuration file.\n\n```PowerShell\nConfiguration Example_ARecord {\n    param(\n        [string[]]$NodeName = 'localhost',\n\n        [Parameter(Mandatory)]\n        [string]$HostName,\n\n        [Parameter(Mandatory)]\n        [string]$IPAddress,\n\n        [Parameter(Mandatory)]\n        [string]$ZoneName,\n\n        [Parameter(Mandatory)]\n        [string]$DnsServer,\n\n        [Parameter(Mandatory)]\n        [pscredential]$Credential,\n\n        [int]$TTL,\n\n        [bool]$CreatePtr,\n\n        [bool]$AllowUpdateAny,\n\n        [bool]$AgeRecord\n    )\n\n    Import-DscResource -Name ARecord -ModuleName POSHOrigin_ActiveDirectoryDNS\n\n    Node $NodeName {\n        ARecord \"Create$HostName\" {\n            Ensure = 'Present'\n            Name = $HostName\n            IPAddress = $IPAddress\n            ZoneName = $ZoneName\n            DnsServer = $DnsServer\n            Credential = $Credential\n            TTL = $TTL\n            CreatePtr = $CreatePtr\n            AllowUpdateAny = $AllowUpdateAny\n            AgeRecord = $AgeRecord\n        }\n    }\n}\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevblackops%2Fposhorigin_activedirectorydns","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevblackops%2Fposhorigin_activedirectorydns","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevblackops%2Fposhorigin_activedirectorydns/lists"}