Freigeben über

Start-ScannerDiagnostics

Modul:
PurviewInformationProtection Module

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

Syntax

Default (Standard) 

Get0ScannerDiagnostics
    [-OnBehalfOf <PSCredential>]
    [-ResetConfig]
    [-VerboseErrorCount <integer>]
    [<CommonParameters>]

Beschreibung

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

Zu den diagnostischen Überprüfungen gehört, ob:

  • Die Datenbank ist up-to-date und zugänglich
  • URLs sind barrierefrei
  • Ein Authentifizierungstoken wird gefunden, und die Richtlinie kann abgerufen werden
  • Das Profil ist festgelegt
  • Die Offline-/Online-Konfiguration ist vorhanden und kann erworben 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 wird.

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 wird. Die letzten 30 Fehler werden aus dem Scannerprotokoll gedruckt.

Parameter

-OnBehalfOf

Definiert den Scanner, auf 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 durch dieses Anmeldeinformationsobjekt definiert ist.

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

Hinweis

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

Parametereigenschaften

Typ:PSCredential
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ResetConfig

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VerboseErrorCount

Nur relevant, wenn der Parameter "Ausführlich" im Befehl verwendet wird.

Definiert die Anzahl der Fehler, die aus dem Scannerprotokoll gedruckt werden sollen, wenn Sie eine andere Anzahl von Fehlern als die Standardanzahl von 10 drucken möchten.

Parametereigenschaften

Typ:Integer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Ausgaben

System.Object

Hinweise

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

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

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