Health, Lizenz und Logs prüfen

Befehle mit dem Parameter -CertificateId sowie -Id der Zertifikatsbefehle erwarten die ID des Zertifikats, nicht seinen Namen. TLSPilot vergibt diese ID beim Erstellen des Zertifikats. Lesen Sie sie einmal aus und geben Sie sie weiter:

$id = (Get-TLSPilotCertificate -Id 'web01.example.com').certificateId

Get-TLSPilotCertificate -Id akzeptiert die ID oder den Namen. New-TLSPilotCertificate gibt das neue Zertifikat mit seiner ID in der Eigenschaft id zurück, zum Beispiel $cert.id in Kapitel Zertifikat erstellen und Deployment hinzufügen.

Das Modul enthält zwei Health-Befehle. Get-TLSPilotApiHealth prüft, ob der Management-Dienst selbst läuft. Test-TLSPilotHealth prüft, ob die von TLSPilot verwalteten Zertifikate auf ihren Zielen tatsächlich verwendet werden. Er führt dieselbe Prüfung aus wie die Desktop Admin Console.

Get-TLSPilotApiHealth
Test-TLSPilotHealth
Test-TLSPilotHealth -CertificateId $id

Für eine Monitoring-Probe reduziert -Quiet das Ergebnis auf ein einzelnes true oder false. So schlägt die Probe fehl, sobald TLSPilot ein fehlerhaftes Zertifikat meldet:

if (-not (Test-TLSPilotHealth -Quiet)) {
    throw 'TLSPilot reports an unhealthy certificate'
}

Get-TLSPilotOperation zeigt, ob TLSPilot gerade beschäftigt ist. Prüfen Sie das, bevor Sie eigene Arbeiten starten. Get-TLSPilotLog liefert das Operational-, Audit- oder Debug-Log:

Get-TLSPilotOperation
Get-TLSPilotLog -Kind audit -Take 50

Das Audit-Log (-Kind audit) setzt die Berechtigung canManageRbac voraus. Mit dem Standard -Kind all werden die Audit-Einträge für andere Benutzer weggelassen.

Get-TLSPilotLicense zeigt die Lizenz, einschliesslich der Anzahl belegter Zertifikats-Seats. Invoke-TLSPilotLicenseCheck führt die Online-Prüfung aus und aktualisiert die lokale Lease. Dieser Befehl zeigt, ob das Ausstellen gerade blockiert ist, zum Beispiel weil die Lizenz auf einem anderen Management-Host verwendet wird.

Get-TLSPilotLicense
Invoke-TLSPilotLicenseCheck