Remove-AzureRmVpnClientRootCertificate
Odebere existující kořenový certifikát klienta VPN.
Upozorňující
Modul AzureRM PowerShell je od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.
I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.
Syntaxe
Remove-AzureRmVpnClientRootCertificate
-VpnClientRootCertificateName <String>
-VirtualNetworkGatewayName <String>
-ResourceGroupName <String>
-PublicCertData <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
Rutina Remove-AzureRmVpnClientRootCertificate 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-AzureRmVpnClientRootCertificate, 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ě
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"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-AzureRmVpnClientRootCertificate 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: | 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\ExportedCertficate.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 |