Remove-AzVpnClientRootCertificate

  • Référence
Module:
Az.Network

Supprime un certificat racine du client VPN existant.

Syntaxe

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

Description

L’applet de commande Remove-AzVpnClientRootCertificate 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-AzVpnClientRootCertificate, 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

$Text = Get-Content -Path "C:\Azure\Certificates\ExportedCertificate.cer"
$CertificateText = for ($i=1; $i -lt $Text.Length -1 ; $i++){$Text[$i]}
Remove-AzVpnClientRootCertificate -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-AzVpnClientRootCertificate 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: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 à 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\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 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