API de gestão no SCEPmanClient

Use Find-SCEPmanCertificate para pesquisar certificados emitidos no SCEPman e Revoke-SCEPmanCertificate para revogar um certificado quando ele já não for confiável ou já não for necessário.

Requisitos

Antes de poder pesquisar ou revogar certificados, certifique-se de que a sua identidade tem a Manage.All função.

Certifique-se também de ter configurado os pré-requisitos gerais para o uso do SCEPmanClient: https://app.gitbook.com/o/-LhPlvZ6dc8XcqY7tdZw/s/-LoGejQeUQcw7lqnQ3WX/~/edit/~/changes/863/certificate-management/api-certificates/scepmanclient#prerequisites

Se você atualizar a partir de uma versão anterior do SCEPman, talvez ainda não tenha a função Manage.All. Execute Complete-SCEPmanInstallation novamente em um shell de nuvem para adicioná-la automaticamente à sua aplicação SCEPman-api.

Encontrar certificados

Use Find-SCEPmanCertificate para pesquisar certificados pelo número de série, assunto ou solicitante.

Se for encontrado pelo menos um certificado, é retornado um objeto semelhante à seguinte estrutura JSON:

{
  "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": "..."
}

Exemplo: encontrar um único certificado pelo número de série

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

Entender resultados paginados

Se o conjunto de resultados for grande, Find-SCEPmanCertificate pode retornar um token de continuação. Use esse token para solicitar a próxima página.

Exemplo: primeira página com token de continuação

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

Exemplo de saída:

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

Exibir os certificados retornados em detalhe

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

Exemplo de saída:

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

Solicite a próxima página com o token de continuação

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

Exemplo de saída:

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

Revogar um certificado

Use Revoke-SCEPmanCertificate para revogar um certificado pelo seu número de série que foi emitido anteriormente.

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

Exemplo: encontrar um certificado e revogá-lo

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

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

Exemplo de saída:

Revoke-SCEPmanCertificate: Certificado 480552CEBBE40FD5D4417532033728F353040000 revogado com sucesso.