Add-AzureRmVpnClientRootCertificate
Adiciona um certificado raiz do cliente VPN.
Aviso
O módulo PowerShell do AzureRM foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.
Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.
Sintaxe
Add-AzureRmVpnClientRootCertificate
-VpnClientRootCertificateName <String>
-VirtualNetworkGatewayName <String>
-ResourceGroupName <String>
-PublicCertData <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
O cmdlet Add-AzureRmVpnClientRootCertificate adiciona um certificado raiz a um gateway de rede virtual. Os certificados raiz são certificados X.509 que identificam sua Autoridade de Certificação Raiz. Por design, todos os certificados usados no gateway confiam no certificado raiz. Esse cmdlet atribui um certificado existente como um certificado raiz de gateway. Se você não tiver um certificado X.509 disponível, poderá gerar um por meio de sua infraestrutura de chave pública ou usar um gerador de certificados, como o makecert.exe. Para adicionar um certificado raiz, você deve especificar o nome do certificado e fornecer uma representação somente texto do certificado (consulte o parâmetro PublicCertData para obter mais informações). O Azure permite que você atribua mais de um certificado raiz a um gateway. Vários certificados raiz geralmente são implantados por organizações que incluem usuários de mais de uma empresa.
Exemplos
Exemplo 1: Adicionar um certificado raiz do cliente a um gateway 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"Este exemplo adiciona um certificado raiz do cliente a um gateway virtual chamado ContosoVirtualGateway. O primeiro comando usa o cmdlet Get-Content para obter uma representação de texto exportada anteriormente do certificado raiz e armazena esses dados de texto na variável chamada $Text. O segundo comando usa um loop for para extrair todo o texto, exceto a primeira linha e a última linha. O texto extraído é armazenado em uma variável chamada $CertificateText. Em seguida, o terceiro comando usa o texto armazenado em $CertificateText com o cmdlet Add-AzureRmVpnClientRootCertificate para adicionar o certificado raiz ao gateway.
Parâmetros
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.
| Tipo: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-PublicCertData
Especifica a representação de texto do certificado raiz a ser adicionado.
Para obter a representação de texto, exporte seu certificado em .cer formato (usando a codificação Base64) e abra o arquivo resultante em um editor de texto.
Ao fazer isso, você verá uma saída semelhante à seguinte (observe que a saída real conterá muito mais linhas de texto do que o exemplo abreviado mostrado aqui): ----- BEGIN CERTIFICATE ----- MIIC13FAAXC3671Auij9HHgUNEW8343NMJklo09982CVVFAw8w ----- END CERTIFICATE ----- O PublicCertData é composto por todas as linhas entre a primeira linha (----- BEGIN CERTIFICATE -----) e a última linha (----- END CERTIFICATE -----) no arquivo.
Você pode recuperar esses dados usando comandos do Windows PowerShell semelhantes a este: $Text = Get-Content -Path "C:\Azure\Certificates\ExportedCertficate.cer"$CertificateText = for ($i=1; $i -lt $Text.Length -1 ; $i++){$Text\[$i\]}
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-ResourceGroupName
Especifica o nome do grupo de recursos ao qual o certificado raiz está atribuído. Os grupos de recursos categorizam itens para ajudar a simplificar o gerenciamento de inventário e a administração geral do Azure.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-VirtualNetworkGatewayName
Especifica o nome do gateway de rede virtual em que o certificado é adicionado.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-VpnClientRootCertificateName
Especifica o nome do certificado raiz do cliente que esse cmdlet adiciona.
| Tipo: | String |
| Aliases: | ResourceName |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |