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 証明書プロファイルの設定を更新します。

注:

PS XYZ:\>など、Configuration Manager サイトドライブから Configuration Manager コマンドレットを実行します。詳細については、「作業の開始」を参照してください。

例

例 1: 名前で SCEP 証明書プロファイルを設定する

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

このコマンドは、TestProfile01 という名前の SEP 証明書プロファイルを更新し、新しい名前をTestProfile01_updatedします。

例 2: パイプラインを使用して SCEP 証明書プロファイルを設定する

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

このコマンドは、TestProfile02 という名前の SEP 証明書プロファイルオブジェクトを取得し、パイプライン演算子を使用してオブジェクトを Set-CMCertificateProfileScep に渡し、プロファイルオブジェクトの設定を更新します。

パラメーター

-AllowCertificateOnAnyDevice

任意のデバイスで証明書の登録を許可するかどうかを示します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CertificateStore

証明書の種類を指定します。有効な値は次のとおりです。

マシン
User

型:	CertificateStoreType
指定可能な値:	Machine, User
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CertificateTemplateName

証明書テンプレートの名前を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CertificateValidityDays

証明書の有効期間を日数で指定します。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Description

SCEP 証明書プロファイルの説明を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Eku

拡張キーの使用法を指定します。ハッシュテーブルの値は、証明書の目的を定義します。

型:	Hashtable
Aliases:	Ekus
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EnrollmentRenewThresholdPct

デバイスが証明書の更新を要求する前に残る証明書の有効期間の割合を指定します。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EnrollmentRetryCount

ネットワークデバイス登録サービスを実行しているサーバーに対して、デバイスが証明書要求を自動的に再試行する回数を指定します。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EnrollmentRetryDelayMins

発行元 CA が証明書要求を処理する前に CA マネージャーの承認を使用する場合の各登録試行の間隔を分単位で指定します。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-HashAlgorithm

ハッシュアルゴリズムを指定します。有効な値は次のとおりです。

SHA1
SHA2
SHA3
何一つ

型:	HashAlgorithmTypes
Aliases:	HashAlgorithms
指定可能な値:	NONE, SHA1, SHA2, SHA3
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Id

SCEP 証明書プロファイルのCI_IDを指定します。

型:	Int32
Aliases:	CI_ID, CIId
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-InputObject

SCEP 証明書プロファイルオブジェクトを指定します。 SCEP 証明書プロファイルオブジェクトを取得するには、Get-CMCertificateProfileScep 関数を使用します。

型:	IResultObject
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-KeySize

キーのサイズを指定します。有効な値は次のとおりです。

1024
2048

型:	Int32
指定可能な値:	1024, 2048, 4096
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-KeyStorageProvider

SCEP 登録のキーストレージプロバイダー (KSP) を指定します。有効な値は次のとおりです。

なし
InstallToTPM_FailIfNotPresent
InstallToTPM_IfPresent
InstallToSoftwareKeyStorageProvider
InstallToNGC_FailIfNotPresent

型:	KeyStorageProviderSettingType
指定可能な値:	None, InstallToTPM_FailIfNotPresent, InstallToTPM_IfPresent, InstallToSoftwareKeyStorageProvider, InstallToNGC_FailIfNotPresent
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-KeyUsage

証明書のキー使用法を指定します。有効な値は次のとおりです。

KeyEncipherment
DigitalSignature
なし
EncipherOnly
CrlSign
KeyCertSign
KeyAgreement
DataEncipherment
否認防止
DecipherOnly

型:	X509KeyUsageFlags
Aliases:	KeyUsages
指定可能な値:	KeyEncipherment, DigitalSignature
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Name

SCEP 証明書プロファイルの名前を指定します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-NewName

SCEP 証明書プロファイルの新しい名前を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PassThru

このパラメーターを追加して、作業中のアイテムを表すオブジェクトを返します。既定では、このコマンドレットは出力を生成しない場合があります。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RequireMultifactor

デバイスに証明書を発行する前に、デバイスの登録中に多要素認証が必要であることを示します。このパラメーターは、 KeyStorageProvider パラメーターにInstallToNGC_FailIfNotPresent値が設定されている場合に使用できます。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RootCertificate

信頼されたルート CA 証明書オブジェクトを指定します。信頼されたルート CA 証明書を取得するには、Get-CMCertificateProfileTrustedRootCA 関数を使用します。

型:	IResultObject
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SanType

サブジェクトの別名を指定します。有効な値は次のとおりです。

SubjectAltRequireSpn
SubjectAltRequireUpn
SubjectAltReqiureEmail
SubjectAltRequireDns

型:	SubjectAlternativeNameFormatTypes
Aliases:	SanTypes
指定可能な値:	SubjectAltRequireCustom, SubjectAltRequireSpn, SubjectAltRequireAAD, SubjectAltRequireUpn, SubjectAltReqiureEmail, SubjectAltRequireDns
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ScepServerUrl

SCEP 経由で証明書を発行するネットワークデバイス登録サービス (NDES) サーバーの URL の配列を指定します。

型:	String[]
Aliases:	ScepServerUrls
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SubjectType

サブジェクト名の形式を指定します。有効な値は次のとおりです。

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

型:	SubjectNameFormatTypes
Aliases:	SubjectTypes
指定可能な値:	SubjectRequireCommonNameAsEmail, SubjectRequireCommonNameAsDeviceName, SubjectRequireCommonNameAsOSName, SubjectRequireCommonNameAsIMEI, SubjectRequireCommonNameAsMEID, SubjectRequireCommonNameAsSerialNumber, SubjectRequireCommonNameAsDeviceType, SubjectRequireCommonNameAsWiFiMAC, SubjectRequireCommonNameAsEthernetMAC, SubjectRequireAsCustomString, SubjectRequireDnsAsCN, SubjectRequireEmail, SubjectRequireCommonName, SubjectRequireDirectoryPath
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SupportedPlatform

サポートされているプラットフォームオブジェクトを指定します。サポートされているプラットフォームオブジェクトを取得するには、Get-CMSupportedPlatform コマンドレットを使用します。

型:	IResultObject[]
Aliases:	SupportedPlatforms
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。コマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	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

入力

出力

関連リンク

フィードバック

その他のリソース