Remove-AzVpnClientRootCertificate

  • Referencia
Módulo:
Az.Network

Quita un certificado raíz de cliente VPN existente.

Syntax

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

Description

El cmdlet Remove-AzVpnClientRootCertificate quita el certificado raíz especificado de una puerta de enlace de red virtual. Los certificados raíz son certificados X.509 que identifican la entidad de certificación raíz: todos los demás certificados usados en la puerta de enlace confían en el certificado raíz. Si quita un equipo de certificado raíz que usa el certificado con fines de autenticación ya no podrá conectarse a la puerta de enlace. Al usar Remove-AzVpnClientRootCertificate, debe proporcionar el nombre del certificado y una representación de texto de los datos del certificado. Para obtener más información sobre la representación de texto de un certificado, consulte la descripción del parámetro PublicCertData .

Ejemplos

Ejemplo 1: Eliminación de un certificado raíz de cliente de una puerta de enlace de red virtual

$Text = Get-Content -Path "C:\Azure\Certificates\ExportedCertificate.cer"
$CertificateText = for ($i=1; $i -lt $Text.Length -1 ; $i++){$Text[$i]}
Remove-AzVpnClientRootCertificate -PublicCertData $CertificateText -ResourceGroupName "ContosoResourceGroup" -VirtualNetworkGatewayName "ContosoVirtualGateway" -VpnClientRootCertificateName "ContosoRootCertificate"

En este ejemplo se quita un certificado raíz de cliente denominado ContosoRootCertificate de la puerta de enlace de red virtual ContosoVirtualGateway. El primer comando usa el cmdlet Get-Content para obtener una representación de texto exportada previamente del certificado; esta representación de texto se almacena en una variable denominada $Text. A continuación, el segundo comando usa un bucle for para extraer todo el texto de $Text excepto para la primera línea y la última línea. Este texto extraído se almacena en una variable denominada $CertificateText. El tercer comando usa la información almacenada en la variable $CertificateText junto con el cmdlet Remove-AzVpnClientRootCertificate para quitar el certificado de la puerta de enlace.

Parámetros

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublicCertData

Especifica la representación de texto del certificado raíz que se va a quitar. Para obtener la representación de texto, exporte el certificado en formato .cer (mediante la codificación Base64) y, a continuación, abra el archivo resultante en un editor de texto. Debería ver una salida similar a la siguiente (tenga en cuenta que la salida real contendrá muchas más líneas de texto que el ejemplo abreviado que se muestra aquí): ----- BEGIN CERTIFICATE ----- MIIC13FAAXC3671Auij9HHgUNEW8343NMJklo09982CVVFAw8w ----- END CERTIFICATE ----- The PublicCertData se compone de todas las líneas entre la primera línea (----- BEGIN CERTIFICATE -----) y la última línea (----- END CERTIFICATE -----) en el archivo. Puede recuperar PublicCertData con comandos de Windows PowerShell similares a los siguientes: $Text = Get-Content -Path "C:\Azure\Certificates\ExportedCertificate.cer" $CertificateText = para ($i=1; $i -lt $Text.Length -1 ; $i++){$Text[$i]}

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Especifica el nombre del grupo de recursos al que está asignada la puerta de enlace de red virtual. Los grupos de recursos clasifican los elementos para ayudar a simplificar la administración del inventario y la administración general de Azure.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VirtualNetworkGatewayName

Especifica el nombre de la puerta de enlace de red virtual de la que se quita el certificado.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VpnClientRootCertificateName

Especifica el nombre del certificado raíz del cliente que quita este cmdlet.

Type:String
Aliases:ResourceName
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Entradas

String

Salidas

Boolean