Remove-AzureRmVpnClientRootCertificate
Quita un certificado raíz de cliente VPN existente.
Advertencia
El módulo AzureRM PowerShell ha quedado oficialmente obsoleto a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.
Aunque el módulo AzureRM puede seguir funcionando, ya no recibirá mantenimiento ni soporte técnico, lo que significa que su uso continuado queda a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.
Sintaxis
Remove-AzureRmVpnClientRootCertificate
-VpnClientRootCertificateName <String>
-VirtualNetworkGatewayName <String>
-ResourceGroupName <String>
-PublicCertData <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
El cmdlet Remove-AzureRmVpnClientRootCertificate 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-AzureRmVpnClientRootCertificate, 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
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"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-AzureRmVpnClientRootCertificate 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.
| Tipo: | IAzureContextContainer |
| Alias: | AzureRmContext, AzureCredential |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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 mediante comandos de Windows PowerShell similares a los siguientes: $Text = Get-Content -Path "C:\Azure\Certificates\ExportedCertficate.cer" $CertificateText = para ($i=1; $i -lt $Text.Length -1 ; $i++){$Text[$i]}
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | 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.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-VirtualNetworkGatewayName
Especifica el nombre de la puerta de enlace de red virtual de la que se quita el certificado.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-VpnClientRootCertificateName
Especifica el nombre del certificado raíz del cliente que quita este cmdlet.
| Tipo: | String |
| Alias: | ResourceName |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |