Import-AzKeyVaultCertificate

Referens

Modul:: Az.KeyVault

Importerar ett certifikat till ett nyckelvalv.

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

Cmdleten Import-AzKeyVaultCertificate importerar ett certifikat till ett nyckelvalv. Du kan skapa certifikatet som ska importeras med någon av följande metoder:

Använd Add-AzKeyVaultCertificate för att skapa en begäran om certifikatsignering och skicka den till en certifikatutfärdare. Se https://learn.microsoft.com/azure/key-vault/certificates/create-certificate-signing-request
Använd en befintlig certifikatpaketfil, till exempel en .pfx- eller .p12-fil, som innehåller både certifikatet och den privata nyckeln.

Exempel

Exempel 1: Importera ett key vault-certifikat

$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

Det första kommandot använder cmdleten ConvertTo-SecureString för att skapa ett säkert lösenord och lagrar det sedan i variabeln $Password. Det andra kommandot importerar certifikatet med namnet ImportCert01 till nyckelvalvet CosotosoKV01.

Exempel 2: Importera ett key vault-certifikat med CertificateString

$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

Det första kommandot använder cmdleten ConvertTo-SecureString för att skapa ett säkert lösenord och lagrar det sedan i variabeln $Password. Det andra kommandot läser ett certifikat som en Base64-kodad representation. Det tredje kommandot importerar certifikatet med namnet ImportCert01 till nyckelvalvet CosotosoKV01.

Exempel 3: Importera ett nyckelvalvcertifikat med PolicyFile

$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

Parametrar

-CertificateCollection

Anger den certifikatsamling som ska läggas till i ett nyckelvalv.

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

-CertificateString

Base64-kodad representation av certifikatobjektet som ska importeras. Certifikatet måste innehålla den privata nyckeln.

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-ContentType

Anger vilken typ av certifikat som ska importeras. Betraktar certifikatsträngen som PFX-format som standard.

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

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure

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

-FilePath

Anger sökvägen till certifikatfilen som den här cmdleten importerar.

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

-Name

Anger certifikatnamnet. Den här cmdleten konstruerar det fullständigt kvalificerade domännamnet (FQDN) för ett certifikat från key vault-namn, för närvarande vald miljö och certifikatnamn.

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

-Password

Anger lösenordet för en certifikatfil.

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

-PolicyObject

Ett minnesinternt objekt för att ange hanteringsprincip för certifikatet. Ömsesidigt uteslutande för PolicyPath.

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

-PolicyPath

En filsökväg för att ange hanteringsprincip för certifikatet som innehåller JSON-kodad principdefinition. Ömsesidigt uteslutande för PolicyObject.

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

-Tag

Nyckel/värde-par i form av en hash-tabell. Exempel: @{key0="value0"; key1=$null; key2="value2"}

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

-VaultName

Anger namnet på nyckelvalvet som den här cmdleten importerar certifikat till. Den här cmdleten konstruerar det fullständigt kvalificerade domännamnet (FQDN) för ett nyckelvalv baserat på namnet och den valda miljön.

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

Indata

String

X509Certificate2Collection

Hashtable

Utdata

PSKeyVaultCertificate

Import-AzKeyVaultCertificate

Syntax

Description

Exempel

Exempel 1: Importera ett key vault-certifikat

Exempel 2: Importera ett key vault-certifikat med CertificateString

Exempel 3: Importera ett nyckelvalvcertifikat med PolicyFile

Parametrar

-CertificateCollection

-CertificateString

-Confirm

-ContentType

-DefaultProfile

-FilePath

-Name

-Password

-PolicyObject

-PolicyPath

-Tag

-VaultName

-WhatIf

Indata

Utdata

Feedback

Ytterligare resurser

Import-AzKeyVaultCertificate

Syntax

Description

Exempel

Exempel 1: Importera ett key vault-certifikat

Exempel 2: Importera ett key vault-certifikat med CertificateString

Exempel 3: Importera ett nyckelvalvcertifikat med PolicyFile

Parametrar

-CertificateCollection

-CertificateString

-Confirm

-ContentType

-DefaultProfile

-FilePath

-Name

-Password

-PolicyObject

-PolicyPath

-Tag

-VaultName

-WhatIf

Indata

Utdata

Relaterade länkar

Feedback

Ytterligare resurser