SCEPmanClient の管理 API

使用する Find-SCEPmanCertificate SCEPman で発行済み証明書を検索し、 Revoke-SCEPmanCertificate 証明書がもはや信頼されない、または不要になったときに失効するために。

要件

証明書を検索または失効する前に、あなたの ID に次の権限があることを確認してください: Manage.All ロール。

SCEPmanClient の使用に必要な一般的な前提条件が設定されていることも確認してください: https://app.gitbook.com/o/-LhPlvZ6dc8XcqY7tdZw/s/-LoGejQeUQcw7lqnQ3WX/~/edit/~/changes/863/certificate-management/api-certificates/scepmanclient#prerequisites

以前の SCEPman バージョンから更新した場合、まだ Manage.All ロールを持っていない可能性があります。 Complete-SCEPmanInstallation を Cloud Shell で再度実行して、それを SCEPman-api アプリケーションに自動的に追加してください。

証明書を検索

使用する Find-SCEPmanCertificate シリアル番号、サブジェクト、または要求者で証明書を検索するために。

少なくとも 1 件の証明書が見つかった場合、次の 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": "..."
}

例: シリアル番号で単一の証明書を検索する

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

ページングされた結果を理解する

結果セットが大きい場合、 Find-SCEPmanCertificate 継続トークンを返すことがあります。このトークンを使用して次のページを要求します。

例: 継続トークン付きの最初のページ

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

出力例:

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

返された証明書を詳細に表示する

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

出力例:

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

継続トークンで次のページを要求する

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

出力例:

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

証明書を失効する

使用する Revoke-SCEPmanCertificate 以前に発行された証明書をシリアル番号で失効するために。

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

例: 証明書を検索して失効する

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

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

出力例:

Revoke-SCEPmanCertificate: 証明書 480552CEBBE40FD5D4417532033728F353040000 が正常に失効されました。