Dela via

Remove-AzVpnClientRootCertificate

  • Referens
Modul:
Az.Network

Tar bort ett befintligt VPN-klientrotcertifikat.

Syntax

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

Description

Cmdleten Remove-AzVpnClientRootCertificate tar bort det angivna rotcertifikatet från en virtuell nätverksgateway. Rotcertifikat är X.509-certifikat som identifierar rotcertifikatutfärdare: alla andra certifikat som används på gatewayen litar på rotcertifikatet. Om du tar bort en rotcertifikatdator som använder certifikatet i autentiseringssyfte kan du inte längre ansluta till gatewayen. När du använder Remove-AzVpnClientRootCertcertificate måste du ange både certifikatnamnet och en textrepresentation av certifikatdata. Mer information om textrepresentationen av ett certifikat finns i beskrivningen av parametern PublicCertData .

Exempel

Exempel 1: Ta bort ett klientrotcertifikat från en virtuell nätverksgateway

$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"

Det här exemplet tar bort ett klientrotcertifikat med namnet ContosoRootCertificate från den virtuella nätverksgatewayen ContosoVirtualGateway. Det första kommandot använder cmdleten Get-Content för att hämta en tidigare exporterad textrepresentation av certifikatet. Den här textrepresentationen lagras i en variabel med namnet $Text. Det andra kommandot använder sedan en for-loop för att extrahera all text i $Text förutom den första raden och den sista raden. Den här extraherade texten lagras i en variabel med namnet $CertificateText. Det tredje kommandot använder informationen som lagras i variabeln $CertificateText tillsammans med cmdleten Remove-AzVpnClientRootCertCertificate för att ta bort certifikatet från gatewayen.

Parametrar

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PublicCertData

Anger textrepresentationen av rotcertifikatet som ska tas bort. Om du vill hämta textrepresentationen exporterar du certifikatet i .cer format (med Base64)-kodning och öppnar sedan den resulterande filen i en textredigerare. Du bör se utdata som liknar följande (observera att de faktiska utdata innehåller många fler textrader än det förkortade exemplet som visas här): ----- BEGIN CERTIFICATE ----- MIIC13FAAXC3671Auij9HHgUNEW8343NMJklo0 9982CVVFAw8w ----- END CERTIFICATE ----- The PublicCertData består av alla rader mellan den första raden (----- BEGIN CERTIFICATE -----) och den sista raden (----- END CERTIFICATE -----) i filen. Du kan hämta PublicCertData med hjälp av Windows PowerShell-kommandon som liknar följande: $Text = Get-Content -Path "C:\Azure\Certificates\ExportedCertificate.cer" $CertificateText = för ($i=1; $i -lt $Text.Length -1 ; $i++){$Text[$i]}

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ResourceGroupName

Anger namnet på resursgruppen som den virtuella nätverksgatewayen har tilldelats till. Resursgrupper kategoriserar objekt för att förenkla lagerhantering och allmän Azure-administration.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-VirtualNetworkGatewayName

Anger namnet på den virtuella nätverksgateway som certifikatet tas bort från.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-VpnClientRootCertificateName

Anger namnet på det klientrotcertifikat som den här cmdleten tar bort.

Typ:String
Alias:ResourceName
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

String

Utdata

Boolean