Import-AzKeyVaultCertificate

Riferimento

Modulo:: Az.KeyVault

Importa un certificato in un insieme di credenziali delle chiavi.

Sintassi

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>]

Descrizione

Il cmdlet Import-AzKeyVaultCertificate importa un certificato in un insieme di credenziali delle chiavi. È possibile creare il certificato da importare usando uno dei metodi seguenti:

Usare Add-AzKeyVaultCertificate per creare una richiesta di firma del certificato e inviarla a un'autorità di certificazione. Vedere https://learn.microsoft.com/azure/key-vault/certificates/create-certificate-signing-request
Usare un file del pacchetto di certificato esistente, ad esempio un file con estensione pfx o p12, che contiene sia il certificato che la chiave privata.

Esempio

Esempio 1: Importare un certificato dell'insieme di credenziali delle chiavi

$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

Il primo comando usa il cmdlet ConvertTo-SecureString per creare una password sicura e quindi lo archivia nella variabile $Password. Il secondo comando importa il certificato denominato ImportCert01 nell'insieme di credenziali delle chiavi CosotosoKV01.

Esempio 2: Importare un certificato dell'insieme di credenziali delle chiavi da 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

Il primo comando usa il cmdlet ConvertTo-SecureString per creare una password sicura e quindi lo archivia nella variabile $Password. Il secondo comando legge un certificato come rappresentazione con codifica Base64. Il terzo comando importa il certificato denominato ImportCert01 nell'insieme di credenziali delle chiavi CosotosoKV01.

Esempio 3: Importare un certificato dell'insieme di credenziali delle chiavi con 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

Parametri

-CertificateCollection

Specifica la raccolta di certificati da aggiungere a un insieme di credenziali delle chiavi.

Tipo:	X509Certificate2Collection
Posizione:	2
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-CertificateString

Rappresentazione con codifica Base64 dell'oggetto certificato da importare. Questo certificato deve contenere la chiave privata.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ContentType

Specifica il tipo di certificato da importare. Considera la stringa del certificato come formato PFX per impostazione predefinita.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure

Tipo:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-FilePath

Specifica il percorso del file di certificato importato da questo cmdlet.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Name

Specifica il nome del certificato. Questo cmdlet costruisce il nome di dominio completo (FQDN) di un certificato dal nome dell'insieme di credenziali delle chiavi, dall'ambiente attualmente selezionato e dal nome del certificato.

Tipo:	String
Alias:	CertificateName
Posizione:	1
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-Password

Specifica la password per un file di certificato.

Tipo:	SecureString
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-PolicyObject

Oggetto in memoria per specificare i criteri di gestione per il certificato. Si escludono a PolicyPath.

Tipo:	PSKeyVaultCertificatePolicy
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-PolicyPath

Percorso del file per specificare i criteri di gestione per il certificato che contiene la definizione dei criteri con codifica JSON. Mutual-exclusive to PolicyObject.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Tag

Coppie chiave-valore sotto forma di tabella hash. Ad esempio: @{key0="value0"; key1=$null; key2="value2"}

Tipo:	Hashtable
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-VaultName

Specifica il nome dell'insieme di credenziali delle chiavi in cui questo cmdlet importa i certificati. Questo cmdlet costruisce il nome di dominio completo (FQDN) di un insieme di credenziali delle chiavi in base al nome e all'ambiente attualmente selezionato.

Tipo:	String
Posizione:	0
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:	SwitchParameter
Alias:	wi
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

Input

String

X509Certificate2Collection

Hashtable

Output

PSKeyVaultCertificate

Condividi tramite

Import-AzKeyVaultCertificate

Sintassi

Descrizione

Esempio

Esempio 1: Importare un certificato dell'insieme di credenziali delle chiavi

Esempio 2: Importare un certificato dell'insieme di credenziali delle chiavi da CertificateString

Esempio 3: Importare un certificato dell'insieme di credenziali delle chiavi con PolicyFile

Parametri

-CertificateCollection

-CertificateString

-Confirm

-ContentType

-DefaultProfile

-FilePath

-Name

-Password

-PolicyObject

-PolicyPath

-Tag

-VaultName

-WhatIf

Input

Output

Risorse aggiuntive

Condividi tramite

Import-AzKeyVaultCertificate

Sintassi

Descrizione

Esempio

Esempio 1: Importare un certificato dell'insieme di credenziali delle chiavi

Esempio 2: Importare un certificato dell'insieme di credenziali delle chiavi da CertificateString

Esempio 3: Importare un certificato dell'insieme di credenziali delle chiavi con PolicyFile

Parametri

-CertificateCollection

-CertificateString

-Confirm

-ContentType

-DefaultProfile

-FilePath

-Name

-Password

-PolicyObject

-PolicyPath

-Tag

-VaultName

-WhatIf

Input

Output

Collegamenti correlati

Risorse aggiuntive