Remove-AzureRmVpnClientRootCertificate
Tar bort ett befintligt VPN-klientrotcertifikat.
Varning
AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.
Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.
Syntax
Remove-AzureRmVpnClientRootCertificate
-VpnClientRootCertificateName <String>
-VirtualNetworkGatewayName <String>
-ResourceGroupName <String>
-PublicCertData <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
Cmdleten Remove-AzureRmVpnClientRootCertificate 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-AzureRmVpnClientRootCertificate 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
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"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-AzureRmVpnClientRootCertificate 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: | 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\ExportedCertficate.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 |