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:\> 。 詳細については 、「Getting started」を参照してください。

例

例 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

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

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

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

  • マシン
  • User
Type:CertificateStoreType
Accepted values:Machine, User
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CertificateTemplateName

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

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

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

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

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

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

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

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

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

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

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

  • なし
  • InstallToTPM_FailIfNotPresent
  • InstallToTPM_IfPresent
  • InstallToSoftwareKeyStorageProvider
  • InstallToNGC_FailIfNotPresent
Type:KeyStorageProviderSettingType
Accepted values:None, InstallToTPM_FailIfNotPresent, InstallToTPM_IfPresent, InstallToSoftwareKeyStorageProvider, InstallToNGC_FailIfNotPresent
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-KeyUsage

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

  • KeyEncipherment
  • DigitalSignature
  • なし
  • EncipherOnly
  • CrlSign
  • KeyCertSign
  • KeyAgreement
  • DataEncipherment
  • NonRepudiation
  • DecipherOnly
Type:X509KeyUsageFlags
Aliases:KeyUsages
Accepted values:KeyEncipherment, DigitalSignature
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

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

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

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

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

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

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

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

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

信頼できるルート CA 証明書オブジェクトを指定します。 信頼できるルート CA 証明書を取得するには、次のGet-CMCertificateProfileTrustedRootCAします。

Type:IResultObject
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
-ScepServerUrl

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

Type:String[]
Aliases:ScepServerUrls
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
-SupportedPlatform

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

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

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

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject