Import-AzKeyVaultCertificate

Başvuru

Modül:: Az.KeyVault

Sertifikayı anahtar kasasına aktarır.

Syntax

Import-AzKeyVaultCertificate
      [-VaultName] <String>
      [-Name] <String>
      -FilePath <String>
      [-Password <SecureString>]
      [-PolicyPath <String>]
      [-PolicyObject <PSKeyVaultCertificatePolicy>]
      [-Tag <Hashtable>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Import-AzKeyVaultCertificate
      [-VaultName] <String>
      [-Name] <String>
      -CertificateString <String>
      [-ContentType <String>]
      [-Password <SecureString>]
      [-PolicyPath <String>]
      [-PolicyObject <PSKeyVaultCertificatePolicy>]
      [-Tag <Hashtable>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Import-AzKeyVaultCertificate
      [-VaultName] <String>
      [-Name] <String>
      [-PolicyPath <String>]
      [-PolicyObject <PSKeyVaultCertificatePolicy>]
      [-CertificateCollection] <X509Certificate2Collection>
      [-Tag <Hashtable>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Import-AzKeyVaultCertificate cmdlet'i bir sertifikayı anahtar kasasına aktarır. İçeri aktaracak sertifikayı oluşturmak için aşağıdaki yöntemlerden birini kullanabilirsiniz:

Sertifika imzalama isteği oluşturmak ve bunu bir sertifika yetkilisine göndermek için kullanın Add-AzKeyVaultCertificate . Bkz. https://learn.microsoft.com/azure/key-vault/certificates/create-certificate-signing-request
Hem sertifikayı hem de özel anahtarı içeren .pfx veya .p12 dosyası gibi mevcut bir sertifika paketi dosyasını kullanın.

Örnekler

Örnek 1: Anahtar kasası sertifikalarını içeri aktarma

$Password = ConvertTo-SecureString -String "123" -AsPlainText -Force
Import-AzKeyVaultCertificate -VaultName "ContosoKV01" -Name "ImportCert01" -FilePath "C:\Users\contosoUser\Desktop\import.pfx" -Password $Password

Name        : importCert01
Certificate : [Subject]
                CN=contoso.com

              [Issuer]
                CN=contoso.com

              [Serial Number]
                XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

              [Not Before]
                2/8/2016 3:11:45 PM

              [Not After]
                8/8/2016 4:21:45 PM

              [Thumbprint]
                XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Thumbprint  : XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Tags        :
Enabled     : True
Created     : 2/8/2016 11:50:43 PM
Updated     : 2/8/2016 11:50:43 PM

İlk komut, güvenli bir parola oluşturmak için ConvertTo-SecureString cmdlet'ini kullanır ve bunu $Password değişkeninde depolar. İkinci komut ImportCert01 adlı sertifikayı CosotosoKV01 anahtar kasasına aktarır.

Örnek 2: CertificateString ile anahtar kasası sertifikasını içeri aktarma

$Password = ConvertTo-SecureString -String "123" -AsPlainText -Force
$Base64String = [System.Convert]::ToBase64String([System.IO.File]::ReadAllBytes("import.pfx"))
Import-AzKeyVaultCertificate -VaultName "ContosoKV01" -Name "ImportCert01" -CertificateString $Base64String -Password $Password

Name        : importCert01
Certificate : [Subject]
                CN=contoso.com

              [Issuer]
                CN=contoso.com

              [Serial Number]
                XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

              [Not Before]
                2/8/2016 3:11:45 PM

              [Not After]
                8/8/2016 4:21:45 PM

              [Thumbprint]
                XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Thumbprint  : XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Tags        :
Enabled     : True
Created     : 2/8/2016 11:50:43 PM
Updated     : 2/8/2016 11:50:43 PM

İlk komut, güvenli bir parola oluşturmak için ConvertTo-SecureString cmdlet'ini kullanır ve bunu $Password değişkeninde depolar. İkinci komut, sertifikayı Base64 kodlanmış gösterimi olarak okur. Üçüncü komut ImportCert01 adlı sertifikayı CosotosoKV01 anahtar kasasına aktarır.

Örnek 3: PolicyFile ile anahtar kasası sertifikasını içeri aktarma

$Password = ConvertTo-SecureString -String "123" -AsPlainText -Force
Import-AzKeyVaultCertificate -VaultName "ContosoKV01" -Name "ImportCert01" -FilePath "C:\Users\contosoUser\Desktop\import.pfx" -Password $Password -PolicyPath "C:\Users\contosoUser\Desktop\policy.json"

Name        : importCert01
Certificate : [Subject]
                CN=contoso.com

              [Issuer]
                CN=contoso.com

              [Serial Number]
                XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

              [Not Before]
                2/8/2016 3:11:45 PM

              [Not After]
                8/8/2016 4:21:45 PM

              [Thumbprint]
                XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

KeyId         : https://ContosoKV01.vault.azure.net/keys/ImportCert01/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
SecretId      : https://ContosoKV01.vault.azure.net/secrets/ImportCert01/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Thumbprint    : XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Policy        :
                Secret Content Type: application/x-pkcs12
                Issuer Name    : Unknown
                Created On     : 3/22/2023 6:00:52 AM
                Updated On     : 4/27/2023 9:52:53 AM
                ...
RecoveryLevel : Recoverable+Purgeable
Enabled       : True
Expires       : 6/9/2023 6:20:26 AM
NotBefore     : 3/11/2023 6:20:26 AM
Created       : 4/24/2023 9:05:51 AM
Updated       : 4/24/2023 9:05:51 AM
Tags          : {}
VaultName     : ContosoKV01
Name          : ImportCert01
Version       : XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Id            : https://ContosoKV01.vault.azure.net/certificates/ImportCert01/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Parametreler

-CertificateCollection

Anahtar kasasına eklenecek sertifika koleksiyonunu belirtir.

Type:	X509Certificate2Collection
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-CertificateString

İçeri aktaracak sertifika nesnesinin Base64 kodlanmış gösterimi. Bu sertifikanın özel anahtarı içermesi gerekir.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContentType

İçeri aktarılacak sertifikanın türünü belirtir. Sertifika dizesini varsayılan olarak PFX biçimi olarak görür.

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

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FilePath

Bu cmdlet'in içeri aktarıldığı sertifika dosyasının yolunu belirtir.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Sertifika adını belirtir. Bu cmdlet, anahtar kasası adından, seçili durumdaki ortamdan ve sertifika adından bir sertifikanın tam etki alanı adını (FQDN) oluşturur.

Type:	String
Aliases:	CertificateName
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Password

Sertifika dosyasının parolasını belirtir.

Type:	SecureString
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PolicyObject

Sertifikanın yönetim ilkesini belirtmek için bellek içi bir nesne. PolicyPath'e karşılıklı dışlama.

Type:	PSKeyVaultCertificatePolicy
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-PolicyPath

JSON kodlanmış ilke tanımını içeren sertifika için yönetim ilkesini belirtmek için bir dosya yolu. PolicyObject'e karşılıklı dışlama.

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

-Tag

Karma tablo biçiminde anahtar-değer çiftleri. Örneğin: @{key0="value0"; key1=$null; key2="value2"}

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-VaultName

Bu cmdlet'in sertifikaları içeri aktardığı anahtar kasası adını belirtir. Bu cmdlet, bir anahtar kasasının tam etki alanı adını (FQDN) ada ve seçili ortama göre oluşturur.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

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

Girişler

String

X509Certificate2Collection

Hashtable

Çıkışlar

PSKeyVaultCertificate

Import-AzKeyVaultCertificate

Syntax

Description

Örnekler

Örnek 1: Anahtar kasası sertifikalarını içeri aktarma

Örnek 2: CertificateString ile anahtar kasası sertifikasını içeri aktarma

Örnek 3: PolicyFile ile anahtar kasası sertifikasını içeri aktarma

Parametreler

-CertificateCollection

-CertificateString

-Confirm

-ContentType

-DefaultProfile

-FilePath

-Name

-Password

-PolicyObject

-PolicyPath

-Tag

-VaultName

-WhatIf

Girişler

Çıkışlar

Geri Bildirim

Ek kaynaklar

Import-AzKeyVaultCertificate

Syntax

Description

Örnekler

Örnek 1: Anahtar kasası sertifikalarını içeri aktarma

Örnek 2: CertificateString ile anahtar kasası sertifikasını içeri aktarma

Örnek 3: PolicyFile ile anahtar kasası sertifikasını içeri aktarma

Parametreler

-CertificateCollection

-CertificateString

-Confirm

-ContentType

-DefaultProfile

-FilePath

-Name

-Password

-PolicyObject

-PolicyPath

-Tag

-VaultName

-WhatIf

Girişler

Çıkışlar

İlişkili Bağlantılar

Geri Bildirim

Ek kaynaklar