Udostępnij za pośrednictwem


Start-ScannerDiagnostics

Uruchamia serię kontroli kondycji dla lokalnie zainstalowanej usługi skanera Microsoft Purview Information Protection.

Składnia

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

Opis

Polecenie cmdlet View-ScannerReports wyzwala serię testów diagnostycznych w celu sprawdzenia, czy wdrożenie skanera jest w dobrej kondycji.

Testy diagnostyczne obejmują następujące elementy:

  • Baza danych jest aktualna i dostępna
  • Adresy URL są dostępne
  • Znaleziono token uwierzytelniania i można uzyskać zasady
  • Profil jest ustawiony
  • Konfiguracja offline/online istnieje i można uzyskać
  • Reguły są prawidłowe

Przykłady

Przykład 1. Uruchamia narzędzie diagnostyczne dla lokalnie zainstalowanego skanera

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

W tym przykładzie zostanie wyświetlony monit o wprowadzenie poświadczeń dla określonego konta, a następnie podanie poświadczeń konta usługi użytego do uruchomienia skanera.

Przykład 2. Uruchamia narzędzie diagnostyczne z dużą liczbą błędów wydrukowanych z dziennika skanera

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

W tym przykładzie zostanie wyświetlony monit o wprowadzenie poświadczeń dla określonego konta, a następnie podanie poświadczeń konta usługi użytego do uruchomienia skanera. Ostatnie 30 błędów jest drukowanych z dziennika skanera.

Parametry

-OnBehalfOf

Definiuje skaner, w którym chcesz uruchomić diagnostykę, podczas uruchamiania polecenia w obszarze użytkownika, który nie jest użytkownikiem skanera.

Wartość OnBehalfOf definiuje zmienną, która zawiera obiekt poświadczeń. Testy diagnostyczne są uruchamiane na skanerze dla konta zdefiniowanego przez ten obiekt poświadczeń.

Użyj polecenia cmdlet Get-Credential , aby uzyskać zmienną, która przechowuje poświadczenia.

Uwaga

Jeśli używasz polecenia w obszarze użytkownika skanera, ten parametr nie jest wymagany.

Typ:PSCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ResetConfig

Resetuje pamięć podręczną zasad. W przypadku użycia zasady są odświeżane, nawet jeśli ostatnie odświeżenie miało miejsce mniej niż cztery godziny temu.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-VerboseErrorCount

Istotne tylko wtedy, gdy parametr Verbose jest używany w poleceniu.

Definiuje liczbę błędów, które mają być wyświetlane w dzienniku skanera, jeśli chcesz wydrukować liczbę błędów innych niż wartość domyślna 10.

Typ:Integer
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wyjściowe

System.Object

Uwagi

  • To polecenie cmdlet wymaga zdefiniowania określonego konta skanera w parametrze -OnBehalfOf . Parametr OnBehalfOf wymaga uruchomienia sesji programu PowerShell jako administrator.

  • Testy diagnostyczne sprawdzają wymagania wstępne dotyczące wdrażania skanera. To polecenie cmdlet jest obsługiwane dopiero po wdrożeniu skanera i skonfigurowaniu profilu.

    Aby uzyskać więcej informacji, zobacz Wdrażanie skanera Microsoft Purview Information Protection.