New-AzureRmVpnClientRootCertificate
Crée un certificat racine du client VPN.
Avertissement
Le module AzureRM PowerShell a été officiellement déconseillé depuis le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.
Bien que le module AzureRM puisse toujours fonctionner, il n’est plus conservé ou pris en charge, plaçant toute utilisation continue à la discrétion et au risque de l’utilisateur. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.
Syntax
New-AzureRmVpnClientRootCertificate
-Name <String>
-PublicCertData <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
L’applet de commande New-AzureRmVpnClientRootCertificate crée un certificat racine VPN à utiliser sur une passerelle de réseau virtuel.
Les certificats racines sont des certificats X.509 qui identifient votre autorité de certification racine : tous les autres certificats utilisés sur la passerelle approuvent le certificat racine.
Cette applet de commande crée un certificat autonome qui n’est pas affecté à une passerelle virtuelle.
Au lieu de cela, le certificat créé par New-AzureRmVpnClientRootCertificate est utilisé conjointement avec l’applet de commande New-AzureRmVirtualNetworkGateway lors de la création d’une passerelle.
Par exemple, supposons que vous créez un certificat et le stockez dans une variable nommée $Certificate.
Vous pouvez ensuite utiliser cet objet de certificat lors de la création d’une passerelle virtuelle.
Par exemple, .New-AzureRmVirtualNetworkGateway -Name "ContosoVirtualGateway" -ResourceGroupName "ContosoResourceGroup" -Location "West US" -GatewayType "VPN" -IpConfigurations $Ipconfig -VPNType "RouteBased" -VpnClientRootCertificates $Certificate Pour plus d’informations, consultez la documentation de l’applet de commande New-AzureRmVirtualNetworkGateway.
Exemples
Exemple 1 : Créer un certificat racine aclient
PS C:\> $Text = Get-Content -Path "C:\Azure\Certificates\ExportedCertficate.cer"
PS C:\> $CertificateText = for ($i=1; $i -lt $Text.Length -1 ; $i++){$Text[$i]}
PS C:\> $Certificate = New-AzureRmVpnClientRootCertificate -PublicCertData $CertificateText -Name "ContosoClientRootCertificate"Cet exemple crée un certificat racine client et stocke l’objet de certificat dans une variable nommée $Certificate. Cette variable peut ensuite être utilisée par l’applet de commande New-AzureRmVirtualNetworkGateway pour ajouter un certificat racine à une nouvelle passerelle de réseau virtuel. 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 ; ces données de texte sont stockées dans une 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, en stockant le texte extrait dans une variable nommée $CertificateText. La troisième commande utilise l’applet de commande New-AzureRmVpnClientRootCertificate pour créer le certificat, en stockant l’objet créé dans une variable nommée $Certificate.
Paramètres
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
| Type: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| valeur par défaut: | None |
| Obligatoire: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Spécifie un nom pour le nouveau certificat racine du client.
| Type: | String |
| Position: | Named |
| valeur par défaut: | None |
| Obligatoire: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PublicCertData
Spécifie une 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. Vous devez voir la sortie similaire à celle-ci (notez que la sortie réelle contiendra beaucoup plus de lignes de texte que l’exemple abrégé illustré ici) : ----- BEGIN CERTIFICATE ----- MIIC13FAAXC3671Auij9HHgUNEW8343NMJklo09982CVVFAw8w ----- 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 publicCertData à l’aide de commandes Windows PowerShell similaires à ceci : $Text = Get-Content -Path « C :\Azure\Certificates\ExportedCertficate.cer » $CertificateText = for ($i=1 ; $i -lt $Text.Length -1 ; $i++){$Text[$i]}
| Type: | String |
| Position: | Named |
| valeur par défaut: | None |
| Obligatoire: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |