New-CMCertificateProfileScep
创建 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>] 说明
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 证书，并将证书存储设置为“用户”。
参数
-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) 。 有效值包含:
- None
- 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
指定将通过 SCEP 颁发证书的网络设备注册服务 (NDES) 服务器的 URL 数组。
| 类型: | 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