Fehlerbehebung · 15.9
Fehlerbehebung: PowerShell-Modul
Das Modul braucht Windows PowerShell 5.1 oder neuer und verbindet sich mit der Management-API, standardmässig http://127.0.0.1:5188, siehe Kapitel Modul importieren und Verbindung prüfen.
| Symptom | Ursache | Lösung |
|---|---|---|
| TLSPilot: this cmdlet requires an elevated PowerShell (Run as administrator). | Das Cmdlet liest den Schlüssel der Management-API, wofür Administratorrechte nötig sind. | Starten Sie PowerShell mit Run as administrator. |
| TLSPilot API error (<method> <path>): <detail> | Die Management-API hat einen Fehler zurückgegeben oder ist nicht erreichbar. | Prüfen Sie, ob der Management-Dienst läuft. Läuft er nicht auf diesem Host, setzen Sie die Adresse mit Set-TLSPilotBaseUrl oder der Umgebungsvariable TLSPILOT_URL. |
| TLSPilot: the current operator is not allowed to <action>. | Ihre RBAC-Rolle erlaubt diese Aktion nicht. | Bitten Sie einen Owner um die benötigte Rolle. |
| TLSPilot: /api/me is unavailable; write refused. | Das Modul konnte Ihre Berechtigungen nicht ermitteln und verweigert deshalb Änderungen. | Prüfen Sie die Verbindung zur Management-API und versuchen Sie es erneut. |
| Start-TLSPilotCycle -Wait timed out after <n> seconds. | Der Zyklus dauerte länger als die Wartezeit. | Erhöhen Sie -TimeoutSeconds oder prüfen Sie den Fortschritt mit Get-TLSPilotLog. |
| Customer activation is One-Time Key only. Use Unlock-TLSPilotLicense. | Eine Lizenzdatei lässt sich nicht direkt importieren. | Aktivieren Sie die Lizenz mit Unlock-TLSPilotLicense und dem Einmalschlüssel. |
| Set-TLSPilotCredential: -Secret is required when creating a credential. | Ein neues Credential braucht ein Secret. | Übergeben Sie das Secret mit -Secret als SecureString. |