/
/

Como usar o PowerShell para gerenciar certificados expirados no Azure AD híbrido

por Team Ninja
How to Use PowerShell to Manage Expired Certificates in Hybrid Azure AD blog banner image

Resumo instantâneo

Esta postagem do blog NinjaOne oferece uma lista abrangente de comandos CMD básicos e um mergulho profundo nos comandos do Windows, com +70 comandos CMD essenciais para usuários iniciantes e avançados. Explicamos sobre comandos práticos de prompt de comando para gerenciamento de arquivos, navegação em diretórios, solução de problemas de rede, operações de disco e automação, tudo com exemplos reais para maximizar a produtividade. Seja para aprender comandos básicos CMD ou dominar ferramentas avançadas de CLI do Windows, este guia ajuda você a usar o prompt de comando com mais eficiência.

O gerenciamento de certificados de segurança com PowerShell é uma ferramenta indispensável em qualquer ambiente corporativo que use o Azure AD híbrido. Esses certificados controlam o registro de dispositivos e a sincronização de dados.

Por isso, certificados expirados podem causar vários problemas: quebrar a sincronização de dispositivos, provocar falhas de autenticação, deixar cargas de trabalho híbridas inacessíveis ou rejeitar e atrasar a emissão de tokens.

Quer saber mais sobre o assunto? Assista ao nosso vídeo: Como usar o PowerShell para gerenciar certificados expirados no Azure AD híbrido.

Recursos disponíveis para gerenciar certificados expirados no Azure AD

Há várias formas de gerenciar certificados expirados no Azure AD. Você pode visualizar os certificados de todos os dispositivos gerenciados, renovar certificados do Azure AD Connect ou do AD FS e remover certificados expirados.

Também dá para usar o Registro do Windows para validar dependências de certificados, GPOs para gerenciar a inscrição automática de certificados em todos os dispositivos gerenciados ou o CMD para solucionar problemas de certificado e sincronização.

📌 Pré-requisitos:

  • Acesso ao servidor onde o Azure AD ou o AD FS está instalado.
  • Privilégios de administrador no servidor local e no servidor do Azure AD.
  • Os seguintes módulos instalados no Windows PowerShell:
    • AzureAD
    • MSOnline
    • AD FS
    • Hybrid Agent
  • Acesso ao snap-in Certificados do MMC e ao PowerShell.
  • Recomenda-se ter uma raiz confiável e autenticação de certificado corporativa caso você emita os certificados manualmente.

📌 Estratégias de implantação recomendadas:

Clique para escolher um método

💻

Melhor para usuários individuais

💻💻💻

Melhor para empresas

Identificar certificados expirados pelo PowerShell✓
Renovar certificados do Azure AD Connect✓
Renovar certificados do AD FS (se usado)✓
Remover certificados expirados✓
Usar o Registro para validar ou rastrear dependências de certificados✓
Usar a Política de Grupo para gerenciar a inscrição automática de certificados✓
Usar o CMD para solucionar problemas de certificado e sincronização✓

Identificar certificados expirados pelo PowerShell

Esse método serve para os serviços do AD FS e do Azure AD Connect. Ele lista todos os certificados do computador local e suas datas de expiração.

  1. Abra o menu Iniciar e pesquise por Windows PowerShell.
  2. Clique com o botão direito em Windows PowerShell > Executar como administrador.
  3. Digite o seguinte e pressione Enter:
Get-ChildItem -Path Cert:\LocalMachine\My | Where-Object {
$_.NotAfter -lt (Get-Date)
} | Select Subject, Thumbprint, NotAfter
Listar certificados de aplicativos do Azure AD:
Connect-AzureAD
Get-AzureADApplication | ForEach-Object {
Get-AzureADApplicationKeyCredential -ObjectId $_.ObjectId | Where-Object {
$_.EndDate -lt (Get-Date)
}
}
Verificar credenciais da entidade de serviço:
Get-AzureADServicePrincipal | ForEach-Object {
Get-AzureADServicePrincipalKeyCredential -ObjectId $_.ObjectId | Where-Object {
$_.EndDate -lt (Get-Date)
}
}

