Compartir a través de

Start-ScannerDiagnostics

Módulo:
PurviewInformationProtection Module

Inicia una serie de comprobaciones de estado para un servicio de escáner de Microsoft Purview Information Protection instalado localmente.

Sintaxis

Default (valor predeterminado) 

Get0ScannerDiagnostics
    [-OnBehalfOf <PSCredential>]
    [-ResetConfig]
    [-VerboseErrorCount <integer>]
    [<CommonParameters>]

Description

El cmdlet View-ScannerReports desencadena una serie de comprobaciones de diagnóstico para comprobar que la implementación del escáner está en buen estado.

Las comprobaciones diagnósticas incluyen si:

  • La base de datos está up-tofecha y accesible
  • Las URL son accesibles
  • Se encuentra un token de autenticación y se puede adquirir la política
  • El perfil está establecido
  • La configuración fuera de línea/en línea existe y se puede adquirir
  • Las reglas son válidas

Ejemplos

Ejemplo 1: Inicia la herramienta de diagnóstico para un escáner instalado localmente

PS C:\> $scanner_account_creds= Get-Credential
PS C:\> View-ScannerReports -onbehalf $scanner_account_creds

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

Ejemplo 2: Inicia la herramienta de diagnóstico con un gran número de errores impresos en el registro del escáner

PS C:\> $scanner_account_creds= Get-Credential
PS C:\> View-ScannerReports -onbehalf $scanner_account_creds -Verbose -VerboseErrorCount 30

En este ejemplo, se le solicita que ingrese las credenciales de una cuenta específica y, a continuación, proporcione las credenciales de la cuenta de servicio utilizada para ejecutar el analizador. Los últimos 30 errores se imprimen desde el registro del escáner.

Parámetros

-OnBehalfOf

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

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

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

Nota:

Si está ejecutando el comando bajo el usuario del escáner, este parámetro no es necesario.

Propiedades de parámetro

Tipo:PSCredential
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ResetConfig

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-VerboseErrorCount

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

Define el número de errores que desea ver impresos desde el registro del escáner, si desea imprimir un número de errores distinto del valor predeterminado de 10.

Propiedades de parámetro

Tipo:Integer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

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 escáner. Este cmdlet solo se admite después de haber implementado el escáner y configurado el perfil.

    Para obtener más información, consulte Implementación del escáner de Microsoft Purview Information Protection.