Não foi possível criar o canal seguro SSL/TLS

Problema

Ao executar um script PowerShell que usa Invoke-WebRequest, pode aparecer o seguinte erro:

Invoke-WebRequest : The request was aborted: Could not create SSL/TLS secure channel.

Isso ocorre porque o script está tentando se conectar a um servidor usando protocolos seguros (TLS/SSL), mas os protocolos necessários (como TLS 1.2) não estão habilitados no sistema.

Soluções

Temporária
Permanente

Para resolver rapidamente esse problema na sessão atual, você pode habilitar os protocolos necessários executando o seguinte comando na sua sessão PowerShell:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls11 -bor ` [Net.SecurityProtocolType]::Tls12 -bor ` [Net.SecurityProtocolType]::Tls -bor ` [Net.SecurityProtocolType]::Ssl3

No entanto, essa correção é temporária e precisa ser reaplicada em cada nova sessão PowerShell.

Para resolver permanentemente esse problema e garantir que todas as aplicações baseadas em .NET, incluindo o PowerShell, usem protocolos seguros por padrão, atualize o registro do sistema.

Etapas para corrigir:

Abra uma sessão PowerShell com privilégios elevados (Executar como administrador).
Execute os seguintes comandos para atualizar o registro:

Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\.NETFramework\v4.0.30319" -Name "SchUseStrongCrypto" -Value 1 -Type DWord 
Set-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\.NETFramework\v4.0.30319" -Name "SystemDefaultTlsVersions" -Value 1 -Type DWord

Aplique também as alterações à chave de registro do .NET Framework de 64 bits:

Set-ItemProperty -Path "HKLM:\SOFTWARE\WOW6432Node\Microsoft\.NETFramework\v4.0.30319" -Name "SchUseStrongCrypto" -Value 1 -Type DWord 
Set-ItemProperty -Path "HKLM:\SOFTWARE\WOW6432Node\Microsoft\.NETFramework\v4.0.30319" -Name "SystemDefaultTlsVersions" -Value 1 -Type DWord

Reinicie o sistema para garantir que as alterações sejam aplicadas.

Explicação das chaves de registro

Configuração do registro	Descrição
SchUseStrongCrypto	Força o .NET Framework a usar protocolos criptográficos fortes (por exemplo, TLS 1.2).
SystemDefaultTlsVersions	Garante que as aplicações .NET usem a versão TLS padrão do sistema, permitindo que se adaptem a protocolos mais novos.

Se o erro persistir

Se o erro persistir, considere as seguintes ações para garantir conexões seguras em todas as aplicações .NET sem intervenção manual em cada sessão:

Verifique se o seu sistema é compatível com TLS 1.2 e se ele está habilitado no sistema operacional.
Atualize para o PowerShell Core ou PowerShell 7, que usam protocolos de segurança modernos por padrão.

Instalar as ferramentas de monitoramento

Monitorar

Guias práticos

Solução de problemas

Não foi possível criar o canal seguro SSL/TLS

Problema

Soluções

Etapas para corrigir:

Explicação das chaves de registro

Se o erro persistir

​Problema

​Soluções

​Etapas para corrigir:

​Explicação das chaves de registro

​Se o erro persistir

Problema

Soluções

Etapas para corrigir:

Explicação das chaves de registro

Se o erro persistir