New-AzKeyVaultCertificatePolicy
Hiermee maakt u een certificaatbeleidsobject in het geheugen.
Syntax
SubjectName (Standaard)
New-AzKeyVaultCertificatePolicy
[-IssuerName] <String>
[-SubjectName] <String>
[-RenewAtNumberOfDaysBeforeExpiry <Int32>]
[-RenewAtPercentageLifetime <Int32>]
[-SecretContentType <String>]
[-ReuseKeyOnRenewal]
[-Disabled]
[-KeyUsage <System.Collections.Generic.List`1[System.Security.Cryptography.X509Certificates.X509KeyUsageFlags]>]
[-Ekus <System.Collections.Generic.List`1[System.String]>]
[-ValidityInMonths <Int32>]
[-CertificateType <String>]
[-EmailAtNumberOfDaysBeforeExpiry <Int32>]
[-EmailAtPercentageLifetime <Int32>]
[-KeyType <String>]
[-KeySize <Int32>]
[-KeyNotExportable]
[-CertificateTransparency <Boolean>]
[-Curve <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
DNSNames
New-AzKeyVaultCertificatePolicy
[-IssuerName] <String>
[[-SubjectName] <String>]
[-DnsName] <System.Collections.Generic.List`1[System.String]>
[-RenewAtNumberOfDaysBeforeExpiry <Int32>]
[-RenewAtPercentageLifetime <Int32>]
[-SecretContentType <String>]
[-ReuseKeyOnRenewal]
[-Disabled]
[-KeyUsage <System.Collections.Generic.List`1[System.Security.Cryptography.X509Certificates.X509KeyUsageFlags]>]
[-Ekus <System.Collections.Generic.List`1[System.String]>]
[-ValidityInMonths <Int32>]
[-CertificateType <String>]
[-EmailAtNumberOfDaysBeforeExpiry <Int32>]
[-EmailAtPercentageLifetime <Int32>]
[-KeyType <String>]
[-KeySize <Int32>]
[-KeyNotExportable]
[-CertificateTransparency <Boolean>]
[-Curve <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
De cmdlet New-AzKeyVaultCertificatePolicy maakt een in-memory certificaatbeleidsobject voor Azure Key Vault.
Voorbeelden
Voorbeeld 1: Een certificaatbeleid maken
New-AzKeyVaultCertificatePolicy -SecretContentType "application/x-pkcs12" -SubjectName "CN=contoso.com" -IssuerName "Self" -ValidityInMonths 6 -ReuseKeyOnRenewal
SecretContentType : application/x-pkcs12
Kty :
KeySize : 2048
Curve :
Exportable :
ReuseKeyOnRenewal : True
SubjectName : CN=contoso.com
DnsNames :
KeyUsage :
Ekus :
ValidityInMonths : 6
IssuerName : Self
CertificateType :
RenewAtNumberOfDaysBeforeExpiry :
RenewAtPercentageLifetime :
EmailAtNumberOfDaysBeforeExpiry :
EmailAtPercentageLifetime :
CertificateTransparency :
Enabled : True
Created :
Updated :
Met deze opdracht maakt u een certificaatbeleid dat zes maanden geldig is en wordt de sleutel opnieuw gebruikt om het certificaat te vernieuwen.
Voorbeeld 2
Hiermee maakt u een certificaatbeleidsobject in het geheugen. (autogenerated)
New-AzKeyVaultCertificatePolicy -IssuerName 'Self' -KeyType RSA -RenewAtNumberOfDaysBeforeExpiry <Int32> -SecretContentType application/x-pkcs12 -SubjectName 'CN=contoso.com' -ValidityInMonths 6
Voorbeeld 3: Een alternatieve naam voor onderwerp (of SAN)-certificaat maken
New-AzKeyVaultCertificatePolicy -SecretContentType "application/x-pkcs12" -SubjectName "CN=contoso.com" -DnsName "contoso.com","support.contoso.com","docs.contoso.com" -IssuerName "Self"
SecretContentType : application/x-pkcs12
Kty : RSA
KeySize : 2048
Curve :
Exportable :
ReuseKeyOnRenewal : False
SubjectName : CN=contoso.com
DnsNames : {contoso.com, support.contoso.com, docs.contoso.com}
KeyUsage :
Ekus :
ValidityInMonths :
IssuerName : Self
CertificateType :
RenewAtNumberOfDaysBeforeExpiry :
RenewAtPercentageLifetime :
EmailAtNumberOfDaysBeforeExpiry :
EmailAtPercentageLifetime :
CertificateTransparency :
Enabled : True
Created :
Updated :
In dit voorbeeld wordt een SAN-certificaat gemaakt met drie DNS-namen.
Parameters
-CertificateTransparency
Geeft aan of transparantie van certificaten is ingeschakeld voor dit certificaat/deze verlener; als dit niet is opgegeven, is de standaardwaarde 'true'
Parametereigenschappen
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-CertificateType
Hiermee geeft u het type certificaat aan de verlener.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-Confirm
Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.
Parametereigenschappen
Type: SwitchParameter
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Aliassen: Cf
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-Curve
Hiermee geeft u de elliptische curvenaam van de sleutel van het certificaat.
De acceptabele waarden voor deze parameter zijn:
P-256
P-384
P-521
P-256K
SECP256K1
Parametereigenschappen
Type: String
Default value: None
Geaccepteerde waarden: P-256, P-384, P-521, P-256K, SECP256K1
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-DefaultProfile
De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure
Parametereigenschappen
Type: IAzureContextContainer
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Aliassen: AzContext, AzureRmContext, AzureCredential
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-Disabled
Geeft aan dat het certificaatbeleid is uitgeschakeld.
Parametereigenschappen
Type: SwitchParameter
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-DnsName
Hiermee geeft u de DNS-namen in het certificaat. Alternatieve onderwerpnamen (SAN's) kunnen worden opgegeven als DNS-namen.
Parametereigenschappen
Type: List<T> [ String ]
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Aliassen: DNS-namen
Parametersets
DNSNames
Position: 1
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-Ekus
Hiermee geeft u het verbeterde sleutelgebruik (EKU's) in het certificaat op.
Parametereigenschappen
Type: List<T> [ String ]
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-EmailAtNumberOfDaysBeforeExpiry
Hiermee geeft u op hoeveel dagen voordat het automatische meldingsproces begint.
Parametereigenschappen
Type: Nullable<T> [ Int32 ]
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-EmailAtPercentageLifetime
Hiermee geeft u het percentage van de levensduur waarna het automatische proces voor de melding begint.
Parametereigenschappen
Type: Nullable<T> [ Int32 ]
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-IssuerName
Hiermee geeft u de naam van de verlener voor het certificaat.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: 0
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-KeyNotExportable
Geeft aan dat de sleutel niet kan worden geƫxporteerd.
Parametereigenschappen
Type: SwitchParameter
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-KeySize
Hiermee geeft u de sleutelgrootte van het certificaat.
De acceptabele waarden voor deze parameter zijn:
2048
3072
4096
256
384
521
Parametereigenschappen
Type: Int32
Default value: None
Geaccepteerde waarden: 2048, 3072, 4096, 256, 384, 521
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-KeyType
Hiermee geeft u het sleuteltype op van de sleutel die het certificaat back-ups maakt.
De acceptabele waarden voor deze parameter zijn:
RSA
RSA-HSM
Europese Commissie
EC-HSM
Parametereigenschappen
Type: String
Default value: RSA
Geaccepteerde waarden: RSA, RSA-HSM, EC, EC-HSM
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-KeyUsage
Hiermee geeft u het sleutelgebruik in het certificaat.
Parametereigenschappen
Type: List<T> [ X509KeyUsageFlags ]
Default value: None
Geaccepteerde waarden: None, EncipherOnly, CrlSign, KeyCertSign, KeyAgreement, DataEncipherment, KeyEncipherment, NonRepudiation, DigitalSignature, DecipherOnly
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-RenewAtNumberOfDaysBeforeExpiry
Hiermee geeft u het aantal dagen waarna het automatische proces voor certificaatvernieuwing begint.
Parametereigenschappen
Type: Nullable<T> [ Int32 ]
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-RenewAtPercentageLifetime
Hiermee geeft u het percentage van de levensduur op waarna het automatische proces voor certificaatvernieuwing begint.
Parametereigenschappen
Type: Nullable<T> [ Int32 ]
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-ReuseKeyOnRenewal
Geeft aan dat het certificaat de sleutel opnieuw gebruikt tijdens het verlengen.
Parametereigenschappen
Type: SwitchParameter
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-SecretContentType
Hiermee geeft u het inhoudstype van het nieuwe sleutelkluisgeheim op.
De acceptabele waarden voor deze parameter zijn:
application/x-pkcs12
application/x-pem-file
Parametereigenschappen
Type: String
Default value: None
Geaccepteerde waarden: application/x-pkcs12, application/x-pem-file
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-SubjectName
Hiermee geeft u de onderwerpnaam van het certificaat.
Opmerking
Als u een komma (,) of een punt (.) binnen een eigenschap in de SubjectName parameter moet gebruiken, moet u het eigenschapsveld tussen aanhalingstekens plaatsen. U kunt bijvoorbeeld O="Contoso, Ltd" gebruiken in het veld Organisatienaam.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
SubjectName
Position: 1
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-ValidityInMonths
Hiermee geeft u het aantal maanden op dat het certificaat geldig is.
Parametereigenschappen
Type: Nullable<T> [ Int32 ]
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-WhatIf
Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd.
De cmdlet wordt niet uitgevoerd.
Parametereigenschappen
Type: SwitchParameter
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Aliassen: Wi
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParameters voor meer informatie.
Uitvoerwaarden