Management-API in SCEPmanClient

Verwenden Sie Find-SCEPmanCertificate zum Suchen nach ausgestellten Zertifikaten in SCEPman und Revoke-SCEPmanCertificate zum Widerrufen eines Zertifikats, wenn es nicht mehr vertrauenswürdig oder nicht mehr benötigt wird.

Voraussetzungen

Bevor Sie nach Zertifikaten suchen oder Zertifikate widerrufen können, stellen Sie sicher, dass Ihre Identität die Manage.All Rolle hat.

Stellen Sie außerdem sicher, dass die allgemeinen Voraussetzungen für die Verwendung von SCEPmanClient eingerichtet sind: https://app.gitbook.com/o/-LhPlvZ6dc8XcqY7tdZw/s/-LoGejQeUQcw7lqnQ3WX/~/edit/~/changes/863/certificate-management/api-certificates/scepmanclient#prerequisites

Wenn Sie von einer früheren SCEPman-Version aktualisieren, verfügen Sie möglicherweise noch nicht über die Rolle Manage.All. Führen Sie Complete-SCEPmanInstallation erneut in einer Cloud Shell aus, um sie automatisch zu Ihrer SCEPman-api-Anwendung hinzuzufügen.

Zertifikate finden

Verwenden Sie Find-SCEPmanCertificate zum Suchen nach Zertifikaten anhand ihrer Seriennummer, ihres Betreffs oder Anforderers.

Wenn mindestens ein Zertifikat gefunden wird, wird ein Objekt zurückgegeben, das der folgenden JSON-Struktur ähnelt:

{
  "items": [
    {
    "serialNumber":  "507AEAC03CCEF83F106914418D9222E466A629C1",
    "subject":  "CN=device01.contoso.local",
    "sans":  null,
    "upn":  null,
    "issuanceDate":  "2026-05-28T10:57:22Z",
    "expirationDate":  "2028-05-28T10:57:22Z",
    "revocationDate":  null,
    "revocationReason":  null,
    "revokedBy":  null,
    "requester":  "[e-mail]",
    "source":  "CertificateMaster",
    "certificateType":  "Static"
    }
  ],
  "continuationToken": "..."
}

Beispiel: Ein einzelnes Zertifikat anhand der Seriennummer finden

Find-SCEPmanCertificate -Url scepman.conitoso.com `
    -SearchText '5056BB9B823132CB26210A4C90A62FB3C25E38D0' `
    | Select-Object -ExpandProperty items

serialNumber     : 5056BB9B823132CB26210A4C90A62FB3C25E38D0
subject          : CN=[e-mail]
sans             : [e-mail]
upn              : [e-mail]
issuanceDate     : 2026-05-28T11:06:11Z
expirationDate   : 2028-05-28T11:06:11Z
revocationDate   :
revocationReason :
revokedBy        :
requester        : [e-mail]
source           : CertificateMaster
certificateType  : Static

Paged-Ergebnisse verstehen

Wenn der Ergebnissatz groß ist, Find-SCEPmanCertificate kann ein Fortsetzungstoken zurückgeben. Verwenden Sie dieses Token, um die nächste Seite anzufordern.

Beispiel: Erste Seite mit Fortsetzungstoken

$result = Find-SCEPmanCertificate -Url scepman.contoso.com -SearchText "CN=device"
$result

Beispielausgabe:

ContinuationToken : 1!48!ODY2OURBN0QtQzk0My00QjU3LUI5OEYtNzA5RjY5MDlCRDkw
Items             : {@{serialNumber=60B26DD32CF07F30D6760848A5233CBAE90DCDBC; subject=CN=device01.contoso.local},
                    @{serialNumber=50F1754E85238752527C3140ABD0CEF2C7DC9439; subject=CN=device02.contoso.local}}

Zur Anzeige der zurückgegebenen Zertifikate im Detail

$result = Find-SCEPmanCertificate -Url scepman.contoso.com -SearchText "CN=device"
$result.Items

Beispielausgabe:

serialNumber                             subject
------------                             -------
60B26DD32CF07F30D6760848A5233CBAE90DCDBC CN=device01.contoso.local
50F1754E85238752527C3140ABD0CEF2C7DC9439 CN=device02.contoso.local

Fordern Sie die nächste Seite mit dem Fortsetzungstoken an

$firstPage = Find-SCEPmanCertificate -Url scepman.contoso.com -SearchText "CN=device"
$nextPage = Find-SCEPmanCertificate -Url scepman.contoso.com -ContinuationToken $firstPage.ContinuationToken
$nextPage.Items

Beispielausgabe:

serialNumber                             subject
------------                             -------
5048D2541F7F401C42B7E943A7C82FB37A179F83 CN=device03.contoso.local
50BCCDA973AEEA55E00FAF4A9A088DFB7564F263 CN=device04.contoso.local

Ein Zertifikat widerrufen

Verwenden Sie Revoke-SCEPmanCertificate zum Widerrufen eines zuvor ausgestellten Zertifikats anhand seiner Seriennummer.

Revoke-SCEPmanCertificate -SerialNumber "480552CEBBE40FD5D4417532033728F353040000" -RevocationReason CessationOfOperation

Beispiel: Ein Zertifikat finden und widerrufen

$result= Find-SCEPmanCertificate -Url scepman.contoso.com -SearchText "480552CEBBE40FD5D4417532033728F353040000"
$cert = $result.items

Revoke-SCEPmanCertificate -SerialNumber $cert.Items[0].serialNumber

Beispielausgabe:

Revoke-SCEPmanCertificate: Zertifikat 480552CEBBE40FD5D4417532033728F353040000 erfolgreich widerrufen.