Add-AzureRmVpnClientRootCertificate
Agrega un certificado raíz de cliente VPN.
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
Add-AzureRmVpnClientRootCertificate
-VpnClientRootCertificateName <String>
-VirtualNetworkGatewayName <String>
-ResourceGroupName <String>
-PublicCertData <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
El cmdlet Add-AzureRmVpnClientRootCertificate agrega un certificado raíz a una puerta de enlace de red virtual. Los certificados raíz son certificados X.509 que identifican la entidad de certificación raíz. Por diseño, todos los certificados usados en la puerta de enlace confían en el certificado raíz. Este cmdlet asigna un certificado existente como certificado raíz de puerta de enlace. Si no tiene un certificado X.509 disponible, puede generar uno a través de la infraestructura de clave pública o usar un generador de certificados como makecert.exe. Para agregar un certificado raíz, debe especificar el nombre del certificado y proporcionar una representación de solo texto del certificado (consulte el parámetro PublicCertData para obtener más información). Azure permite asignar más de un certificado raíz a una puerta de enlace. A menudo, las organizaciones implementan varios certificados raíz que incluyen usuarios de más de una empresa.
Ejemplos
Ejemplo 1: Adición de un certificado raíz de cliente a una puerta de enlace 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:\> Add-AzureRmVpnClientRootCertificate -PublicCertData $CertificateText -ResourceGroupName "ContosoResourceGroup" -VirtualNetworkGatewayName "ContosoVirtualGateway" -VpnClientRootCertificateName "ContosoClientRootCertificate"En este ejemplo se agrega un certificado raíz de cliente a una puerta de enlace virtual denominada ContosoVirtualGateway. El primer comando usa el cmdlet Get-Content para obtener una representación de texto exportada previamente del certificado raíz y almacena los datos de texto de la variable denominada $Text. A continuación, el segundo comando usa un bucle for para extraer todo el texto, excepto la primera línea y la última línea. El texto extraído se almacena en una variable denominada $CertificateText. A continuación, el tercer comando usa el texto almacenado en $CertificateText con el cmdlet Add-AzureRmVpnClientRootCertificate para agregar el certificado raíz a 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 agregar.
Para obtener la representación de texto, exporte el certificado en formato .cer (con codificación Base64), abra el archivo resultante en un editor de texto.
Al hacerlo, verá una salida similar a la siguiente (tenga en cuenta que la salida real contendrá muchas más líneas de texto que la muestra abreviada 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 estos datos mediante comandos de Windows PowerShell similares a estos: $Text = Get-Content -Path "C:\Azure\Certificates\ExportedCertficate.cer"$CertificateText = for ($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 se asigna el certificado raíz. 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 donde se agrega 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 agrega 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 |