Remove-AzVpnClientRootCertificate
Odebere existující kořenový certifikát klienta VPN.
Syntaxe
Remove-AzVpnClientRootCertificate
-VpnClientRootCertificateName <String>
-VirtualNetworkGatewayName <String>
-ResourceGroupName <String>
-PublicCertData <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
Rutina Remove-AzVpnClientRootCertificate odebere zadaný kořenový certifikát z brány virtuální sítě. Kořenové certifikáty jsou certifikáty X.509, které identifikují vaši kořenovou certifikační autoritu: všechny ostatní certifikáty používané v bráně důvěřují kořenovému certifikátu. Pokud odeberete počítače s kořenovým certifikátem, které certifikát používají pro účely ověřování, už se nebudou moct připojit k bráně. Pokud používáte Remove-AzVpnClientRootCertificate, musíte zadat název certifikátu i textovou reprezentaci dat certifikátu. Další informace o textové reprezentaci certifikátu naleznete v popisu parametru PublicCertData .
Příklady
Příklad 1: Odebrání kořenového certifikátu klienta z brány virtuální sítě
$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"
Tento příklad odebere kořenový certifikát klienta s názvem ContosoRootCertificate z brány virtuální sítě ContosoVirtualGateway. První příkaz používá rutinu Get-Content k získání dříve exportované textové reprezentace certifikátu; tato textová reprezentace je uložena v proměnné s názvem $Text. Druhý příkaz pak pomocí smyčky for extrahuje veškerý text v $Text s výjimkou prvního řádku a posledního řádku. Tento extrahovaný text je uložen v proměnné s názvem $CertificateText. Třetí příkaz používá informace uložené v proměnné $CertificateText spolu s rutinou Remove-AzVpnClientRootCertificate k odebrání certifikátu z brány.
Parametry
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.
Typ: | IAzureContextContainer |
Aliasy: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-PublicCertData
Určuje textové vyjádření kořenového certifikátu, který se má odebrat. Pokud chcete získat textovou reprezentaci, exportujte certifikát ve formátu .cer (pomocí kódování Base64) a pak otevřete výsledný soubor v textovém editoru. Měl by se zobrazit výstup podobný následujícímu (všimněte si, že skutečný výstup bude obsahovat mnohem více řádků textu, než je zkrácená ukázka zobrazená zde): ----- BEGIN CERTIFICATE ----- MIIC13FAAXC3671Auij9HHgUNEW8343NMJklo0 9982CVVFAw8w ----- END CERTIFICATE ----- PublicCertData se skládá ze všech řádků mezi prvním řádkem (----- BEGIN CERTIFICATE -----) a posledním řádkem (----- END CERTIFICATE -----) v souboru. PublicCertData můžete načíst pomocí příkazů Prostředí Windows PowerShell podobných tomuto: $Text = Get-Content -Path "C:\Azure\Certificates\ExportedCertificate.cer" $CertificateText = for ($i=1; $i -lt $Text.Length -1; $i++){$Text[$i]}
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-ResourceGroupName
Určuje název skupiny prostředků, ke které je přiřazena brána virtuální sítě. Skupiny prostředků kategorizují položky, které pomáhají zjednodušit správu inventáře a obecnou správu Azure.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-VirtualNetworkGatewayName
Určuje název brány virtuální sítě, ze které se certifikát odebere.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-VpnClientRootCertificateName
Určuje název kořenového certifikátu klienta, který tato rutina odebere.
Typ: | String |
Aliasy: | ResourceName |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |