PowerShell-Modul · 17.6

CNAME-Records des DNS-01 Alias Mode auflisten und prüfen

Zwei Befehle helfen Ihnen, die CNAME-Records für den DNS-01 Alias Mode vorzubereiten, bevor Sie das Zertifikat erstellen, oder sie an das Team zu übergeben, das die Produktivzone verwaltet. Beide arbeiten lokal und rufen die Management API nicht auf; sie brauchen deshalb keine Berechtigung in TLSPilot.

Get-TLSPilotDnsAliasRecords listet die CNAME-Records auf. Er fragt kein DNS ab. Ein Wildcard-Name *.<domain> zählt als <domain>, und doppelte Namen erscheinen nur einmal:

Get-TLSPilotDnsAliasRecords -Domain 'shop.example.com','www.example.org' `
    -DnsAliasDomain 'servicedomain.net'

Jedes Ergebnis hat die Eigenschaften Name, Owner (der CNAME-Record in der Produktivzone, _acme-challenge.<name>) und Target (_acme-challenge.<name>.<alias domain>).

Test-TLSPilotDnsAliasRecords prüft jeden Record bei den öffentlichen Resolvern von Cloudflare und Google über DNS over HTTPS, wie TLSPilot es vor jeder Bestellung tut:

Test-TLSPilotDnsAliasRecords -Domain 'shop.example.com','www.example.org' `
    -DnsAliasDomain 'servicedomain.net' | Format-Table Owner, Ok, Message

Er ergänzt die Eigenschaften Ok und Message. Die Meldungen:

Meldungen von Test-TLSPilotDnsAliasRecords
Meldung	Bedeutung
CNAME _acme-challenge.<name> points at <target>.	Der Record ist korrekt (`Ok` ist `True`).
… is missing. It must point at <target>. Fresh CNAMEs can stay hidden for a few minutes because of negative caching.	Kein CNAME-Record gefunden.
… points at <other name>, expected <target>.	Der CNAME-Record hat das falsche Ziel.
… has more than one CNAME. Keep a single CNAME to <target>.	Mehrere CNAME-Records unter demselben Namen.
… has a TXT record at the same name. Remove it before the order.	Neben dem CNAME-Record existiert ein TXT-Record.
… could not check. No DNS-over-HTTPS resolver answered.	Keiner der Resolver hat geantwortet, zum Beispiel weil ausgehendes HTTPS blockiert ist. Der Zustand des Records ist unbekannt.