Add-AzVpnClientRootCertificate
新增 VPN 用戶端跟證書。
語法
Add-AzVpnClientRootCertificate
-VpnClientRootCertificateName <String>
-VirtualNetworkGatewayName <String>
-ResourceGroupName <String>
-PublicCertData <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
Add-AzVpnClientRootCertificate Cmdlet 會將跟證書新增至虛擬網路網關。 跟證書是 X.509 憑證，可識別您的跟證書授權單位。 根據設計，閘道上使用的所有憑證都會信任跟證書。 此 Cmdlet 會將現有的憑證指派為閘道跟證書。 如果您沒有可用的 X.509 憑證，您可以透過公鑰基礎結構產生一個憑證，或使用憑證產生器，例如 makecert.exe。 若要新增跟證書，您必須指定憑證名稱並提供僅限文字的憑證表示法（如需詳細資訊，請參閱 PublicCertData 參數）。 Azure 可讓您將多個跟證書指派給閘道。 組織通常會部署多個跟證書，這些組織包含來自多個公司的使用者。
範例
範例 1：將用戶端跟證書新增至虛擬閘道
$Text = Get-Content -Path "C:\Azure\Certificates\ExportedCertificate.cer"
$CertificateText = for ($i=1; $i -lt $Text.Length -1 ; $i++){$Text[$i]}
Add-AzVpnClientRootCertificate -PublicCertData $CertificateText -ResourceGroupName "ContosoResourceGroup" -VirtualNetworkGatewayName "ContosoVirtualGateway" -VpnClientRootCertificateName "ContosoClientRootCertificate"此範例會將用戶端跟證書新增至名為 ContosoVirtualGateway 的虛擬閘道。 第一個命令會使用 Get-Content Cmdlet 來取得先前導出的跟證書文字表示法，並儲存名為 $Text 變數的文字數據。 第二個命令接著會使用 for 循環來擷取第一行和最後一行以外的所有文字。 擷取的文字會儲存在名為 $CertificateText的變數中。 第三個命令接著會使用儲存在 $CertificateText 中的文字搭配 Add-AzVpnClientRootCertificate Cmdlet，將跟證書新增至網關。
參數
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
| 類型: | IAzureContextContainer |
| 別名: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PublicCertData
指定要加入之跟證書的文字表示。
若要取得文字表示法，請使用 .cer 格式匯出您的憑證（使用Base64編碼），然後在文本編輯器中開啟產生的檔案。
當您這樣做時，您會看到類似下列的輸出（請注意，實際輸出將包含比此處所示的縮寫範例更多的文字行）：----- BEGIN CERTIFICATE ----- MIIC13FAAXC3671Auij9HHgUNEW8343NMJklo0998 2CVVVFAw8w ----- END CERTIFICATE ----- PublicCertData 是由檔案中第一行 （----- BEGIN CERTIFICATE -----） 與最後一行 （----- END CERTIFICATE -----） 之間的所有行所組成。
您可以使用類似下列的 Windows PowerShell 命令來擷取此數據：$Text = Get-Content -Path "C:\Azure\Certificates\ExportedCertificate.cer"$CertificateText = for ($i=1; $i -lt $Text.Length -1 ; $i++){$Text\[$i\]}
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ResourceGroupName
指定指派跟證書的資源群組名稱。 資源群組會將項目分類，以協助簡化庫存管理和一般 Azure 系統管理。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-VirtualNetworkGatewayName
指定新增憑證的虛擬網路網關名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-VpnClientRootCertificateName
指定此 Cmdlet 新增的用戶端跟證書名稱。
| 類型: | String |
| 別名: | ResourceName |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
