Start-AIPScannerDiagnostics

  • Riferimento
Modulo:
AzureInformationProtection

Rilevante per: Solo client di etichettatura unificata

Avvia una serie di controlli di integrità per un servizio scanner AIP installato localmente.

Sintassi

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

Descrizione

Il cmdlet Start-AIPScannerDiagnostics 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 viene impostato nel portale di Azure
  • La configurazione offline/online esiste e può essere acquisita
  • Le regole sono valide

Esempio

Esempio 1: avvia lo strumento di diagnostica per uno scanner AIP installato localmente

PS C:\> $scanner_account_creds= Get-Credential
PS C:\> Start-AIPScannerDiagnostics -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 il servizio scanner AIP.

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:\> Start-AIPScannerDiagnostics -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 il servizio scanner AIP. 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 credentials. I controlli di diagnostica vengono eseguiti nello scanner AIP per l'account definito da tale oggetto credenziali.

Usare il cmdlet Get-Credential per ottenere la variabile in cui sono archiviate le credenziali.

Nota

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

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-VerboseErrorCount

Rilevante solo quando il parametro Verbose viene usato nel comando .

Definisce il numero di errori che si desidera visualizzare stampati dal log dello scanner, se si desidera stampare un numero di errori diverso dal valore predefinito 10.

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

Output

System.Object

Note

  • Questo cmdlet richiede di definire un account dello scanner specifico nel parametro -OnBehalfOf . Il parametro OnBehalfOf richiede l'esecuzione della sessione di PowerShell come amministratore.

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

    Per altre informazioni, vedere Distribuzione dello scanner di Azure Information Protection.