Import-AzKeyVaultCertificate

Referencia

Modul:: Az.KeyVault

Tanúsítvány importálása kulcstartóba.

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

Az Import-AzKeyVaultCertificate parancsmag egy tanúsítványt importál egy kulcstartóba. Az importálandó tanúsítványt az alábbi módszerek egyikével hozhatja létre:

Tanúsítvány-aláírási kérelem létrehozásához és hitelesítésszolgáltatóhoz való elküldéséhez használható Add-AzKeyVaultCertificate . Lásd: https://learn.microsoft.com/azure/key-vault/certificates/create-certificate-signing-request
Használjon meglévő tanúsítványcsomagfájlt, például .pfx vagy .p12 fájlt, amely tartalmazza a tanúsítványt és a titkos kulcsot is.

Példák

1. példa: Key Vault-tanúsítvány importálása

$Password = ConvertTo-SecureString -String "****" -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

Az első parancs a ConvertTo-SecureString parancsmaggal hoz létre egy biztonságos jelszót, majd a $Password változóban tárolja. A második parancs importálja az ImportCert01 nevű tanúsítványt a CosotosoKV01 kulcstartóba.

2. példa: Key Vault-tanúsítvány importálása a CertificateString használatával

$Password = ConvertTo-SecureString -String "****" -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

Az első parancs a ConvertTo-SecureString parancsmaggal hoz létre egy biztonságos jelszót, majd a $Password változóban tárolja. A második parancs a tanúsítványt Base64 kódolású reprezentációként olvassa be. A harmadik parancs importálja az ImportCert01 nevű tanúsítványt a CosotosoKV01 kulcstartóba.

3. példa: Key Vault-tanúsítvány importálása PolicyFile használatával

$Password = ConvertTo-SecureString -String "****" -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

Paraméterek

-CertificateCollection

Megadja a kulcstartóhoz hozzáadni kívánt tanúsítványgyűjteményt.

Típus:	X509Certificate2Collection
Position:	2
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-CertificateString

Az importálandó tanúsítványobjektum Base64 kódolású ábrázolása. Ennek a tanúsítványnak tartalmaznia kell a titkos kulcsot.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
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

-ContentType

Megadja az importálandó tanúsítvány típusát. A tanúsítványsztringet alapértelmezés szerint PFX formátumként tekinti.

Típus:	String
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

-FilePath

Megadja annak a tanúsítványfájlnak az elérési útját, amelyet ez a parancsmag importál.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Name

Megadja a tanúsítvány nevét. Ez a parancsmag egy tanúsítvány teljes tartománynevét (FQDN) hozza létre a kulcstartó nevéből, az aktuálisan kiválasztott környezetből és a tanúsítvány nevéből.

Típus:	String
Aliasok:	CertificateName
Position:	1
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-Password

Megadja a tanúsítványfájl jelszavát.

Típus:	SecureString
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-PolicyObject

Memóriabeli objektum a tanúsítvány felügyeleti házirendjének megadásához. Kölcsönösen kizárja a PolicyPath-t.

Típus:	PSKeyVaultCertificatePolicy
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-PolicyPath

A JSON-kódolt szabályzatdefiníciót tartalmazó tanúsítvány felügyeleti házirendjének megadására szolgáló fájl elérési útja. Kölcsönösen kizárja a PolicyObjectet.

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Tag

Kulcs-érték párok kivonattábla formájában. Például: @{key0="value0"; key1=$null; key2="value2"}

Típus:	Hashtable
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-VaultName

Megadja a kulcstartó nevét, amelybe ez a parancsmag tanúsítványokat importál. Ez a parancsmag egy kulcstartó teljes tartománynevét (FQDN) hozza létre a név és az aktuálisan kiválasztott környezet alapján.

Típus:	String
Position:	0
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	True
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

Bevitelek

String

X509Certificate2Collection

Hashtable

Kimenetek

PSKeyVaultCertificate

Megosztás a következőn keresztül:

Import-AzKeyVaultCertificate

Syntax

Description

Példák

1. példa: Key Vault-tanúsítvány importálása

2. példa: Key Vault-tanúsítvány importálása a CertificateString használatával

3. példa: Key Vault-tanúsítvány importálása PolicyFile használatával

Paraméterek

-CertificateCollection

-CertificateString

-Confirm

-ContentType

-DefaultProfile

-FilePath

-Name

-Password

-PolicyObject

-PolicyPath

-Tag

-VaultName

-WhatIf

Bevitelek

Kimenetek

További források

Megosztás a következőn keresztül:

Import-AzKeyVaultCertificate

Syntax

Description

Példák

1. példa: Key Vault-tanúsítvány importálása

2. példa: Key Vault-tanúsítvány importálása a CertificateString használatával

3. példa: Key Vault-tanúsítvány importálása PolicyFile használatával

Paraméterek

-CertificateCollection

-CertificateString

-Confirm

-ContentType

-DefaultProfile

-FilePath

-Name

-Password

-PolicyObject

-PolicyPath

-Tag

-VaultName

-WhatIf

Bevitelek

Kimenetek

Kapcsolódó hivatkozások

További források