Start-AIPScannerDiagnostics

Relevante para: Cliente de rotulagem unificado apenas

Inicia uma série de verificações de saúde para um serviço de scanner AIP instalado localmente.

Syntax

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

Description

O cmdlet start-AIPScannerDiagnostics ativa uma série de verificações de diagnóstico para verificar se a implementação do scanner é saudável.

Os controlos de diagnóstico incluem se:

  • A base de dados está atualizada e acessível
  • URLs são acessíveis
  • Um sinal de autenticação é encontrado e a apólice pode ser adquirida
  • O perfil está 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 scanner AIP instalado localmente

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

Este exemplo leva-o a introduzir credenciais para uma conta específica e, em seguida, fornecer as credenciais da conta de serviço utilizada para executar o serviço de scanner AIP.

Exemplo 2: Inicia a ferramenta de diagnóstico com um grande número de erros impressos a partir do registo do scanner

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

Este exemplo leva-o a introduzir credenciais para uma conta específica e, em seguida, fornecer as credenciais da conta de serviço utilizada para executar o serviço de scanner AIP. Os últimos 30 erros são impressos a partir do registo do scanner.

Parâmetros

-OnBehalfOf

Define o scanner onde pretende executar os diagnósticos, quando está a executar o comando sob um utilizador que não é o utilizador do scanner.

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

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

Nota

Se estiver a executar o comando sob o utilizador do scanner, este parâmetro não é necessário.

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

-ResetConfig

Repõe a cache da política. Quando utilizada, a política é renovada mesmo que a última atualização tenha ocorrido há menos de quatro horas.

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

-VerboseErrorCount

Relevante apenas quando o parâmetro Verbose é utilizado no comando.

Define o número de erros que pretende ver impressos no registo do scanner, se pretender imprimir uma série de erros que não o 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

Notas

  • Este cmdlet requer que você defina uma conta de scanner específica no parâmetro -OnBehalfOf . O parâmetro OnBehalfOf requer que execute a sua sessão PowerShell como Administrador.

  • As verificações de diagnóstico verificam os pré-requisitos de implantação do scanner. Este cmdlet só é suportado depois de ter o scanner implantado e o seu perfil configurado.

    Para mais informações, consulte a implementação do scanner Azure Information Protection.