Partager via

Remove-AzureRmVpnClientRootCertificate

  • Référence
Module:
AzureRM.Network

Supprime un certificat racine du client VPN existant.

Avertissement

Le module AzureRM PowerShell a été officiellement déprécié 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.

Il est possible que le module AzureRM fonctionne encore, mais il ne fait plus l’objet de maintenance ni de support. L’utilisateur peut continuer à s’en servir s’il le souhaite, à ses propres risques. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntaxe

Remove-AzureRmVpnClientRootCertificate
      -VpnClientRootCertificateName <String>
      -VirtualNetworkGatewayName <String>
      -ResourceGroupName <String>
      -PublicCertData <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Description

L’applet de commande Remove-AzureRmVpnClientRootCertificate supprime le certificat racine spécifié d’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. Si vous supprimez des ordinateurs de certificat racine qui utilisent le certificat à des fins d’authentification, vous ne pourrez plus vous connecter à la passerelle. Lorsque vous utilisez Remove-AzureRmVpnClientRootCertificate, vous devez fournir le nom du certificat et une représentation textuelle des données de certificat. Pour plus d’informations sur la représentation textuelle d’un certificat, consultez la description du paramètre PublicCertData .

Exemples

Exemple 1 : Supprimer un certificat racine client d’une passerelle de réseau virtuel

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:\> Remove-AzureRmVpnClientRootCertificate -PublicCertData $CertificateText -ResourceGroupName "ContosoResourceGroup" -VirtualNetworkGatewayName "ContosoVirtualGateway"-VpnClientRootCertificateName "ContosoRootCertificate"

Cet exemple supprime un certificat racine client nommé ContosoRootCertificate de la passerelle de réseau virtuel 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 ; cette représentation de texte est stockée dans une variable nommée $Text. La deuxième commande utilise ensuite une boucle for pour extraire tout le texte dans $Text à l’exception de la première ligne et de la dernière ligne. Ce texte extrait est stocké dans une variable nommée $CertificateText. La troisième commande utilise les informations stockées dans la variable $CertificateText ainsi que l’applet de commande Remove-AzureRmVpnClientRootCertificate pour supprimer le certificat de la passerelle.

Paramètres

-DefaultProfile

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

Type:IAzureContextContainer
Alias: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 à supprimer. Pour obtenir la représentation textuelle, exportez votre certificat au format .cer (à l’aide de Base64), puis ouvrez le fichier résultant dans un éditeur de texte. Vous devez voir la sortie semblable à 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 ----- 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
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 la passerelle de réseau virtuel est affectée. 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 à partir de laquelle le certificat est supprimé.

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 que cette applet de commande supprime.

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

Boolean