Zum Inhalt

Knowledge Base · Kategorie 17

PowerShell-Modul

14 Artikel

TLSPilot enthält ein eigenes PowerShell-Modul, das auf demselben Host wie TLSPilot installiert wird, dem Management-Host.

Kapitelübersicht

Das Modul ist für unbeaufsichtigte Automatisierung gebaut, etwa geplante Aufgaben, CI/CD-Pipelines, Runbooks und Monitoring-Probes. Aufgaben, die Sie einmalig mit einem Formular vor sich erledigen, etwa Tenants erstellen, Alert-Kanäle konfigurieren, Rollen zuweisen oder ein Backup wiederherstellen, bleiben in der Desktop Admin Console und der WebUI. Das Modul exportiert die in Tabelle Befehle des PowerShell-Moduls aufgeführten Befehle. Jeder Befehl läuft unter dem Windows-Konto, mit dem Sie angemeldet sind; Ihre TLSPilot-Rolle entscheidet also, was Sie tun dürfen, siehe Kapitel RBAC.

Artikel in dieser Kategorie

  1. 17.1

    Voraussetzungen

    Um das Modul zu verwenden, müssen folgende Voraussetzungen erfüllt sein:

  2. 17.2

    Modul importieren und Verbindung prüfen

    Importieren Sie das Modul und prüfen Sie, ob der Management-Dienst antwortet:

  3. 17.3

    Befehle und ihre Hilfe finden

    Alle Befehle folgen der PowerShell-Konvention Verb-Nomen und enthalten eine vollständige Hilfe mit Beispielen:

  4. 17.4

    Health, Lizenz und Logs prüfen

    Befehle mit dem Parameter -CertificateId sowie -Id der Zertifikatsbefehle erwarten die ID des Zertifikats, nicht seinen Namen.

  5. 17.5

    Zertifikat erstellen und Deployment hinzufügen

    Erstellen Sie zuerst das Zertifikat und fügen Sie ihm dann ein oder mehrere Deployments hinzu.

  6. 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.

  7. 17.7

    Zertifikat erneuern und Zyklus ausführen

    TLSPilot erneuert ein Zertifikat zu seinem geplanten Zeitpunkt und verteilt es im nächsten Zyklus, siehe Kapitel Automatisch erneuern.

  8. 17.8

    Zertifikat exportieren

    Manche Systeme lassen sich mit einem Deployment nicht erreichen und brauchen das Schlüsselmaterial als Datei. -OutFile schreibt die Datei.

  9. 17.9

    Nach einem Vorfall zurückrollen oder widerrufen

    TLSPilot bewahrt frühere Versionen eines Zertifikats auf. Verursacht ein neues Zertifikat ein Problem, listen Sie die Versionen auf und aktivieren eine frühere:

  10. 17.10

    Credential rotieren

    Credentials sind die eine Einstellung, die regelmässig per Skript geändert wird.

  11. 17.11

    Backups zeitgesteuert erstellen

    Ein nächtliches Backup ist eine typische geplante Aufgabe:

  12. 17.12

    Private-CA-Zertifikat und CRL verteilen

    Jeder Client, der Zertifikaten der integrierten Private CA vertrauen soll, braucht das CA-Zertifikat und idealerweise auch die Zertifikatssperrliste.

  13. 17.13

    Befehlsreferenz

    Die folgende Tabelle listet alle Befehle des Moduls auf, was sie tun und welche Berechtigung sie voraussetzen.

  14. 17.14

    Grenzen und Sicherheitshinweise

    Manche Aufgaben sind bewusst der Benutzeroberfläche vorbehalten, und manche Befehle lassen sich nicht rückgängig machen: