Compartir a través de


Remove-AzVpnClientRootCertificate

Quita un certificado raíz de cliente VPN existente.

Sintaxis

Default (valor predeterminado)

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.

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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\ExportedCertificate.cer" $CertificateText = para ($i=1; $i -lt $Text.Length -1 ; $i++){$Text[$i]}

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-VirtualNetworkGatewayName

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-VpnClientRootCertificateName

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:nombreDelRecurso

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

String

Salidas

Boolean