Set-CMCertificateProfileScep

Ссылка

Модуль:: ConfigurationManager

Задает профиль сертификата SCEP.

Синтаксис

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

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

Set-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>
   [-NewName <String>]
   [-PassThru]
   [-RequireMultifactor <Boolean>]
   [-RootCertificate <IResultObject>]
   [-SanType <SubjectAlternativeNameFormatTypes>]
   [-ScepServerUrl <String[]>]
   [-SubjectType <SubjectNameFormatTypes>]
   [-SupportedPlatform <IResultObject[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Командлет Set-CMCertificateProfileScep обновляет параметры профиля сертификата SCEP.

Примечание.

Выполните командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

Пример 1. Настройка профиля сертификата SCEP по имени

PS XYZ:\> Set-CMCertificateProfileScep -Name "TestProfile01" -CertificateStore Machine -Description "Test update" -HashAlgorithm SHA3 -KeySize 1024 -KeyUsage KeyEncipherment -NewName "TestProfile01_updated" -SanType SubjectAltRequireDns

Эта команда обновляет профиль сертификата SEP с именем TestProfile01 и присваивает ему новое имя TestProfile01_updated.

Пример 2. Настройка профиля сертификата SCEP с помощью конвейера

PS XYZ:\> Get-CMCertificateProfileScep -Name "TestProfile02" -Fast | Set-CMCertificateProfileScep -AllowCertificateOnAnyDevice $True -KeyStorageProvider InstallToNGC_FailIfNotPresent

Эта команда получает объект профиля сертификата SEP с именем TestProfile02 и использует оператор конвейера для передачи объекта в Set-CMCertificateProfileScep, который обновляет параметры объекта профиля.

Параметры

-AllowCertificateOnAnyDevice

Указывает, следует ли разрешать регистрацию сертификатов на любом устройстве.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateStore

Указывает тип сертификата. Допустимые значения:

Компьютер
User

Type:	CertificateStoreType
Accepted values:	Machine, User
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateTemplateName

Указывает имя шаблона сертификата.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateValidityDays

Указывает в количестве дней срок действия сертификата.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Перед запуском командлет запросит подтверждение.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Указывает описание профиля сертификата SCEP.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Eku

Указывает расширенное использование ключа. Значения в хэш-таблице определяют назначение сертификата.

Type:	Hashtable
Aliases:	Ekus
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnrollmentRenewThresholdPct

Указывает процент времени существования сертификата, который остается до того, как устройство запросит продление сертификата.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnrollmentRetryCount

Указывает количество автоматически повторяющихся попыток устройства для запроса сертификата на сервер, на котором запущена служба регистрации сетевых устройств.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnrollmentRetryDelayMins

Указывает интервал (в минутах) между каждой попыткой регистрации при использовании утверждения диспетчера ЦС до того, как выдающий ЦС обработает запрос сертификата.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HashAlgorithm

Указывает хэш-алгоритм. Допустимые значения:

SHA1
SHA2
SHA3
Ни один

Type:	HashAlgorithmTypes
Aliases:	HashAlgorithms
Accepted values:	NONE, SHA1, SHA2, SHA3
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

Указывает CI_ID профиля сертификата SCEP.

Type:	Int32
Aliases:	CI_ID, CIId
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Указывает объект профиля сертификата SCEP. Чтобы получить объект профиля сертификата SCEP, используйте функцию Get-CMCertificateProfileScep.

Type:	IResultObject
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-KeySize

Задает размер ключа. Допустимые значения:

1024
2048

Type:	Int32
Accepted values:	1024, 2048, 4096
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-KeyStorageProvider

Указывает поставщика хранилища ключей (KSP) для регистрации SCEP. Допустимые значения:

Нет
InstallToTPM_FailIfNotPresent
InstallToTPM_IfPresent
InstallToSoftwareKeyStorageProvider
InstallToNGC_FailIfNotPresent

Type:	KeyStorageProviderSettingType
Accepted values:	None, InstallToTPM_FailIfNotPresent, InstallToTPM_IfPresent, InstallToSoftwareKeyStorageProvider, InstallToNGC_FailIfNotPresent
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-KeyUsage

Указывает использование ключа для сертификата. Допустимые значения:

KeyEncipherment
DigitalSignature
Нет
EncipherOnly
CrlSign
KeyCertSign
KeyAgreement
DataEncipherment
Неотречение
РасшифровкаOnly

Type:	X509KeyUsageFlags
Aliases:	KeyUsages
Accepted values:	KeyEncipherment, DigitalSignature
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Указывает имя профиля сертификата SCEP.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NewName

Задает новое имя для профиля сертификата SCEP.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

Добавьте этот параметр, чтобы вернуть объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не может создавать выходные данные.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RequireMultifactor

Указывает, что при регистрации устройств требуется многофакторная проверка подлинности перед выдачей сертификатов этим устройствам. Этот параметр можно использовать, если для параметра KeyStorageProvider задано значение InstallToNGC_FailIfNotPresent.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RootCertificate

Указывает объект сертификата доверенного корневого ЦС. Чтобы получить доверенный корневой сертификат ЦС, используйте функцию Get-CMCertificateProfileTrustedRootCA.

Type:	IResultObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SanType

Задает альтернативное имя субъекта. Допустимые значения:

SubjectAltRequireSpn
SubjectAltRequireUpn
SubjectAltReqiureEmail
SubjectAltRequireDns

Type:	SubjectAlternativeNameFormatTypes
Aliases:	SanTypes
Accepted values:	SubjectAltRequireCustom, SubjectAltRequireSpn, SubjectAltRequireAAD, SubjectAltRequireUpn, SubjectAltReqiureEmail, SubjectAltRequireDns
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ScepServerUrl

Задает массив URL-адресов для серверов службы регистрации сетевых устройств (NDES), которые будут выдавать сертификаты через SCEP.

Type:	String[]
Aliases:	ScepServerUrls
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SubjectType

Задает формат имени субъекта. Допустимые значения:

SubjectRequireCommonNameAsEmail
SubjectRequireCommonNameAsDeviceName
SubjectRequireCommonNameAsOSName
SubjectRequireCommonNameAsIMEI
SubjectRequireCommonNameAsMEID
SubjectRequireCommonNameAsSerialNumber
SubjectRequireCommonNameAsDeviceType
SubjectRequireCommonNameAsWiFiMAC
SubjectRequireCommonNameAsEthernetMAC
SubjectRequireAsCustomString
SubjectRequireDnsAsCN
SubjectRequireEmail
SubjectRequireCommonName
SubjectRequireDirectoryPath

Type:	SubjectNameFormatTypes
Aliases:	SubjectTypes
Accepted values:	SubjectRequireCommonNameAsEmail, SubjectRequireCommonNameAsDeviceName, SubjectRequireCommonNameAsOSName, SubjectRequireCommonNameAsIMEI, SubjectRequireCommonNameAsMEID, SubjectRequireCommonNameAsSerialNumber, SubjectRequireCommonNameAsDeviceType, SubjectRequireCommonNameAsWiFiMAC, SubjectRequireCommonNameAsEthernetMAC, SubjectRequireAsCustomString, SubjectRequireDnsAsCN, SubjectRequireEmail, SubjectRequireCommonName, SubjectRequireDirectoryPath
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SupportedPlatform

Указывает поддерживаемый объект платформы. Чтобы получить поддерживаемый объект платформы, используйте командлет Get-CMSupportedPlatform.

Type:	IResultObject[]
Aliases:	SupportedPlatforms
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Входные данные

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Выходные данные

IResultObject

Set-CMCertificateProfileScep

Синтаксис

Описание

Примеры

Пример 1. Настройка профиля сертификата SCEP по имени

Пример 2. Настройка профиля сертификата SCEP с помощью конвейера

Параметры

-AllowCertificateOnAnyDevice

-CertificateStore

-CertificateTemplateName

-CertificateValidityDays

-Confirm

-Description

-DisableWildcardHandling

-Eku

-EnrollmentRenewThresholdPct

-EnrollmentRetryCount

-EnrollmentRetryDelayMins

-ForceWildcardHandling

-HashAlgorithm

-Id

-InputObject

-KeySize

-KeyStorageProvider

-KeyUsage

-Name

-NewName

-PassThru

-RequireMultifactor

-RootCertificate

-SanType

-ScepServerUrl

-SubjectType

-SupportedPlatform

-WhatIf

Входные данные

Выходные данные

Обратная связь

Дополнительные ресурсы

Set-CMCertificateProfileScep

Синтаксис

Описание

Примеры

Пример 1. Настройка профиля сертификата SCEP по имени

Пример 2. Настройка профиля сертификата SCEP с помощью конвейера

Параметры

-AllowCertificateOnAnyDevice

-CertificateStore

-CertificateTemplateName

-CertificateValidityDays

-Confirm

-Description

-DisableWildcardHandling

-Eku

-EnrollmentRenewThresholdPct

-EnrollmentRetryCount

-EnrollmentRetryDelayMins

-ForceWildcardHandling

-HashAlgorithm

-Id

-InputObject

-KeySize

-KeyStorageProvider

-KeyUsage

-Name

-NewName

-PassThru

-RequireMultifactor

-RootCertificate

-SanType

-ScepServerUrl

-SubjectType

-SupportedPlatform

-WhatIf

Входные данные

Выходные данные

Связанные ссылки

Обратная связь

Дополнительные ресурсы