次の方法で共有

Remove-AzureRmVpnClientRootCertificate

  • リファレンス
モジュール:
AzureRM.Network

既存の VPN クライアント ルート証明書を削除します。

警告

AzureRM PowerShell モジュールは、2024 年 2 月 29 日に正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。

AzureRM モジュールの機能は今後も使用できますが、メンテナンスやサポートは行われないため、引き続きの使用はユーザーの判断に委ねられ、リスクが発生することがあります。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

構文

Remove-AzureRmVpnClientRootCertificate
      -VpnClientRootCertificateName <String>
      -VirtualNetworkGatewayName <String>
      -ResourceGroupName <String>
      -PublicCertData <String>
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

説明

Remove-AzureRmVpnClientRootCertificate コマンドレットは、指定されたルート証明書を仮想ネットワーク ゲートウェイから削除します。 ルート証明書は、ルート証明機関を識別する X.509 証明書です。ゲートウェイで使用される他のすべての証明書は、ルート証明書を信頼します。 認証のために証明書を使用するルート証明書コンピューターを削除すると、ゲートウェイに接続できなくなります。 Remove-AzureRmVpnClientRootCertificate を使用する場合は、証明書の名前と証明書データのテキスト表現の両方を指定する必要があります。 証明書のテキスト表現の詳細については、 PublicCertData パラメーターの説明を参照してください。

例

例 1: 仮想ネットワーク ゲートウェイからクライアント ルート証明書を削除する

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"

この例では、ContosoRootCertificate という名前のクライアント ルート証明書を仮想ネットワーク ゲートウェイ ContosoVirtualGateway から削除します。 最初のコマンドでは、 Get-Content コマンドレットを使用して、以前にエクスポートされた証明書のテキスト表現を取得します。このテキスト表現は、$Textという名前の変数に格納されます。 次に、2 番目のコマンドは for ループを使用して、最初の行と最後の行を除く、$Text内のすべてのテキストを抽出します。 この抽出されたテキストは、$CertificateTextという名前の変数に格納されます。 3 番目のコマンドでは、$CertificateText変数に格納されている情報と Remove-AzureRmVpnClientRootCertificate コマンドレットを使用して、ゲートウェイから証明書を削除します。

パラメーター

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

型:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PublicCertData

削除するルート証明書のテキスト表現を指定します。 テキスト表現を取得するには、(Base64 を使用して) .cer形式で証明書をエクスポートし、結果のファイルをテキスト エディターで開きます。 次のような出力が表示されます (実際の出力には、次に示す省略されたサンプルよりも多くの行のテキストが含まれていることに注意してください)。 ----- BEGIN CERTIFICATE ----- MIIC13FAAXC3671Auij9HHgUNEW8343NMJklo09 982CVVFAw8w ----- END CERTIFICATE ----- PublicCertData は、ファイル内の最初の行 (----- BEGIN CERTIFICATE -----) と最後の行 (----- END CERTIFICATE -----) の間のすべての行で構成されます。 次のような Windows PowerShell コマンドを使用して PublicCertData を取得できます。$Text = Get-Content -Path "C:\Azure\Certificates\ExportedCertficate.cer" $CertificateText = for ($i=1; $i -lt $Text.Length -1 ; $i++){$Text[$i]}

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ResourceGroupName

仮想ネットワーク ゲートウェイが割り当てられているリソース グループの名前を指定します。 リソース グループは、インベントリ管理と一般的な Azure 管理を簡素化するために項目を分類します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-VirtualNetworkGatewayName

証明書が削除される仮想ネットワーク ゲートウェイの名前を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-VpnClientRootCertificateName

このコマンドレットが削除するクライアント ルート証明書の名前を指定します。

型:String
Aliases:ResourceName
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

入力

String

出力

Boolean