Add-AzureRmVpnClientRootCertificate
Menambahkan sertifikat akar klien VPN.
Peringatan
Modul AzureRM PowerShell telah resmi tidak digunakan lagi per 29 Februari 2024. Pengguna disarankan untuk bermigrasi dari AzureRM ke modul Az PowerShell untuk memastikan dukungan dan pembaruan yang berkelanjutan.
Meskipun modul AzureRM mungkin masih berfungsi, modul tersebut tidak lagi dipertahankan atau didukung, menempatkan penggunaan berkelanjutan berdasarkan kebijaksanaan dan risiko pengguna. Silakan merujuk ke sumber daya migrasi kami untuk panduan tentang transisi ke modul Az.
Sintaks
Add-AzureRmVpnClientRootCertificate
-VpnClientRootCertificateName <String>
-VirtualNetworkGatewayName <String>
-ResourceGroupName <String>
-PublicCertData <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Deskripsi
Cmdlet Add-AzureRmVpnClientRootCertificate menambahkan sertifikat akar ke gateway jaringan virtual. Sertifikat akar adalah sertifikat X.509 yang mengidentifikasi Otoritas Sertifikasi Akar Anda. Secara desain, semua sertifikat yang digunakan pada gateway mempercayai sertifikat akar. Cmdlet ini menetapkan sertifikat yang sudah ada sebagai sertifikat akar gateway. Jika Anda tidak memiliki sertifikat X.509 yang tersedia, Anda dapat membuatnya melalui infrastruktur kunci publik Anda atau menggunakan generator sertifikat seperti makecert.exe. Untuk menambahkan sertifikat akar, Anda harus menentukan nama sertifikat dan memberikan representasi sertifikat khusus teks (lihat parameter PublicCertData untuk informasi selengkapnya). Azure memungkinkan Anda menetapkan lebih dari satu sertifikat akar ke gateway. Beberapa sertifikat akar sering disebarkan oleh organisasi yang menyertakan pengguna dari lebih dari satu perusahaan.
Contoh
Contoh 1: Menambahkan sertifikat akar klien ke gateway virtual
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:\> Add-AzureRmVpnClientRootCertificate -PublicCertData $CertificateText -ResourceGroupName "ContosoResourceGroup" -VirtualNetworkGatewayName "ContosoVirtualGateway" -VpnClientRootCertificateName "ContosoClientRootCertificate"Contoh ini menambahkan sertifikat akar klien ke gateway virtual bernama ContosoVirtualGateway. Perintah pertama menggunakan cmdlet Get-Content untuk mendapatkan representasi teks yang diekspor sebelumnya dari sertifikat akar dan menyimpan data teks yang diberi nama variabel $Text. Perintah kedua kemudian menggunakan perulangan untuk mengekstrak semua teks kecuali untuk baris pertama dan baris terakhir. Teks yang diekstrak disimpan dalam variabel bernama $CertificateText. Perintah ketiga kemudian menggunakan teks yang disimpan di $CertificateText dengan cmdlet Add-AzureRmVpnClientRootCertificate untuk menambahkan sertifikat akar ke gateway.
Parameter
-DefaultProfile
Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure.
| Jenis: | IAzureContextContainer |
| Alias: | AzureRmContext, AzureCredential |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | False |
| Terima input alur: | False |
| Terima karakter wildcard: | False |
-PublicCertData
Menentukan representasi teks sertifikat akar yang akan ditambahkan.
Untuk mendapatkan representasi teks, ekspor sertifikat Anda dalam format .cer (menggunakan pengodean Base64), lalu buka file yang dihasilkan di editor teks.
Ketika Anda melakukannya, Anda akan melihat output yang mirip dengan berikut (perhatikan bahwa output aktual akan berisi lebih banyak baris teks daripada sampel singkatan yang ditunjukkan di sini): ----- BEGIN CERTIFICATE ----- MIIC13FAAXC3671Auij9HHgUNEW8343NMJklo09982CVVFAw8w ----- SERTIFIKAT AKHIR ----- PublicCertData terdiri dari semua baris antara baris pertama (----- BEGIN CERTIFICATE -----) dan baris terakhir (----- END CERTIFICATE -----) dalam file.
Anda dapat mengambil data ini dengan menggunakan perintah Windows PowerShell yang mirip dengan ini: $Text = Get-Content -Path "C:\Azure\Certificates\ExportedCertficate.cer"$CertificateText = for ($i=1; $i -lt $Text.Length -1 ; $i++){$Text\[$i\]}
| Jenis: | String |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | True |
| Terima input alur: | True |
| Terima karakter wildcard: | False |
-ResourceGroupName
Menentukan nama grup sumber daya tempat sertifikat akar ditetapkan. Grup sumber daya mengategorikan item untuk membantu menyederhanakan manajemen inventarisasi dan administrasi Azure umum.
| Jenis: | String |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | True |
| Terima input alur: | True |
| Terima karakter wildcard: | False |
-VirtualNetworkGatewayName
Menentukan nama gateway jaringan virtual tempat sertifikat ditambahkan.
| Jenis: | String |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | True |
| Terima input alur: | True |
| Terima karakter wildcard: | False |
-VpnClientRootCertificateName
Menentukan nama sertifikat akar klien yang ditambahkan cmdlet ini.
| Jenis: | String |
| Alias: | ResourceName |
| Position: | Named |
| Nilai default: | None |
| Diperlukan: | True |
| Terima input alur: | True |
| Terima karakter wildcard: | False |