共用方式為

New-CMCertificateProfileScep

  • 參考
模組:
ConfigurationManager

建立 SCEP 憑證配置檔。

語法

New-CMCertificateProfileScep
   [-AllowCertificateOnAnyDevice <Boolean>]
   [-CertificateStore <CertificateStoreType>]
   -CertificateTemplateName <String>
   -CertificateValidityDays <Int32>
   [-Description <String>]
   -Eku <Hashtable>
   [-EnrollmentRenewThresholdPct <Int32>]
   [-EnrollmentRetryCount <Int32>]
   [-EnrollmentRetryDelayMins <Int32>]
   -HashAlgorithm <HashAlgorithmTypes>
   [-KeySize <Int32>]
   [-KeyStorageProvider <KeyStorageProviderSettingType>]
   -KeyUsage <X509KeyUsageFlags>
   -Name <String>
   [-RequireMultifactor]
   -RootCertificate <IResultObject>
   -SanType <SubjectAlternativeNameFormatTypes>
   [-ScepServerUrl <String[]>]
   [-SubjectType <SubjectNameFormatTypes>]
   -SupportedPlatform <IResultObject[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-CMCertificateProfileScep Cmdlet 會建立簡單的憑證註冊通訊協定 (SCEP) 憑證配置檔。

注意：您必須先建立受信任的 CA 憑證配置檔，才能建立 SCEP 憑證配置檔。 如需建立受信任 CA 憑證配置檔的資訊，請參閱 New-CMCertificateProfileTrustedRootCA Cmdlet。

注意事項

從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。

範例

範例 1：建立 SCEP 憑證配置檔

PS XYZ:\> New-CMCertificateProfileScep -CertificateTemplateName "TestTemplate01" -CertificateValidityDays 10 -Eku @{ "name1" ="1.2.3.4"; "name2" = "1.2.3.4.5" } -HashAlgorithm SHA2 -KeyUsage KeyEncipherment -Name "TestSCEPProf01" -RootCertificate (New-CMCertificateProfileTrustedRootCA -Name testing -Path "\\Server\Sharefolder\RootCA.cer" -SupportedPlatform (Get-CMSupportedPlatform  -Fast -Name "All Windows 10*Client")) -SanType SubjectAltReqiureEmail -SupportedPlatform (Get-CMSupportedPlatform  -Fast -Name "All Windows 10*Client")

此命令會建立受信任的根 CA 憑證，並取得所有 Windows 10 用戶端支持的平臺。 命令接著會使用新建立的受信任根 CA 憑證來建立 SEP 憑證配置檔。

範例 2：建立 SCEP 憑證配置檔，並將證書存儲設定為使用者

PS XYZ:\> New-CMCertificateProfileScep -CertificateTemplateName "TestTemplate02" -CertificateValidityDays 10 -Eku @{ "name1" ="1.2.3.4"; "name2" = "1.2.3.4.5" } -HashAlgorithm ShA1 -KeyUsage Digitalsignature -Name "TestSCEPProf02" -RootCertificate (New-CMCertificateProfileTrustedRootCA -Name testingSecond -Path "\\Server\Sharefolder\RootCA.cer" -SupportedPlatform (Get-CMSupportedPlatform  -Fast -Name "All Windows 10*Client")) -SupportedPlatform (Get-CMSupportedPlatform -Fast -Name "All Windows 10*Client") -CertificateStore User -Description "Test description" -EnrollmentRenewThresholdPct 2 -EnrollmentRetryCount 5 -EnrollmentRetryDelayMins 7 -KeySize 2048 -KeyStorageProvider InstallToTPM_FailIfNotPresent -RequireMultiFactor -SubjectType SubjectRequireEmail -SanType SubjectAltReqiureEmail

此命令會建立受信任的根 CA 憑證，並取得所有 Windows 10 用戶端支持的平臺。 然後命令會使用新建立的根 CA 憑證建立 SCEP 憑證，並將證書存儲設定為 User。

參數

-AllowCertificateOnAnyDevice

指出是否允許在任何裝置上註冊憑證。

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-CertificateStore

指定憑證類型。 有效值為：

  • 機器
  • 使用者
類型:CertificateStoreType
接受的值:Machine, User
Position:Named
預設值:User
必要:False
接受管線輸入:False
接受萬用字元:False

-CertificateTemplateName

指定證書範本的名稱。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-CertificateValidityDays

指定憑證有效期間的天數。

類型:Int32
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Confirm

執行 Cmdlet 之前提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-Description

指定 SCEP 憑證設定檔的描述。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DisableWildcardHandling

此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Eku

指定擴充金鑰使用方式。 哈希表中的值會定義憑證的預定用途。

類型:Hashtable
別名:Ekus
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-EnrollmentRenewThresholdPct

指定在裝置要求更新憑證之前，保留的憑證存留期百分比。

類型:Int32
Position:Named
預設值:20
必要:False
接受管線輸入:False
接受萬用字元:False

-EnrollmentRetryCount

指定裝置自動向執行網路裝置註冊服務的伺服器重試憑證要求的次數。

類型:Int32
Position:Named
預設值:3
必要:False
接受管線輸入:False
接受萬用字元:False

-EnrollmentRetryDelayMins

指定當您在發行 CA 處理憑證要求之前使用 CA 管理員核准時，每個註冊嘗試之間的間隔，以分鐘為單位。

類型:Int32
Position:Named
預設值:1
必要:False
接受管線輸入:False
接受萬用字元:False

-ForceWildcardHandling

此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-HashAlgorithm

指定一或多個哈希演算法。 有效值為：

  • SHA1
  • SHA2
  • SHA3
類型:HashAlgorithmTypes
別名:HashAlgorithms
接受的值:SHA1, SHA2, SHA3
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-KeySize

指定金鑰的大小。 有效值為：

  • 1024
  • 2048
類型:Int32
接受的值:1024, 2048, 4096
Position:Named
預設值:2048
必要:False
接受管線輸入:False
接受萬用字元:False

-KeyStorageProvider

指定 SCEP 註冊的金鑰儲存提供者 (KSP) 。 有效值為：

  • 無
  • InstallToTPM_FailIfNotPresent
  • InstallToTPM_IfPresent
  • InstallToSoftwareKeyStorageProvider
  • InstallToNGC_FailIfNotPresent
類型:KeyStorageProviderSettingType
接受的值:None, InstallToTPM_FailIfNotPresent, InstallToTPM_IfPresent, InstallToSoftwareKeyStorageProvider, InstallToNGC_FailIfNotPresent
Position:Named
預設值:InstallToTPM_IfPresent
必要:False
接受管線輸入:False
接受萬用字元:False

-KeyUsage

指定憑證的一或多個密鑰使用方式。 有效值為：

  • KeyEncipherment
  • DigitalSignature
類型:X509KeyUsageFlags
接受的值:KeyEncipherment, DigitalSignature
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Name

指定 SCEP 憑證設定檔的名稱。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-RequireMultifactor

指出在裝置註冊期間需要多重要素驗證，才能向這些裝置頒發憑證。 當為 KeyStorageProvider 參數設定InstallToNGC_FailIfNotPresent值時，可以使用此參數。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-RootCertificate

指定受信任的根 CA 憑證物件。 若要取得受信任的根 CA 憑證，請使用 Get-CMCertificateProfileTrustedRootCA 函式。

類型:IResultObject
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-SanType

指定一或多個主體別名。 有效值為：

  • SubjectAltRequireSpn
  • SubjectAltRequireUpn
  • SubjectAltReqiureEmail
  • SubjectAltRequireDns
類型:SubjectAlternativeNameFormatTypes
別名:SanTypes
接受的值:SubjectAltRequireCustom, SubjectAltRequireSpn, SubjectAltRequireAAD, SubjectAltRequireUpn, SubjectAltReqiureEmail, SubjectAltRequireDns
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-ScepServerUrl

指定網路裝置註冊服務 (NDES) 伺服器的 URL 陣列，這些伺服器會透過 SCEP 發行憑證。

類型:String[]
別名:ScepServerUrls
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-SubjectType

指定主體名稱格式。 有效值為：

  • SubjectRequireCommonNameAsEmail
  • SubjectRequireCommonNameAsDeviceName
  • SubjectRequireCommonNameAsOSName
  • SubjectRequireCommonNameAsIMEI
  • SubjectRequireCommonNameAsMEID
  • SubjectRequireCommonNameAsSerialNumber
  • SubjectRequireCommonNameAsDeviceType
  • SubjectRequireCommonNameAsWiFiMAC
  • SubjectRequireCommonNameAsEthernetMAC
  • SubjectRequireAsCustomString
  • SubjectRequireDnsAsCN
  • SubjectRequireEmail
  • SubjectRequireCommonName
  • SubjectRequireDirectoryPath
類型:SubjectNameFormatTypes
別名:SubjectTypes
接受的值:SubjectRequireCommonNameAsEmail, SubjectRequireCommonNameAsDeviceName, SubjectRequireCommonNameAsOSName, SubjectRequireCommonNameAsIMEI, SubjectRequireCommonNameAsMEID, SubjectRequireCommonNameAsSerialNumber, SubjectRequireCommonNameAsDeviceType, SubjectRequireCommonNameAsWiFiMAC, SubjectRequireCommonNameAsEthernetMAC, SubjectRequireAsCustomString, SubjectRequireDnsAsCN, SubjectRequireEmail, SubjectRequireCommonName, SubjectRequireDirectoryPath
Position:Named
預設值:SubjectRequireCommonName
必要:False
接受管線輸入:False
接受萬用字元:False

-SupportedPlatform

指定支援的平台物件。 若要取得支持的平台物件，請使用 Get-CMSupportedPlatform Cmdlet。

類型:IResultObject[]
別名:SupportedPlatforms
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

None

輸出

IResultObject