Partager via

Add-AzVpnClientRootCertificate

  • Référence
Module:
Az.Network

Ajoute un certificat racine client VPN.

Syntaxe

Add-AzVpnClientRootCertificate
   -VpnClientRootCertificateName <String>
   -VirtualNetworkGatewayName <String>
   -ResourceGroupName <String>
   -PublicCertData <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

L’applet de commande Add-AzVpnClientRootCertificate ajoute un certificat racine à une passerelle de réseau virtuel. Les certificats racines sont des certificats X.509 qui identifient votre autorité de certification racine. Par conception, tous les certificats utilisés sur la passerelle approuvent le certificat racine. Cette applet de commande affecte un certificat existant en tant que certificat racine de passerelle. Si vous n’avez pas de certificat X.509 disponible, vous pouvez en générer un via votre infrastructure de clé publique ou utiliser un générateur de certificats tel que makecert.exe. Pour ajouter un certificat racine, vous devez spécifier le nom du certificat et fournir une représentation textuelle du certificat (voir paramètre PublicCertData pour plus d’informations). Azure vous permet d’affecter plusieurs certificats racines à une passerelle. Plusieurs certificats racines sont souvent déployés par les organisations qui incluent des utilisateurs de plusieurs entreprises.

Exemples

Exemple 1 : Ajouter un certificat racine client à une passerelle virtuelle

$Text = Get-Content -Path "C:\Azure\Certificates\ExportedCertificate.cer"
$CertificateText = for ($i=1; $i -lt $Text.Length -1 ; $i++){$Text[$i]}
Add-AzVpnClientRootCertificate -PublicCertData $CertificateText -ResourceGroupName "ContosoResourceGroup" -VirtualNetworkGatewayName "ContosoVirtualGateway" -VpnClientRootCertificateName "ContosoClientRootCertificate"

Cet exemple ajoute un certificat racine client à une passerelle virtuelle nommée ContosoVirtualGateway. La première commande utilise l’applet de commande Get-Content pour obtenir une représentation textuelle précédemment exportée du certificat racine et stocke ces données de texte que la variable nommée $Text. La deuxième commande utilise ensuite une boucle for pour extraire tout le texte, à l’exception de la première ligne et de la dernière ligne. Le texte extrait est stocké dans une variable nommée $CertificateText. La troisième commande utilise ensuite le texte stocké dans $CertificateText avec l’applet de commande Add-AzVPNClientRootCertificate pour ajouter le certificat racine à la passerelle.

Paramètres

-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

-PublicCertData

Spécifie la représentation textuelle du certificat racine à ajouter. Pour obtenir la représentation textuelle, exportez votre certificat au format .cer (à l’aide de l’encodage Base64), puis ouvrez le fichier résultant dans un éditeur de texte. Lorsque vous faites cela, vous verrez une sortie similaire à ce qui suit (notez que la sortie réelle contiendra de nombreuses lignes de texte supplémentaires que l’exemple abrégé illustré ici) : ----- BEGIN CERTIFICATE ----- MIIC13FAAXC3671Auij9HgUNEW8343NMJklo09982CVVFAw8w ----- END CERTIFICATE ----- The PublicCertData est constitué de toutes les lignes entre la première ligne (----- BEGIN CERTIFICATE -----) et la dernière ligne (----- END CERTIFICATE -----) dans le fichier. Vous pouvez récupérer ces données à l’aide de commandes Windows PowerShell similaires à ceci : $Text = Get-Content -Path "C:\Azure\Certificates\ExportedCertificate.cer"$CertificateText = for ($i=1; $i -lt $Text.Length -1 ; $i++){$Text\[$i\]}

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

-ResourceGroupName

Spécifie le nom du groupe de ressources auquel le certificat racine est affecté. Les groupes de ressources classent les éléments pour simplifier la gestion des stocks et l’administration générale d’Azure.

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

-VirtualNetworkGatewayName

Spécifie le nom de la passerelle de réseau virtuel où le certificat est ajouté.

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

-VpnClientRootCertificateName

Spécifie le nom du certificat racine du client ajouté par cette applet de commande.

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

Entrées

String

Sorties

PSVpnClientRootCertificate