Renovar certificados do Azure AD Connect

  1. Faça login no servidor do Azure AD da sua organização.
  2. Abra o menu Iniciar e pesquise por Windows PowerShell.
  3. Clique com o botão direito em Windows PowerShell > Executar como administrador.
  4. Digite Start-ADSyncSyncCycle -PolicyType Initial e pressione Enter. Isso dispara uma sincronização completa (inicial), ou seja, o sistema lê e reaplica todas as regras de sincronização e todos os dados.

Agora é possível renovar os certificados dos dispositivos gerenciados.

Se você usa a interface gráfica do Azure AD:

  1. Abra o Azure AD Connect.
  2. Clique em Configurar > Gerenciar certificados.
  3. Selecione Renovar certificados.
  4. Siga as instruções na tela e verifique a sincronização.

Se você usa o Windows PowerShell:

  1. Abra o menu Iniciar e pesquise por Windows PowerShell.
  2. Clique com o botão direito em Windows PowerShell > Executar como administrador.
  3. Digite este comando e pressione Enter:
$cert = Get-ChildItem -Path Cert:\LocalMachine\My | Where-Object { $_.Subject -like
"*yourdomain.com*" -and $_.NotAfter -gt (Get-Date) }
Set-ADSyncCertificate -Thumbprint $cert.Thumbprint

Troque “yourdomain.com” pelo seu domínio.

💡 Observação: dependendo da sua configuração, talvez seja preciso escrever um script personalizado. Como alternativa, dá para renovar os certificados pela interface gráfica do Azure AD.

Renovar certificados do AD FS (se usado)

  1. Abra o menu Iniciar e pesquise por Windows PowerShell.
  2. Clique com o botão direito em Windows PowerShell > Executar como administrador.
  3. Para exportar e vincular um novo certificado, digite o seguinte e pressione Enter:
Set-AdfsSslCertificate -Thumbprint 'NEW_CERT_THUMBPRINT'
Set-AdfsCertificate -CertificateType Service-Communications -Thumbprint
'NEW_CERT_THUMBPRINT'
Atualizar os certificados de assinatura e descriptografia de token:
Update-AdfsCertificate -CertificateType Token-Signing
Update-AdfsCertificate -CertificateType Token-Decrypting
  1. Force o recarregamento da configuração digitando Restart-Service adfssrv e pressionando Enter.
  2. Para confirmar que os certificados foram renovados, digite os comandos a seguir:

Get-AdfsSslCertificate
Get-AdfsCertificate

Remover certificados expirados

  1. Abra o menu Iniciar e pesquise por Windows PowerShell.
  2. Clique com o botão direito em Windows PowerShell > Executar como administrador.
  3. Para remover os certificados expirados do computador local, digite este comando e pressione Enter:
Get-ChildItem -Path Cert:\LocalMachine\My | Where-Object {
$_.NotAfter -lt (Get-Date)
} | Remove-Item

Para remover os certificados expirados do aplicativo do Azure AD, digite o seguinte e pressione Enter:

$expiredCerts = Get-AzureADApplicationKeyCredential -ObjectId $app.ObjectId |
Where-Object { $_.EndDate -lt (Get-Date) }
foreach ($cert in $expiredCerts) {
Remove-AzureADApplicationKeyCredential -ObjectId $app.ObjectId -KeyId $cert.KeyId
}

Usar o Registro para validar ou rastrear dependências de certificados

O Registro do Windows permite relacionar certificados a serviços específicos e acompanhar quais precisam de renovação.

  1. Abra o menu Iniciar e pesquise por Editor do Registro para abrir o programa.
  2. Vá até o endereço dos serviços que quer verificar. Por exemplo, para validar se o certificado do rastreamento AD FS/híbrido está vinculado corretamente, acesse este endereço:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\ADFS\Parameters

  1. A string CertificateHash deve conter o valor “THUMBPRINT“.
  2. Ou, para verificar o mapeamento de certificado da conta de serviço do Azure AD Connect, acesse HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ADSync.
  3. A string CertificateHash deve conter o valor “THUMBPRINT“.

Esses são exemplos. O caminho e a string variam conforme o seu cenário.

Usar a Política de Grupo para gerenciar a inscrição automática de certificados

Use este método para enviar certificados renovados automaticamente a dispositivos e servidores híbridos.

  1. Abra o menu Iniciar e pesquise por Editar Política de Grupo para abrir o programa.
  2. Acesse Configuração do Computador > Configurações do Windows > Configurações de Segurança > Políticas de Chave Pública.
  3. Dê um duplo clique em Cliente dos Serviços de Certificados – Política de Registro de Certificados.
  4. Defina como Ativado.
  5. Localize os certificados expirados e renove-os.
  6. Atualize os certificados que usam o modelo de certificados.
  7. Clique em OK > Aplicar.

Usar o CMD para solucionar problemas de certificado e sincronização

Esses comandos ajudam na solução de problemas de certificados ou após mudanças de configuração.

  1. Abra o menu Iniciar e pesquise por Prompt de Comando.
  2. Clique com o botão direito em Prompt de Comando > Executar como administrador.
  3. Para verificar a integridade da sincronização do Azure AD Connect, digite sc query ADSync e pressione Enter.
  4. Para ver os certificados instalados, digite certutil -store my e pressione Enter.
  5. Para forçar uma atualização de GPO e a renovação da política de certificados, digite o seguinte e pressione Enter:

gpupdate /force
certutil -pulse

⚠️ Solução de problemas e pontos de atenção

Problema/riscoPossíveis consequênciasCorreção/reversão
A sincronização falha após a renovação.O certificado não será atualizado.Reinicie o serviço de sincronização pelo Windows PowerShell e verifique a configuração do conector.
Ocorrem erros de login no Azure.Não será possível fazer login.Confirme pelo Registro do Windows que os certificados estão vinculados corretamente.
Uma mensagem informa que os dados de federação estão incorretos ou incompletos.Não será possível acessar serviços em diferentes plataformas com as credenciais existentes.Confirme no Windows PowerShell que os certificados do AD FS estão configurados corretamente com Set-AdfsSslCertificate.
Aparece o erro “Permission Denied”.Não será possível executar suas tarefas.Verifique se a conta usada para gerenciar chaves e serviços é a correta.

Outros pontos a considerar ao gerenciar certificados expirados no Azure AD híbrido

  • Antes de implementar novos certificados, confirme sempre que eles são confiáveis para o Azure AD e para todos os servidores locais.
  • Programe alertas no Windows PowerShell ou no NinjaOne para avisar quando os certificados estiverem perto de expirar.
  • MSPs que atendem vários tenants devem garantir que todos os servidores híbridos estejam registrados no aplicativo cliente correto.
  • Exporte e guarde os certificados em local seguro antes de substituí-los ou excluí-los.

Serviços NinjaOne

NinjaOne ajuda os administradores de TI a fortalecer o gerenciamento de certificados híbridos com:

  • Scripts automatizados – scripts PowerShell podem ser implantados para localizar certificados expirados e renová-los automaticamente.
  • Alertas e monitoramento – os administradores podem configurar um alerta que avisa quando os certificados estão perto de expirar.
  • Validação de chaves do Registro – é possível extrair dados do Registro para acompanhar o status de vinculação de certificados dos agentes híbridos.
  • Verificação de serviços – os administradores podem gerar relatórios sobre a integridade dos serviços do AD FS ou do Azure AD Connect e direcioná-los a problemas de certificados.
  • Painel centralizado – monitore os certificados de identidade híbrida em todos os ambientes de clientes.

Gerencie os certificados do computador local no Azure AD híbrido

Gerenciar bem os certificados em um ambiente de Azure AD híbrido e mantê-los sempre atualizados é fundamental. Assim, a autenticação, a sincronização de diretórios e a comunicação segura entre aplicativos seguem sem interrupções.

Temas relacionados:

Recomendados para você

Pronto para simplificar as partes mais difíceis da TI?