Import-AzKeyVaultCertificate

Module:: Az.KeyVault Module

Hiermee importeert u een certificaat naar een sleutelkluis.

Syntax

ImportCertificateFromFile (Standaard)

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

ImportWithPrivateKeyFromString

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

ImportWithPrivateKeyFromCollection

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

Description

De cmdlet Import-AzKeyVaultCertificate importeert een certificaat in een sleutelkluis. U kunt het certificaat maken dat u wilt importeren met behulp van een van de volgende methoden:

Hiermee Add-AzKeyVaultCertificate maakt u een aanvraag voor certificaatondertekening en verzendt u deze naar een certificeringsinstantie. Zie https://learn.microsoft.com/azure/key-vault/certificates/create-certificate-signing-request
Gebruik een bestaand certificaatpakketbestand, zoals een PFX- of P12-bestand, dat zowel het certificaat als de persoonlijke sleutel bevat.

Voorbeelden

Voorbeeld 1: Een sleutelkluiscertificaat importeren

$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

De eerste opdracht maakt gebruik van de ConvertTo-SecureString cmdlet om een beveiligd wachtwoord te maken en slaat het vervolgens op in de $Password variabele. Met de tweede opdracht wordt het certificaat met de naam ImportCert01 geïmporteerd in de sleutelkluis ContosoKV01.

Voorbeeld 2: Een sleutelkluiscertificaat importeren door CertificateString

$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

De eerste opdracht maakt gebruik van de ConvertTo-SecureString cmdlet om een beveiligd wachtwoord te maken en slaat het vervolgens op in de $Password variabele. Met de tweede opdracht wordt een certificaat gelezen als een met Base64 gecodeerde weergave. Met de derde opdracht wordt het certificaat met de naam ImportCert01 geïmporteerd in de sleutelkluis ContosoKV01.

Voorbeeld 3: Een sleutelkluiscertificaat importeren met 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

Parameters

-CertificateCollection

Hiermee geeft u de certificaatverzameling op die moet worden toegevoegd aan een sleutelkluis.

Parametereigenschappen

Type:	X509Certificate2Collection
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

ImportWithPrivateKeyFromCollection

Position:	2
Verplicht:	True
Waarde uit pijplijn:	True
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-CertificateString

Base64 gecodeerde weergave van het certificaatobject dat moet worden geïmporteerd. Dit certificaat moet de persoonlijke sleutel bevatten.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

ImportWithPrivateKeyFromString

Position:	Named
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
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

-ContentType

Hiermee geeft u het type van het certificaat dat moet worden geïmporteerd. Hiermee wordt standaard de certificaatreeks als PFX-indeling gebruikt.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

ImportWithPrivateKeyFromString

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
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

-FilePath

Hiermee geeft u het pad op van het certificaatbestand dat door deze cmdlet wordt geïmporteerd.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

ImportCertificateFromFile

Position:	Named
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Name

Hiermee geeft u de certificaatnaam. Met deze cmdlet wordt de FQDN (Fully Qualified Domain Name) van een certificaat samengesteld op basis van de naam van de sleutelkluis, momenteel geselecteerde omgeving en certificaatnaam.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False
Aliassen:	CertificateName

Parametersets

(All)

Position:	1
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-Password

Hiermee geeft u het wachtwoord voor een certificaatbestand.

Parametereigenschappen

Type:	SecureString
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

ImportCertificateFromFile

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

ImportWithPrivateKeyFromString

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-PolicyObject

Een in-memory object om beheerbeleid voor het certificaat op te geven. Wederzijds exclusief voor PolicyPath.

Parametereigenschappen

Type:	PSKeyVaultCertificatePolicy
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	True
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-PolicyPath

Een bestandspad voor het opgeven van beheerbeleid voor het certificaat dat JSON-gecodeerde beleidsdefinitie bevat. Wederzijds exclusief voor PolicyObject.

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:	False
Waarde van resterende argumenten:	False

-Tag

Sleutel-waardeparen in de vorm van een hash-tabel. Bijvoorbeeld: @{key0="value0"; key1=$null; key2="value2"}

Parametereigenschappen

Type:	Hashtable
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

-VaultName

Hiermee geeft u de naam van de sleutelkluis waarin deze cmdlet certificaten importeert. Met deze cmdlet wordt de FQDN (Fully Qualified Domain Name) van een sleutelkluis samengesteld op basis van de naam en de geselecteerde omgeving.

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

-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_CommonParametersvoor meer informatie.

Uitvoerwaarden

PSKeyVaultCertificate

Feedback

Is deze pagina nuttig?

Delen via

Import-AzKeyVaultCertificate

Syntax

ImportCertificateFromFile (Standaard)

ImportWithPrivateKeyFromString

ImportWithPrivateKeyFromCollection

Description

Voorbeelden

Voorbeeld 1: Een sleutelkluiscertificaat importeren

Voorbeeld 2: Een sleutelkluiscertificaat importeren door CertificateString

Voorbeeld 3: Een sleutelkluiscertificaat importeren met PolicyFile

Parameters

-CertificateCollection

Parametereigenschappen

Parametersets

-CertificateString

Parametereigenschappen

Parametersets

-Confirm

Parametereigenschappen

Parametersets

-ContentType

Parametereigenschappen

Parametersets

-DefaultProfile

Parametereigenschappen

Parametersets

-FilePath

Parametereigenschappen

Parametersets

-Name

Parametereigenschappen

Parametersets

-Password

Parametereigenschappen

Parametersets

-PolicyObject

Parametereigenschappen

Parametersets

-PolicyPath

Parametereigenschappen

Parametersets

-Tag

Parametereigenschappen

Parametersets

-VaultName

Parametereigenschappen

Parametersets

-WhatIf

Parametereigenschappen

Parametersets

CommonParameters

Invoerwaarden

String

X509Certificate2Collection

Hashtable

Uitvoerwaarden

PSKeyVaultCertificate

Verwante koppelingen

Feedback