Set-AzKeyVaultCertificatePolicy
Létrehozza vagy frissíti egy tanúsítvány szabályzatát egy kulcstartóban.
Syntax
Set-AzKeyVaultCertificatePolicy
[-VaultName] <String>
[-Name] <String>
[-RenewAtPercentageLifetime <Int32>]
[-SecretContentType <String>]
[-ReuseKeyOnRenewal <Boolean>]
[-Disabled]
[-SubjectName <String>]
[-DnsName <System.Collections.Generic.List`1[System.String]>]
[-KeyUsage <System.Collections.Generic.List`1[System.Security.Cryptography.X509Certificates.X509KeyUsageFlags]>]
[-Ekus <System.Collections.Generic.List`1[System.String]>]
[-ValidityInMonths <Int32>]
[-IssuerName <String>]
[-CertificateType <String>]
[-EmailAtNumberOfDaysBeforeExpiry <Int32>]
[-EmailAtPercentageLifetime <Int32>]
[-KeyType <String>]
[-KeySize <Int32>]
[-KeyNotExportable]
[-CertificateTransparency <Boolean>]
[-PassThru]
[-Curve <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzKeyVaultCertificatePolicy
[-VaultName] <String>
[-Name] <String>
[-InputObject] <PSKeyVaultCertificatePolicy>
[-EmailAtNumberOfDaysBeforeExpiry <Int32>]
[-EmailAtPercentageLifetime <Int32>]
[-KeyType <String>]
[-KeySize <Int32>]
[-CertificateTransparency <Boolean>]
[-PassThru]
[-Curve <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzKeyVaultCertificatePolicy
[-VaultName] <String>
[-Name] <String>
-RenewAtNumberOfDaysBeforeExpiry <Int32>
[-SecretContentType <String>]
[-ReuseKeyOnRenewal <Boolean>]
[-Disabled]
[-SubjectName <String>]
[-DnsName <System.Collections.Generic.List`1[System.String]>]
[-KeyUsage <System.Collections.Generic.List`1[System.Security.Cryptography.X509Certificates.X509KeyUsageFlags]>]
[-Ekus <System.Collections.Generic.List`1[System.String]>]
[-ValidityInMonths <Int32>]
[-IssuerName <String>]
[-CertificateType <String>]
[-EmailAtNumberOfDaysBeforeExpiry <Int32>]
[-EmailAtPercentageLifetime <Int32>]
[-KeyType <String>]
[-KeySize <Int32>]
[-KeyNotExportable]
[-CertificateTransparency <Boolean>]
[-PassThru]
[-Curve <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
A Set-AzKeyVaultCertificatePolicy parancsmag létrehozza vagy frissíti egy tanúsítvány szabályzatát egy kulcstartóban.
Példák
1. példa: Tanúsítványházirend beállítása
Set-AzKeyVaultCertificatePolicy -VaultName "ContosoKV01" -Name "TestCert01" -SecretContentType "application/x-pkcs12" -SubjectName "CN=contoso.com" -IssuerName "Self" -ValidityInMonths 6 -ReuseKeyOnRenewal $True -PassThru
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 :
Ez a parancs beállítja a TestCert01 tanúsítvány szabályzatát a ContosoKV01 kulcstartóban.
Paraméterek
-CertificateTransparency
Azt jelzi, hogy a tanúsítvány átlátszósága engedélyezve van-e ehhez a tanúsítványhoz/kiállítóhoz; ha nincs megadva, az alapértelmezett érték "igaz".
-IssuerName
a tulajdonság beállításakor meg kell adni.
Típus: | Nullable<T>[Boolean] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-CertificateType
Megadja a kiállító tanúsítványtípusát.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Confirm
Jóváhagyást kér a parancsmag futtatása előtt.
Típus: | SwitchParameter |
Aliasok: | cf |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Curve
Megadja a tanúsítvány kulcsának háromliptikus görbenevét. A paraméter elfogadható értékei a következők:
- P-256
- P-384
- P-521
- P-256K
- SECP256K1
Típus: | String |
Elfogadott értékek: | P-256, P-384, P-521, P-256K, SECP256K1 |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-DefaultProfile
Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés
Típus: | IAzureContextContainer |
Aliasok: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Disabled
Azt jelzi, hogy a tanúsítványházirend le van tiltva.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-DnsName
Megadja a tanúsítvány tulajdonosának nevét.
Típus: | List<T>[String] |
Aliasok: | DnsNames |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Ekus
Meghatározza a bővített kulcshasználatokat (EKU-kat) a tanúsítványban.
Típus: | List<T>[String] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-EmailAtNumberOfDaysBeforeExpiry
Megadja, hogy hány nappal a lejárat előtt kezdődjön meg az automatikus megújítás.
Típus: | Nullable<T>[Int32] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-EmailAtPercentageLifetime
Megadja annak az élettartamnak a százalékos értékét, amely után az értesítés automatikus folyamata megkezdődik.
Típus: | Nullable<T>[Int32] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-InputObject
Megadja a tanúsítványházirendet.
Típus: | PSKeyVaultCertificatePolicy |
Aliasok: | CertificatePolicy |
Position: | 2 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-IssuerName
A tanúsítvány kiállítójának nevét adja meg.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-KeyNotExportable
Azt jelzi, hogy a kulcs nem exportálható.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-KeySize
Megadja a tanúsítvány kulcsméretét. A paraméter elfogadható értékei a következők:
- 2048
- 3072
- 4096
- 256
- 384
- 521
Típus: | Int32 |
Elfogadott értékek: | 2048, 3072, 4096, 256, 384, 521 |
Position: | Named |
Alapértelmezett érték: | 2048 |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-KeyType
Megadja a tanúsítványt visszaadó kulcs kulcstípusát. A paraméter elfogadható értékei a következők:
- RSA
- RSA-HSM
- EC
- EC-HSM
Típus: | String |
Elfogadott értékek: | RSA, RSA-HSM, EC, EC-HSM |
Position: | Named |
Alapértelmezett érték: | RSA |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-KeyUsage
Megadja a tanúsítvány kulcshasználatait.
Típus: | List<T>[X509KeyUsageFlags] |
Elfogadott értékek: | None, EncipherOnly, CrlSign, KeyCertSign, KeyAgreement, DataEncipherment, KeyEncipherment, NonRepudiation, DigitalSignature, DecipherOnly |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Name
Megadja a tanúsítvány nevét.
Típus: | String |
Aliasok: | CertificateName |
Position: | 1 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-PassThru
Azt az elemet képviselő objektumot adja vissza, amellyel dolgozik. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-RenewAtNumberOfDaysBeforeExpiry
Megadja, hogy hány nappal a lejárat előtt kezdődjön meg a tanúsítványmegújítás automatikus folyamata.
Típus: | Nullable<T>[Int32] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-RenewAtPercentageLifetime
Megadja annak az élettartamnak a százalékos értékét, amely után megkezdődik a tanúsítványmegújítás automatikus folyamata.
Típus: | Nullable<T>[Int32] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-ReuseKeyOnRenewal
Azt jelzi, hogy a tanúsítvány újra felhasználja a kulcsot a megújítás során.
Típus: | Nullable<T>[Boolean] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-SecretContentType
Megadja az új kulcstartó titkos kulcsának tartalomtípusát. A paraméter elfogadható értékei a következők:
- alkalmazás/x-pkcs12
- application/x-pem-file
Típus: | String |
Elfogadott értékek: | application/x-pkcs12, application/x-pem-file |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-SubjectName
Megadja a tanúsítvány tulajdonosának nevét.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-ValidityInMonths
Megadja, hogy a tanúsítvány hány hónapig érvényes.
Típus: | Nullable<T>[Int32] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-VaultName
Egy kulcstartó nevét adja meg.
Típus: | String |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-WhatIf
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
Típus: | SwitchParameter |
Aliasok: | wi |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |