Validar a integração de gráficos para o Azure Stack Hub

Artigo
03/12/2025

Utilize a ferramenta Verificador de Preparação do Azure Stack Hub (AzsReadinessChecker) para validar que o seu ambiente está pronto para integração de gráficos com o Azure Stack Hub. Valide a integração de gráficos antes de iniciar a integração do datacenter ou antes de uma implementação do Azure Stack Hub.

O verificador de preparação valida:

As credenciais para a conta de serviço criada para integração de gráficos têm direitos adequados para consultar o Active Directory.
O catálogo global pode ser resolvido e contactável.
O KDC pode ser resolvido e contactável.
A conectividade de rede necessária está implementada.

Para obter mais informações sobre a integração do datacenter do Azure Stack Hub, veja Integração do datacenter do Azure Stack Hub – Identidade.

Obter a ferramenta de verificação de preparação

Transfira a versão mais recente da ferramenta Verificador de Preparação do Azure Stack Hub (AzsReadinessChecker) a partir do Galeria do PowerShell.

Pré-requisitos

Os seguintes pré-requisitos têm de estar implementados.

O computador onde a ferramenta é executada:

Windows 10 ou Windows Server 2016 com conectividade de domínio.
PowerShell 5.1 ou posterior. Para verificar a sua versão, execute o seguinte comando do PowerShell e, em seguida, reveja a Versão principal e as versões Secundárias :
```
$PSVersionTable.PSVersion
```
Módulo do PowerShell do Active Directory.
Versão mais recente da ferramenta Verificador de Preparação do Microsoft Azure Stack Hub .

Ambiente do Active Directory:

Identifique o nome de utilizador e a palavra-passe de uma conta para o serviço de gráficos na instância existente do Active Directory.
Identifique o FQDN de raiz da floresta do Active Directory.

Validar o serviço de gráficos

Num computador que cumpra os pré-requisitos, abra uma linha de comandos administrativa do PowerShell e, em seguida, execute o seguinte comando para instalar o AzsReadinessChecker:
```
Install-Module Microsoft.AzureStack.ReadinessChecker -Force -AllowPrerelease
```
Na linha de comandos do PowerShell, execute o seguinte comando para definir a variável de $graphCredential para a conta de gráfico. Substitua contoso\graphservice pela sua conta com o domain\username formato .
```
$graphCredential = Get-Credential contoso\graphservice -Message "Enter Credentials for the Graph Service Account"
```
Na linha de comandos do PowerShell, execute o seguinte comando para iniciar a validação do serviço de gráficos. Especifique o valor para -ForestFQDN como FQDN para a raiz da floresta.
```
Invoke-AzsGraphValidation -ForestFQDN contoso.com -Credential $graphCredential
```

Após a execução da ferramenta, reveja o resultado. Confirme que o estado está OK para os requisitos de integração de gráficos. Uma validação bem-sucedida é semelhante ao seguinte exemplo:

Testing Graph Integration (v1.0)
        Test Forest Root:            OK
        Test Graph Credential:       OK
        Test Global Catalog:         OK
        Test KDC:                    OK
        Test LDAP Search:            OK
        Test Network Connectivity:   OK

Details:

[-] In standalone mode, some tests should not be considered fully indicative of connectivity or readiness the Azure Stack Hub Stamp requires prior to Datacenter Integration.

Additional help URL: https://aka.ms/AzsGraphIntegration

AzsReadinessChecker Log location (contains PII): C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessChecker.log

AzsReadinessChecker Report location (contains PII): C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessCheckerReport.json

Invoke-AzsGraphValidation Completed

Em ambientes de produção, testar a conectividade de rede a partir da estação de trabalho de um operador não é totalmente indicativo da conectividade disponível para o Azure Stack Hub. A rede VIP pública do selo do Azure Stack Hub precisa da conectividade do tráfego LDAP para efetuar a integração de identidade.

Relatório e ficheiro de registo

Sempre que a validação é executada, regista os resultados em AzsReadinessChecker.log e AzsReadinessCheckerReport.json. A localização destes ficheiros é apresentada com os resultados da validação no PowerShell.

Os ficheiros de validação podem ajudá-lo a partilhar o estado antes de implementar o Azure Stack Hub ou investigar problemas de validação. Ambos os ficheiros mantêm os resultados de cada verificação de validação subsequente. O relatório dá à sua equipa de implementação a confirmação da configuração da identidade. O ficheiro de registo pode ajudar a sua equipa de implementação ou suporte a investigar problemas de validação.

Por predefinição, ambos os ficheiros são escritos em C:\Users\<username>\AppData\Local\Temp\AzsReadinessChecker\.

Utilize:

-OutputPath: o parâmetro path no final do comando run para especificar uma localização de relatório diferente.
-CleanReport: o parâmetro no final do comando de execução para limpar AzsReadinessCheckerReport.json das informações anteriores do relatório. Para obter mais informações, veja Relatório de validação do Azure Stack Hub.

Falhas de validação

Se uma verificação de validação falhar, serão apresentados detalhes sobre a falha na janela do PowerShell. A ferramenta também regista informações no AzsGraphIntegration.log.

Passos seguintes

Ver o relatório de preparação
Considerações gerais sobre a integração do Azure Stack Hub

Partilhar via