Set-CMCertificateProfileScep
SYNOPSIS
Hiermee stelt u een SCEP-certificaatprofiel in.
SYNTAX
ByValue (standaard)
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>]
ById
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>]
ByName
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>]
DESCRIPTION
Met de cmdlet Set-CMCertificateProfileScep worden de instellingen van een SCEP-certificaatprofiel bijgewerkt.
Notitie
Voer Configuration Manager cmdlets uit vanaf Configuration Manager sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.
EXAMPLES
Voorbeeld 1: een SCEP-certificaatprofiel instellen op naam
PS XYZ:\> Set-CMCertificateProfileScep -Name "TestProfile01" -CertificateStore Machine -Description "Test update" -HashAlgorithm SHA3 -KeySize 1024 -KeyUsage KeyEncipherment -NewName "TestProfile01_updated" -SanType SubjectAltRequireDns
Met deze opdracht wordt het SEP-certificaatprofiel met de naam TestProfile01 bijgewerkt en krijgt het de nieuwe naam TestProfile01_updated.
Voorbeeld 2: een SCEP-certificaatprofiel instellen met behulp van de pijplijn
PS XYZ:\> Get-CMCertificateProfileScep -Name "TestProfile02" -Fast | Set-CMCertificateProfileScep -AllowCertificateOnAnyDevice $True -KeyStorageProvider InstallToNGC_FailIfNotPresent
Met deze opdracht wordt het SEP-certificaatprofielobject met de naam TestProfile02 en wordt de pijplijnoperator gebruikt om het object door te geven aan Set-CMCertificateProfileScep, waarmee de instellingen van het profielobject worden bijgewerkt.
PARAMETERS
-AllowCertificateOnAnyDevice
Geeft aan of certificaatinschrijving op elk apparaat is toegestaan.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CertificateStore
Hiermee geeft u het certificaattype. Geldige waarden zijn:
- Machine
- Gebruiker
Type: CertificateStoreType
Parameter Sets: (All)
Aliases:
Accepted values: Machine, User
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CertificateTemplateName
Hiermee geeft u de naam van een certificaatsjabloon.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CertificateValidityDays
Hiermee geeft u, in aantal dagen, de geldigheidsperiode van het certificaat op.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-Beschrijving
Hiermee geeft u een beschrijving op voor het SCEP-certificaatprofiel.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EKU
Hiermee geeft u het uitgebreide sleutelgebruik. De waarden in de hashtabel definiëren het beoogde doel van het certificaat.
Type: Hashtable
Parameter Sets: (All)
Aliases: Ekus
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnrollmentRenewThresholdPct
Hiermee geeft u het percentage van de levensduur van het certificaat op dat resteert voordat het apparaat verlenging van het certificaat aanvraagt.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnrollmentRetryCount
Hiermee geeft u het aantal keren op dat het apparaat de certificaataanvraag automatisch opnieuw naar de server met de Registratieservice voor netwerkapparaten.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnrollmentRetryDelayMins
Hiermee geeft u het interval in minuten op tussen elke inschrijvingspoging wanneer u CA-managergoedkeuring gebruikt voordat de verlenende CA de certificaataanvraag verwerkt.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-HashAlgorithm
Hiermee geeft u het hash-algoritme. Geldige waarden zijn:
- SHA1
- SHA2
- SHA3
- Geen
Type: HashAlgorithmTypes
Parameter Sets: (All)
Aliases: HashAlgorithms
Accepted values: NONE, SHA1, SHA2, SHA3
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Id
Hiermee geeft u de CI_ID van een SCEP-certificaatprofiel op.
Type: Int32
Parameter Sets: ById
Aliases: CI_ID, CIId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Hiermee geeft u een SCEP-certificaatprofielobject op. Als u een SCEP-certificaatprofielobject wilt verkrijgen, gebruikt u Get-CMCertificateProfileScep functie.
Type: IResultObject
Parameter Sets: ByValue
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-KeySize
Hiermee geeft u de grootte van de sleutel. Geldige waarden zijn:
- 1024
- 2048
Type: Int32
Parameter Sets: (All)
Aliases:
Accepted values: 1024, 2048, 4096
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-KeyStorageProvider
Hiermee geeft u de key Storage Provider (KSP) op voor de SCEP-inschrijving. Geldige waarden zijn:
- Geen
- InstallToTPM_FailIfNotPresent
- InstallToTPM_IfPresent
- InstallToSoftwareKeyStorageProvider
- InstallToNGC_FailIfNotPresent
Type: KeyStorageProviderSettingType
Parameter Sets: (All)
Aliases:
Accepted values: None, InstallToTPM_FailIfNotPresent, InstallToTPM_IfPresent, InstallToSoftwareKeyStorageProvider, InstallToNGC_FailIfNotPresent
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-KeyUsage
Hiermee geeft u het sleutelgebruik voor het certificaat op. Geldige waarden zijn:
- KeyEncipherment
- DigitalSignature
- Geen
- EncipherOnly
- CrlSign
- KeyCertSign
- KeyAgreement
- DataEncipherment
- NonRepudiation
- DecipherOnly
Type: X509KeyUsageFlags
Parameter Sets: (All)
Aliases: KeyUsages
Accepted values: KeyEncipherment, DigitalSignature
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Hiermee geeft u een naam op voor het SCEP-certificaatprofiel.
Type: String
Parameter Sets: ByName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NewName
Hiermee geeft u een nieuwe naam op voor het SCEP-certificaatprofiel.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PassThru
Voeg deze parameter toe om een -object te retourneren dat het item vertegenwoordigt waarmee u werkt. Standaard is het mogelijk dat deze cmdlet geen uitvoer genereert.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RequireMultifactor
Geeft aan dat meervoudige verificatie is vereist tijdens de inschrijving van apparaten voordat certificaten aan deze apparaten worden gegeven. Deze parameter kan worden gebruikt wanneer de InstallToNGC_FailIfNotPresent waarde is ingesteld voor de parameter KeyStorageProvider.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RootCertificate
Hiermee geeft u een vertrouwd basis-CA-certificaatobject op. Als u een vertrouwd basis-CA-certificaat wilt verkrijgen, gebruikt u Get-CMCertificateProfileTrustedRootCA-functie.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SanType
Hiermee geeft u de alternatieve naam van het onderwerp. Geldige waarden zijn:
- SubjectAltRequireSpn
- SubjectAltRequireUpn
- SubjectAltReqiureEmail
- SubjectAltRequireDns
Type: SubjectAlternativeNameFormatTypes
Parameter Sets: (All)
Aliases: SanTypes
Accepted values: SubjectAltRequireCustom, SubjectAltRequireSpn, SubjectAltRequireAAD, SubjectAltRequireUpn, SubjectAltReqiureEmail, SubjectAltRequireDns
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ScepServerUrl
Hiermee geeft u een matrix met URL's op voor de Registratieservice voor netwerkapparaten (NDES)-servers die certificaten via SCEP uitgeven.
Type: String[]
Parameter Sets: (All)
Aliases: ScepServerUrls
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SubjectType
Hiermee geeft u de indeling van de onderwerpnaam. Geldige waarden zijn:
- SubjectRequireCommonNameAsEmail
- SubjectRequireCommonNameAsDeviceName
- SubjectRequireCommonNameAsOSName
- SubjectRequireCommonNameAsIMEI
- SubjectRequireCommonNameAsMEID
- SubjectRequireCommonNameAsSerialNumber
- SubjectRequireCommonNameAsDeviceType
- SubjectRequireCommonNameAsWiFiMAC
- SubjectRequireCommonNameAsEthernetMAC
- SubjectRequireAsCustomString
- SubjectRequireDnsAsCN
- SubjectRequireEmail
- SubjectRequireCommonName
- SubjectRequireDirectoryPath
Type: SubjectNameFormatTypes
Parameter Sets: (All)
Aliases: SubjectTypes
Accepted values: SubjectRequireCommonNameAsEmail, SubjectRequireCommonNameAsDeviceName, SubjectRequireCommonNameAsOSName, SubjectRequireCommonNameAsIMEI, SubjectRequireCommonNameAsMEID, SubjectRequireCommonNameAsSerialNumber, SubjectRequireCommonNameAsDeviceType, SubjectRequireCommonNameAsWiFiMAC, SubjectRequireCommonNameAsEthernetMAC, SubjectRequireAsCustomString, SubjectRequireDnsAsCN, SubjectRequireEmail, SubjectRequireCommonName, SubjectRequireDirectoryPath
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SupportedPlatform
Hiermee geeft u een ondersteund platformobject op. Als u een ondersteund platformobject wilt verkrijgen, gebruikt u Get-CMSupportedPlatform cmdlet .
Type: IResultObject[]
Parameter Sets: (All)
Aliases: SupportedPlatforms
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.