Import-AzKeyVaultCertificate

Reference

Modul:: Az.KeyVault

Importuje certifikát do trezoru klíčů.

Syntaxe

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

Rutina Import-AzKeyVaultCertificate importuje certifikát do trezoru klíčů. Certifikát, který chcete importovat, můžete vytvořit pomocí jedné z následujících metod:

Slouží Add-AzKeyVaultCertificate k vytvoření žádosti o podepsání certifikátu a jejímu odeslání do certifikační autority. Viz https://learn.microsoft.com/azure/key-vault/certificates/create-certificate-signing-request.
Použijte existující soubor balíčku certifikátu, například soubor .pfx nebo .p12, který obsahuje certifikát i privátní klíč.

Příklady

Příklad 1: Import certifikátu trezoru klíčů

$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

První příkaz použije rutinu ConvertTo-SecureString k vytvoření zabezpečeného hesla a pak ho uloží do proměnné $Password. Druhý příkaz importuje certifikát s názvem ImportCert01 do trezoru klíčů CosotosoKV01.

Příklad 2: Import certifikátu trezoru klíčů pomocí CertificateStringu

$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

První příkaz použije rutinu ConvertTo-SecureString k vytvoření zabezpečeného hesla a pak ho uloží do proměnné $Password. Druhý příkaz přečte certifikát jako reprezentaci s kódováním Base64. Třetí příkaz importuje certifikát s názvem ImportCert01 do trezoru klíčů CosotosoKV01.

Příklad 3: Import certifikátu trezoru klíčů se souborem PolicyFile

$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

Parametry

-CertificateCollection

Určuje kolekci certifikátů, která se má přidat do trezoru klíčů.

Typ:	X509Certificate2Collection
Position:	2
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-CertificateString

Kódování Base64 reprezentace objektu certifikátu, který se má importovat. Tento certifikát musí obsahovat privátní klíč.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ContentType

Určuje typ certifikátu, který se má importovat. Pokud jde o řetězec certifikátu ve výchozím nastavení jako formát PFX.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure

Typ:	IAzureContextContainer
Aliasy:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-FilePath

Určuje cestu k souboru certifikátu, který tato rutina importuje.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Name

Určuje název certifikátu. Tato rutina vytvoří plně kvalifikovaný název domény (FQDN) certifikátu z názvu trezoru klíčů, aktuálně vybraného prostředí a názvu certifikátu.

Typ:	String
Aliasy:	CertificateName
Position:	1
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Password

Určuje heslo pro soubor certifikátu.

Typ:	SecureString
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-PolicyObject

Objekt v paměti pro určení zásad správy pro certifikát. Vzájemného výhradního přístupu ke službě PolicyPath.

Typ:	PSKeyVaultCertificatePolicy
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-PolicyPath

Cesta k souboru pro určení zásad správy pro certifikát, který obsahuje definici zásad kódované json. Vzájemného výhradního přístupu k objektu PolicyObject.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Tag

Páry klíč-hodnota ve formě tabulky hash. Příklad: @{key0="value0"; key1=$null; key2="value2"}

Typ:	Hashtable
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-VaultName

Určuje název trezoru klíčů, do kterého tato rutina importuje certifikáty. Tato rutina vytvoří plně kvalifikovaný název domény (FQDN) trezoru klíčů na základě názvu a aktuálně vybraného prostředí.

Typ:	String
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

String

X509Certificate2Collection

Hashtable

Výstupy

PSKeyVaultCertificate

Sdílet prostřednictvím

Import-AzKeyVaultCertificate

Syntaxe

Description

Příklady

Příklad 1: Import certifikátu trezoru klíčů

Příklad 2: Import certifikátu trezoru klíčů pomocí CertificateStringu

Příklad 3: Import certifikátu trezoru klíčů se souborem PolicyFile

Parametry

-CertificateCollection

-CertificateString

-Confirm

-ContentType

-DefaultProfile

-FilePath

-Name

-Password

-PolicyObject

-PolicyPath

-Tag

-VaultName

-WhatIf

Vstupy

Výstupy

Další materiály

Sdílet prostřednictvím

Import-AzKeyVaultCertificate

Syntaxe

Description

Příklady

Příklad 1: Import certifikátu trezoru klíčů

Příklad 2: Import certifikátu trezoru klíčů pomocí CertificateStringu

Příklad 3: Import certifikátu trezoru klíčů se souborem PolicyFile

Parametry

-CertificateCollection

-CertificateString

-Confirm

-ContentType

-DefaultProfile

-FilePath

-Name

-Password

-PolicyObject

-PolicyPath

-Tag

-VaultName

-WhatIf

Vstupy

Výstupy

Související odkazy

Další materiály