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>]

说明

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

通过

New-CMCertificateProfileScep

语法

说明

示例

示例 1：创建 SCEP 证书配置文件

示例 2：创建 SCEP 证书配置文件并将证书存储设置为“用户”

参数

-AllowCertificateOnAnyDevice

-CertificateStore

-CertificateTemplateName

-CertificateValidityDays

-Confirm

-Description

-DisableWildcardHandling

-Eku

-EnrollmentRenewThresholdPct

-EnrollmentRetryCount

-EnrollmentRetryDelayMins

-ForceWildcardHandling

-HashAlgorithm

-KeySize

-KeyStorageProvider

-KeyUsage

-Name

-RequireMultifactor

-RootCertificate

-SanType

-ScepServerUrl

-SubjectType

-SupportedPlatform

-WhatIf

输入

输出

反馈

其他资源

通过

New-CMCertificateProfileScep

语法

说明

示例

示例 1：创建 SCEP 证书配置文件

示例 2：创建 SCEP 证书配置文件并将证书存储设置为“用户”

参数

-AllowCertificateOnAnyDevice

-CertificateStore

-CertificateTemplateName

-CertificateValidityDays

-Confirm

-Description

-DisableWildcardHandling

-Eku

-EnrollmentRenewThresholdPct

-EnrollmentRetryCount

-EnrollmentRetryDelayMins

-ForceWildcardHandling

-HashAlgorithm

-KeySize

-KeyStorageProvider

-KeyUsage

-Name

-RequireMultifactor

-RootCertificate

-SanType

-ScepServerUrl

-SubjectType

-SupportedPlatform

-WhatIf

输入

输出

相关链接

反馈

其他资源