Import-AzKeyVaultCertificate

Référence

Module:: Az.KeyVault

Importe un certificat dans un coffre de clés.

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

L’applet de commande Import-AzKeyVaultCertificate importe un certificat dans un coffre de clés. Vous pouvez créer le certificat à importer à l’aide de l’une des méthodes suivantes :

Utilisez Add-AzKeyVaultCertificate pour créer une demande de signature de certificat et la soumettre à une autorité de certification. Voir https://learn.microsoft.com/azure/key-vault/certificates/create-certificate-signing-request
Utilisez un fichier de package de certificat existant, tel qu’un fichier .pfx ou .p12, qui contient à la fois le certificat et la clé privée.

Exemples

Exemple 1 : Importer un certificat de coffre de clés

$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

La première commande utilise l’applet de commande ConvertTo-SecureString pour créer un mot de passe sécurisé, puis la stocke dans la variable $Password. La deuxième commande importe le certificat nommé ImportCert01 dans le coffre de clés CosotosoKV01.

Exemple 2 : Importer un certificat de coffre de clés par 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

La première commande utilise l’applet de commande ConvertTo-SecureString pour créer un mot de passe sécurisé, puis la stocke dans la variable $Password. La deuxième commande lit un certificat en tant que représentation encodée en Base64. La troisième commande importe le certificat nommé ImportCert01 dans le coffre de clés CosotosoKV01.

Exemple 3 : Importer un certificat de coffre de clés avec 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

Paramètres

-CertificateCollection

Spécifie la collection de certificats à ajouter à un coffre de clés.

Type:	X509Certificate2Collection
Position:	2
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-CertificateString

Représentation encodée en base64 de l’objet de certificat à importer. Ce certificat doit contenir la clé privée.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:	SwitchParameter
Alias:	cf
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ContentType

Spécifie le type du certificat à importer. Considère la chaîne de certificat comme format PFX par défaut.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure

Type:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-FilePath

Spécifie le chemin d’accès du fichier de certificat que cette applet de commande importe.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Name

Spécifie le nom du certificat. Cette applet de commande construit le nom de domaine complet (FQDN) d’un certificat à partir du nom du coffre de clés, de l’environnement actuellement sélectionné et du nom de certificat.

Type:	String
Alias:	CertificateName
Position:	1
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Password

Spécifie le mot de passe d’un fichier de certificat.

Type:	SecureString
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-PolicyObject

Objet en mémoire permettant de spécifier une stratégie de gestion pour le certificat. Exclusif mutuellement à PolicyPath.

Type:	PSKeyVaultCertificatePolicy
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-PolicyPath

Chemin d’accès au fichier pour spécifier la stratégie de gestion pour le certificat qui contient la définition de stratégie encodée JSON. Mutuellement exclusif à PolicyObject.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Tag

Paires clé-valeur sous la forme d’une table de hachage. Par exemple : @{key0="value0 » ; key1=$null ; key2="value2"}

Type:	Hashtable
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-VaultName

Spécifie le nom du coffre de clés dans lequel cette applet de commande importe des certificats. Cette applet de commande construit le nom de domaine complet (FQDN) d’un coffre de clés en fonction du nom et de l’environnement actuellement sélectionné.

Type:	String
Position:	0
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:	SwitchParameter
Alias:	wi
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Entrées

String

X509Certificate2Collection

Hashtable

Sorties

PSKeyVaultCertificate

Partager via

Import-AzKeyVaultCertificate

Syntaxe

Description

Exemples

Exemple 1 : Importer un certificat de coffre de clés

Exemple 2 : Importer un certificat de coffre de clés par CertificateString

Exemple 3 : Importer un certificat de coffre de clés avec PolicyFile

Paramètres

-CertificateCollection

-CertificateString

-Confirm

-ContentType

-DefaultProfile

-FilePath

-Name

-Password

-PolicyObject

-PolicyPath

-Tag

-VaultName

-WhatIf

Entrées

Sorties

Ressources supplémentaires

Partager via

Import-AzKeyVaultCertificate

Syntaxe

Description

Exemples

Exemple 1 : Importer un certificat de coffre de clés

Exemple 2 : Importer un certificat de coffre de clés par CertificateString

Exemple 3 : Importer un certificat de coffre de clés avec PolicyFile

Paramètres

-CertificateCollection

-CertificateString

-Confirm

-ContentType

-DefaultProfile

-FilePath

-Name

-Password

-PolicyObject

-PolicyPath

-Tag

-VaultName

-WhatIf

Entrées

Sorties

Liens associés

Ressources supplémentaires