Condividi tramite


Start-ScannerDiagnostics

Avvia una serie di controlli di integrità per un servizio scanner Microsoft Purview Information Protection installato in locale.

Sintassi

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

Descrizione

Il cmdlet View-ScannerReports attiva una serie di controlli di diagnostica per verificare che la distribuzione dello scanner sia integra.

I controlli di diagnostica includono se:

  • Il database è aggiornato e accessibile
  • Gli URL sono accessibili
  • Viene trovato un token di autenticazione e i criteri possono essere acquisiti
  • Il profilo è impostato
  • La configurazione offline/online esiste e può essere acquisita
  • Le regole sono valide

Esempio

Esempio 1: Avvia lo strumento di diagnostica per uno scanner installato in locale

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

In questo esempio viene richiesto di immettere le credenziali per un account specifico e quindi specificare le credenziali dell'account del servizio usato per eseguire lo scanner.

Esempio 2: Avvia lo strumento di diagnostica con un numero elevato di errori stampati dal log dello scanner

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

In questo esempio viene richiesto di immettere le credenziali per un account specifico e quindi specificare le credenziali dell'account del servizio usato per eseguire lo scanner. Gli ultimi 30 errori vengono stampati dal log dello scanner.

Parametri

-OnBehalfOf

Definisce lo scanner in cui si vuole eseguire la diagnostica, quando si esegue il comando in un utente che non è l'utente dello scanner.

Il valore OnBehalfOf definisce la variabile che contiene un oggetto credenziali. I controlli di diagnostica vengono eseguiti nello scanner per l'account definito dall'oggetto credenziali.

Usare il cmdlet Get-Credential per ottenere la variabile che archivia le credenziali.

Nota

Se si esegue il comando sotto l'utente dello scanner, questo parametro non è obbligatorio.

Tipo:PSCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ResetConfig

Reimposta la cache dei criteri. Se usato, il criterio viene aggiornato anche se l'ultimo aggiornamento si è verificato meno di quattro ore fa.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VerboseErrorCount

Pertinente solo quando il parametro Verbose viene usato nel comando.

Definisce il numero di errori che si desidera visualizzare nel log dello scanner, se si desidera stampare un numero di errori diversi dall'impostazione predefinita di 10.

Tipo:Integer
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Output

System.Object

Note

  • Questo cmdlet richiede di definire un account dello scanner specifico nel parametro -OnBehalfOf . Il parametro OnBehalfOf richiede di eseguire la sessione di PowerShell come amministratore.

  • I controlli di diagnostica controllano i prerequisiti per la distribuzione dello scanner. Questo cmdlet è supportato solo dopo aver distribuito lo scanner e il profilo configurato.

    Per altre informazioni, vedere Distribuzione dello scanner Microsoft Purview Information Protection.