Start-AIPScannerDiagnostics

  • Referenz
Modul:
AzureInformationProtection

Relevant für: Nur der Client für einheitliche Bezeichnungen

Startet eine Reihe von Integritätsprüfungen für einen lokal installierten AIP-Scannerdienst.

Syntax

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

Beschreibung

Das Cmdlet "Start-AIPScannerDiagnostics " löst eine Reihe von Diagnoseprüfungen aus, um zu überprüfen, ob die Scannerbereitstellung fehlerfrei ist.

Diagnoseüberprüfungen umfassen folgendes:

  • Die Datenbank ist aktuell und barrierefrei
  • URLs sind barrierefrei
  • Es wird ein Authentifizierungstoken gefunden, und die Richtlinie kann abgerufen werden.
  • Das Profil wird im Azure-Portal festgelegt.
  • Offline-/Onlinekonfiguration ist vorhanden und kann abgerufen werden
  • Regeln sind gültig

Beispiele

Beispiel 1: Startet das Diagnosetool für einen lokal installierten AIP-Scanner

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

In diesem Beispiel werden Sie aufgefordert, Anmeldeinformationen für ein bestimmtes Konto einzugeben, und geben Sie dann die Anmeldeinformationen des Dienstkontos an, das zum Ausführen des AIP-Scannerdiensts verwendet wird.

Beispiel 2: Startet das Diagnosetool mit einer großen Anzahl von Fehlern, die aus dem Scannerprotokoll gedruckt wurden

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

In diesem Beispiel werden Sie aufgefordert, Anmeldeinformationen für ein bestimmtes Konto einzugeben, und geben Sie dann die Anmeldeinformationen des Dienstkontos an, das zum Ausführen des AIP-Scannerdiensts verwendet wird. Die letzten 30 Fehler werden aus dem Scannerprotokoll gedruckt.

Parameter

-OnBehalfOf

Definiert den Scanner, an dem Sie die Diagnose ausführen möchten, wenn Sie den Befehl unter einem Benutzer ausführen, der nicht der Scannerbenutzer ist.

Der OnBehalfOf-Wert definiert die Variable, die ein Anmeldeinformationenobjekt enthält. Die Diagnoseüberprüfungen werden auf dem AIP-Scanner für das konto ausgeführt, das durch dieses Anmeldeinformationenobjekt definiert wird.

Verwenden Sie das Cmdlet Get-Credential , um die Variable abzurufen, die Ihre Anmeldeinformationen speichert.

Hinweis

Wenn Sie den Befehl unter dem Scannerbenutzer ausführen, ist dieser Parameter nicht erforderlich.

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

-ResetConfig

Setzt den Richtliniencache zurück. Bei Verwendung wird die Richtlinie aktualisiert, auch wenn die letzte Aktualisierung vor weniger als vier Stunden aufgetreten ist.

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

-VerboseErrorCount

Relevant nur, wenn der Verbose-Parameter im Befehl verwendet wird.

Definiert die Anzahl der Fehler, die aus dem Scannerprotokoll gedruckt werden sollen, wenn Sie eine Reihe anderer Fehler als der Standard von 10 drucken möchten.

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

Ausgaben

System.Object

Hinweise

  • Dieses Cmdlet erfordert, dass Sie ein bestimmtes Scannerkonto im Parameter "-OnBehalfOf" definieren. Der Parameter "OnBehalfOf" erfordert, dass Sie Ihre PowerShell-Sitzung als Administrator ausführen.

  • Diagnoseüberprüfungen überprüfen die Voraussetzungen für die Bereitstellung von Scannern. Dieses Cmdlet wird nur unterstützt, nachdem Sie den Scanner bereitgestellt und Ihr Profil konfiguriert haben.

    Weitere Informationen finden Sie unter Bereitstellen des Azure-Information Protection-Scanners.