Start-AIPScannerDiagnostics

  • Referencia
Módulo:
AzureInformationProtection

Relevante para: Solo cliente de etiquetado unificado

Inicia una serie de comprobaciones de estado para un servicio de escáner de AIP instalado localmente.

Syntax

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

Description

El cmdlet Start-AIPScannerDiagnostics desencadena una serie de comprobaciones de diagnóstico para comprobar que la implementación del analizador está en buen estado.

Las comprobaciones de diagnóstico incluyen si:

  • La base de datos está actualizada y accesible
  • Las direcciones URL son accesibles
  • Se encuentra un token de autenticación y se puede adquirir la directiva.
  • El perfil se establece en el Azure Portal
  • Existe una configuración sin conexión o en línea y se puede adquirir.
  • Las reglas son válidas

Ejemplos

Ejemplo 1: inicia la herramienta de diagnóstico para un analizador de AIP instalado localmente

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

En este ejemplo se le pide que escriba las credenciales de una cuenta específica y, a continuación, proporcione las credenciales de la cuenta de servicio que se usa para ejecutar el servicio de analizador de AIP.

Ejemplo 2: inicia la herramienta de diagnóstico con un gran número de errores impresos desde el registro del analizador

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

En este ejemplo se le pide que escriba las credenciales de una cuenta específica y, a continuación, proporcione las credenciales de la cuenta de servicio que se usa para ejecutar el servicio de analizador de AIP. Los últimos 30 errores se imprimen en el registro del analizador.

Parámetros

-OnBehalfOf

Define el analizador en el que desea ejecutar los diagnósticos, cuando se ejecuta el comando en un usuario que no es el usuario del analizador.

El valor OnBehalfOf define la variable que contiene un objeto credentials. Las comprobaciones de diagnóstico se ejecutan en el analizador de AIP para la cuenta definida por ese objeto de credenciales.

Use el cmdlet Get-Credential para obtener la variable que almacena las credenciales.

Nota

Si ejecuta el comando en el usuario del analizador, este parámetro no es necesario.

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

-ResetConfig

Restablece la memoria caché de directivas. Cuando se usa, la directiva se actualiza incluso si la última actualización se produjo hace menos de cuatro horas.

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

-VerboseErrorCount

Solo es relevante cuando se usa el parámetro Verbose en el comando .

Define el número de errores que desea ver impresos en el registro del analizador, si desea imprimir una serie de errores distintos del valor predeterminado de 10.

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

Salidas

System.Object

Notas

  • Este cmdlet requiere que defina una cuenta de escáner específica en el parámetro -OnBehalfOf . El parámetro OnBehalfOf requiere que ejecute la sesión de PowerShell como administrador.

  • Las comprobaciones de diagnóstico comprueban los requisitos previos de implementación del analizador. Este cmdlet solo se admite después de haber implementado el analizador y de configurar el perfil.

    Para más información, consulte Implementación del analizador de Azure Information Protection.