Start-ScannerDiagnostics
Starts a series of health checks for a locally installed Microsoft Purview Information Protection scanner service.
Sintaxis
Default (Es el valor predeterminado).
Get0ScannerDiagnostics
[-OnBehalfOf <PSCredential>]
[-ResetConfig]
[-VerboseErrorCount <integer>]
[<CommonParameters>]
Description
The View-ScannerReports cmdlet triggers a series of diagnostic checks to verify that the scanner deployment is healthy.
Diagnostic checks include whether:
- The database is up-to-date and accessible
- URLs are accessible
- An authentication token is found and the policy can be acquired
- The profile is set
- Offline/online configuration exists and can be acquired
- Rules are valid
Ejemplos
Example 1: Starts the diagnostic tool for a locally installed scanner
PS C:\> $scanner_account_creds= Get-Credential
PS C:\> View-ScannerReports -onbehalf $scanner_account_creds
This example prompts you to enter credentials for a specific account, and then provide the credentials of the service account used to run the scanner.
Example 2: Starts the diagnostic tool with a large number of errors printed from the scanner log
PS C:\> $scanner_account_creds= Get-Credential
PS C:\> View-ScannerReports -onbehalf $scanner_account_creds -Verbose -VerboseErrorCount 30
This example prompts you to enter credentials for a specific account, and then provide the credentials of the service account used to run the scanner. The last 30 errors are printed from the scanner log.
Parámetros
-OnBehalfOf
Defines the scanner where you want to run the diagnostics, when you are running the command under a user that is not the scanner user.
The OnBehalfOf value defines the variable that holds a credentials object. The diagnostics checks are run on the scanner for the account defined by that credentials object.
Use the Get-Credential cmdlet to get the variable that stores your credentials.
Note
If you are running the command under the scanner user, this parameter is not required.
Propiedades del parámetro
Tipo: | PSCredential |
Valor predeterminado: | None |
Admite caracteres comodín: | False |
DontShow: | False |
Conjuntos de parámetros
(All)
Posición: | Named |
Mandatory: | False |
Valor de la canalización: | False |
Valor de la canalización por nombre de propiedad: | False |
Valor de los argumentos restantes: | False |
-ResetConfig
Resets the policy cache. When used, the policy is refreshed even if the last refresh occurred less than four hours ago.
Propiedades del parámetro
Tipo: | SwitchParameter |
Valor predeterminado: | None |
Admite caracteres comodín: | False |
DontShow: | False |
Conjuntos de parámetros
(All)
Posición: | Named |
Mandatory: | False |
Valor de la canalización: | False |
Valor de la canalización por nombre de propiedad: | False |
Valor de los argumentos restantes: | False |
-VerboseErrorCount
Relevant only when the Verbose parameter is used in the command.
Defines the number of errors you want to see printed from the scanner log, if you want to print a number of errors other than the default of 10.
Propiedades del parámetro
Tipo: | Integer |
Valor predeterminado: | None |
Admite caracteres comodín: | False |
DontShow: | False |
Conjuntos de parámetros
(All)
Posición: | Named |
Mandatory: | False |
Valor de la canalización: | False |
Valor de la canalización por nombre de propiedad: | False |
Valor de los argumentos restantes: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Salidas
System.Object
Notas
This cmdlet requires you to define a specific scanner account in the -OnBehalfOf parameter. The OnBehalfOf parameter requires you to run your PowerShell session as an Administrator.
Diagnostic checks do check for scanner deployment prerequisites. This cmdlet is supported only after you have the scanner deployed and your profile configured.
For more information, see Deploying the Microsoft Purview Information Protection scanner.