Freigeben über


Start-ScannerDiagnostics

Startet eine Reihe von Integritätsprüfungen für einen lokal installierten Microsoft Purview Information Protection Scannerdienst.

Syntax

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

Beschreibung

Das Cmdlet View-ScannerReports löst eine Reihe von Diagnoseüberprüfungen aus, um zu überprüfen, ob die Scannerbereitstellung fehlerfrei ist.

Diagnoseüberprüfungen umfassen, ob:

  • Die Datenbank ist aktuell und zugänglich.
  • Auf URLs kann zugegriffen werden.
  • Es wird ein Authentifizierungstoken gefunden, und die Richtlinie kann abgerufen werden.
  • Das Profil ist festgelegt.
  • Offline-/Onlinekonfiguration vorhanden und kann abgerufen werden
  • Regeln sind gültig

Beispiele

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

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

In diesem Beispiel werden Sie aufgefordert, Anmeldeinformationen für ein bestimmtes Konto einzugeben und dann die Anmeldeinformationen des Dienstkontos anzugeben, das zum Ausführen des Scanners verwendet wurde.

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

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

In diesem Beispiel werden Sie aufgefordert, Anmeldeinformationen für ein bestimmtes Konto einzugeben und dann die Anmeldeinformationen des Dienstkontos anzugeben, das zum Ausführen des Scanners verwendet wurde. Die letzten 30 Fehler werden aus dem Scannerprotokoll ausgegeben.

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 Anmeldeinformationsobjekt enthält. Die Diagnose Überprüfungen werden auf dem Scanner für das Konto ausgeführt, das von diesem Anmeldeinformationsobjekt definiert wird.

Verwenden Sie das Cmdlet Get-Credential , um die Variable abzurufen, in der Ihre Anmeldeinformationen gespeichert werden.

Hinweis

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

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResetConfig

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VerboseErrorCount

Nur relevant, wenn der Verbose-Parameter im Befehl verwendet wird.

Definiert die Anzahl der Fehler, die aus dem Scannerprotokoll gedruckt werden sollen, wenn Sie eine Reihe von Fehlern drucken möchten, die nicht den Standardwert 10 aufweisen.

Typ:Integer
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Ausgaben

System.Object

Hinweise

  • Für dieses Cmdlet müssen Sie ein bestimmtes Scannerkonto im Parameter -OnBehalfOf definieren. Für den Parameter OnBehalfOf müssen Sie Ihre PowerShell-Sitzung als Administrator ausführen.

  • Diagnoseüberprüfungen überprüfen, ob die Voraussetzungen für die Scannerbereitstellung erfüllt sind. Dieses Cmdlet wird nur unterstützt, nachdem Sie den Scanner bereitgestellt und Ihr Profil konfiguriert haben.

    Weitere Informationen finden Sie unter Bereitstellen des Microsoft Purview Information Protection Scanners.