Start-AIPScannerDiagnostics

  • Referência
Módulo:
AzureInformationProtection

Relevante para: Somente cliente de rotulagem unificada

Inicia uma série de verificações de integridade para um serviço de verificador de AIP instalado localmente.

Syntax

Start-AIPScannerDiagnostics
     [-OnBehalfOf <PSCredential>]
     [-ResetConfig]
     [-VerboseErrorCount <integer>]
     [<CommonParameters>]

Description

O cmdlet Start-AIPScannerDiagnostics dispara uma série de verificações de diagnóstico para verificar se a implantação do verificador está íntegra.

As verificações de diagnóstico incluem se:

  • O banco de dados está atualizado e acessível
  • As URLs estão acessíveis
  • Um token de autenticação é encontrado e a política pode ser adquirida
  • O perfil é definido no portal do Azure
  • A configuração offline/online existe e pode ser adquirida
  • As regras são válidas

Exemplos

Exemplo 1: inicia a ferramenta de diagnóstico para um verificador de AIP instalado localmente

PS C:\> $scanner_account_creds= Get-Credential
PS C:\> Start-AIPScannerDiagnostics -onbehalf $scanner_account_creds

Este exemplo solicita que você insira credenciais para uma conta específica e forneça as credenciais da conta de serviço usada para executar o serviço de verificador de AIP.

Exemplo 2: inicia a ferramenta de diagnóstico com um grande número de erros impressos no log do verificador

PS C:\> $scanner_account_creds= Get-Credential
PS C:\> Start-AIPScannerDiagnostics -onbehalf $scanner_account_creds -Verbose -VerboseErrorCount 30

Este exemplo solicita que você insira credenciais para uma conta específica e forneça as credenciais da conta de serviço usada para executar o serviço de verificador de AIP. Os últimos 30 erros são impressos no log do verificador.

Parâmetros

-OnBehalfOf

Define o verificador no qual você deseja executar o diagnóstico, quando você está executando o comando em um usuário que não é o usuário do scanner.

O valor OnBehalfOf define a variável que contém um objeto de credenciais. As verificações de diagnóstico são executadas no verificador de AIP para a conta definida por esse objeto de credenciais.

Use o cmdlet Get-Credential para obter a variável que armazena suas credenciais.

Observação

Se você estiver executando o comando no usuário do verificador, esse parâmetro não será necessário.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResetConfig

Redefine o cache de política. Quando usada, a política é atualizada mesmo se a última atualização ocorreu há menos de quatro horas.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VerboseErrorCount

Relevante somente quando o parâmetro Detalhado é usado no comando.

Define o número de erros que você deseja ver impressos no log do verificador, se você quiser imprimir uma série de erros diferentes do padrão de 10.

Type:Integer
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Saídas

System.Object

Observações

  • Esse cmdlet exige que você defina uma conta de verificador específica no parâmetro -OnBehalfOf . O parâmetro OnBehalfOf exige que você execute sua sessão do PowerShell como administrador.

  • As verificações de diagnóstico verificam os pré-requisitos de implantação do verificador. Esse cmdlet só tem suporte depois que você tiver o scanner implantado e seu perfil configurado.

    Para obter mais informações, consulte Implantar o verificador de Proteção de Informações do Azure.