Remove-AzureRmVpnClientRootCertificate
Usuwa istniejący certyfikat główny klienta sieci VPN.
Ostrzeżenie
Moduł AzureRM PowerShell jest oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.
Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.
Składnia
Remove-AzureRmVpnClientRootCertificate
-VpnClientRootCertificateName <String>
-VirtualNetworkGatewayName <String>
-ResourceGroupName <String>
-PublicCertData <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Opis
Polecenie cmdlet Remove-AzureRmVpnClientRootCertificate usuwa określony certyfikat główny z bramy sieci wirtualnej. Certyfikaty główne to certyfikaty X.509 identyfikujące główny urząd certyfikacji: wszystkie inne certyfikaty używane w bramie ufają certyfikatowi głównemu. Jeśli usuniesz komputery z certyfikatami głównymi, które używają certyfikatu do celów uwierzytelniania, nie będą już mogły łączyć się z bramą. W przypadku używania polecenia Remove-AzureRmVpnClientRootCertificate należy podać zarówno nazwę certyfikatu, jak i tekstową reprezentację danych certyfikatu. Aby uzyskać więcej informacji na temat tekstowej reprezentacji certyfikatu, zobacz opis parametru PublicCertData .
Przykłady
Przykład 1. Usuwanie certyfikatu głównego klienta z bramy sieci wirtualnej
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"W tym przykładzie usunięto certyfikat główny klienta o nazwie ContosoRootCertificate z bramy sieci wirtualnej ContosoVirtualGateway. Pierwsze polecenie używa polecenia cmdlet Get-Content , aby uzyskać wcześniej wyeksportowaną reprezentację tekstową certyfikatu. Ta reprezentacja tekstu jest przechowywana w zmiennej o nazwie $Text. Drugie polecenie następnie używa pętli for, aby wyodrębnić cały tekst w $Text z wyjątkiem pierwszego wiersza i ostatniego wiersza. Ten wyodrębniony tekst jest przechowywany w zmiennej o nazwie $CertificateText. Trzecie polecenie używa informacji przechowywanych w zmiennej $CertificateText wraz z poleceniem cmdlet Remove-AzureRmVpnClientRootCertificate w celu usunięcia certyfikatu z bramy.
Parametry
-DefaultProfile
Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.
| Typ: | IAzureContextContainer |
| Aliasy: | AzureRmContext, AzureCredential |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-PublicCertData
Określa tekstowa reprezentacja certyfikatu głównego do usunięcia. Aby uzyskać reprezentację tekstu, wyeksportuj certyfikat w formacie .cer (przy użyciu kodowania Base64), a następnie otwórz wynikowy plik w edytorze tekstów. Powinny zostać wyświetlone dane wyjściowe podobne do następujących (zwróć uwagę, że rzeczywiste dane wyjściowe będą zawierać wiele wierszy tekstu niż skrócony przykład pokazany tutaj): ----- BEGIN CERTIFICATE ----- MIIC13FAAXC3671Auij9HHgUNEW8343NMJklo09982CVFAw8w ----- END CERTIFICATE ----- PublicCertData składa się ze wszystkich wierszy między pierwszym wierszem (----- BEGIN CERTIFICATE -----) i ostatnim wierszem (----- END CERTIFICATE -----). Dane PublicCertData można pobrać przy użyciu poleceń środowiska Windows PowerShell podobnych do następujących: $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 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-ResourceGroupName
Określa nazwę grupy zasobów, do której przypisano bramę sieci wirtualnej. Grupy zasobów kategoryzują elementy, aby ułatwić zarządzanie spisem i ogólną administrację platformy Azure.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-VirtualNetworkGatewayName
Określa nazwę bramy sieci wirtualnej, z którego jest usuwany certyfikat.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-VpnClientRootCertificateName
Określa nazwę certyfikatu głównego klienta, który usuwa to polecenie cmdlet.
| Typ: | String |
| Aliasy: | ResourceName |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |