Udostępnij za pośrednictwem

Get-ScanStatus

  • Odwołanie
Moduł:
PurviewInformationProtection

Pobiera bieżący stan usługi dla skanera Microsoft Purview Information Protection.

Składnia

Get-ScanStatus []

Opis

Polecenie cmdlet Get-ScanStatus zwraca następujące szczegóły dotyczące bieżącego stanu klastra skanera:

  • Nazwa klastra

  • Stan klastra, w tym:

    • Offline: usługa nie została uruchomiona
    • Bezczynność: usługa jest uruchomiona, ale obecnie nie jest skanowana
    • Skanowanie: usługa jest uruchomiona i obecnie skanuje pliki
    • Błąd. Usługa skanera jest uruchomiona, ale napotkała błąd uniemożliwiający skanowanie plików. Na przykład usługa nie może uzyskać dostępu do bazy danych dla konfiguracji skanera.

  • Godzina rozpoczęcia skanowania: czas rozpoczęcia ostatniego skanowania w formacie czasu UTC.

  • Godzina od początku: czas trwania skanowania w następującym formacie: Days.HH:MM:SS

  • Informacje o węźle: lista węzłów w klastrze skanera

Aby uzyskać dalsze szczegóły, użyj jednej lub obu następujących metod:

  • Użyj zmiennej NodesInfo , aby wyświetlić szczegółowe informacje o bieżącym stanie skanowania dla każdego węzła. Aby uzyskać więcej informacji, zobacz przykłady.

  • Użyj parametru Verbose , aby wyświetlić szczegóły, takie jak liczba skanowanych plików, ilość zeskanowanych danych i szczegóły dla każdego zeskanowanego repozytorium.

    W przypadku korzystania z parametru Verbose przejdź do szczegółów, aby uzyskać więcej szczegółów dotyczących repozytoriów przy użyciu zmiennych RepositoriesStatus lub CurrentScanSummary .

    Możliwe stany repozytorium obejmują:

    • Pominięto, jeśli repozytorium zostało pominięte
    • Oczekujące, jeśli bieżące skanowanie nie zostało rozpoczęte, skanowanie repozytorium
    • Skanowanie, jeśli bieżące skanowanie jest uruchomione w repozytorium
    • Zakończono, jeśli bieżące skanowanie zakończyło działanie w repozytorium

Aby uzyskać więcej informacji, zobacz Weryfikowanie szczegółów skanowania dla węzła i repozytorium skanera.

Przykłady

Przykład 1. Pobieranie bieżącego stanu usługi skanera

PS C:\> Get-ScanStatus
Cluster        : contoso-test
ClusterStatus  : Scanning
StartTime      : 03/10/2021 9:05:02 AM
TimeFromStart  : 00:00:00:37
NodesInfo      : {t-contoso1-T298-corp.contoso.com,t-contoso2-T298-corp.contoso.com,t-contoso3-T298-corp.contoso.com}

Te dane wyjściowe pokazują, że skanowanie jest obecnie uruchomione w contoso-test klastrze i zostało uruchomione 37 sekund temu, 10 marca 2021 r. o godzinie 9:05:02.

Dane wyjściowe pokazują również, że contoso-test klaster ma trzy węzły.

Przykład 2. Użyj parametru Verbose, aby pobrać dane dla bieżącego skanowania

PS C:\> Get-ScanStatus -Verbose

ScannedFiles    MBScanned    CurrentScanSummary                                         RepositoriesStatus
------------    ---------    ------------------                                         ------------------
        2280    78478187     Microsoft.InformationProtection.Scanner.ScanSummaryData    {​​​​​​{​​​​​​ Path = C:\temp, Status = Scanning }​​​​​​

Te dane wyjściowe zawierają tylko jedno repozytorium. W przypadku wielu repozytoriów każdy z nich jest wymieniony oddzielnie.

Przykład 3. Użyj zmiennej NodesInfo, aby uzyskać szczegółowe informacje o stanie skanowania w każdym węźle

PS C:\> Get-ScanStatus

Cluster        : contoso-test
ClusterStatus  : Scanning
StartTime      : 12/22/2020 9:05:02 AM
TimeFromStart  : 00:00:00:37
NodesInfo      : {t-contoso1-T298-corp.contoso.com,t-contoso2-T298-corp.contoso.com}

PS C:\WINDOWS\system32> $x=Get-ScanStatus
PS C:\WINDOWS\system32> $x.NodesInfo

NodeName                            Status    IsScanning    Summary
--------                            --------  ----------    -------
t-contoso1-T298-corp.contoso.com    Scanning        True    Microsoft.InformationProtection.Scanner.ScanSummaryData
t-contoso2-T298-corp.contoso.com    Scanning     Pending    Microsoft.InformationProtection.Scanner.ScanSummaryData

PS C:\Windows\system32> $x.NodesInfo[0].Summary


ScannerID               : t-contoso1-T298-corp.contoso.com
ScannedFiles            : 2280
FailedFiles             : 0
ScannedBytes            : 78478187
Classified              : 0
Labeled                 : 0
....

Te dane wyjściowe najpierw wyświetlają szczegółowe informacje o bieżącym stanie skanowania i liście węzłów w klastrze, a następnie szczegółowe informacje dotyczące każdego węzła w tabeli.

Dalsze przechodzenie do szczegółów przy użyciu liczby całkowitej węzła zawiera długą listę szczegółów dotyczących skanowania w wybranym węźle, takich jak liczba skanowanych, sklasyfikowanych i oznaczonych plików oraz liczba przeskanowanych bajtów.

W przypadku używania zmiennej NodesInfo do przechodzenia do szczegółów węzła liczba całkowita węzła zaczyna się od 0.

Przykład 4: użyj parametru Verbose i zmiennej RepositoriesStatus

PS C:\Windows\system32> $x=Get-ScanStatus - Verbose
PS C:\Windows\system32> $x.RepositoriesStatus

Path        Status
----        ------
C:\temp     Scanning

Dane wyjściowe pokazują stan skanowania dla każdego repozytorium skonfigurowanego dla zadania skanowania zawartości.

Przykład 5. Użyj parametru Verbose i zmiennej CurrentScanSummary

PS C:\Windows\system32> $x.CurrentScanSummary


ScannerID               : 
ScannedFiles            : 2280
FailedFiles             : 0
ScannedBytes            : 78478187
Classified              : 0
Labeled                 : 0
....

Dane wyjściowe zawierają dodatkowe szczegóły dotyczące aktualnie uruchomionego skanowania, w tym liczbę skanowanych, zakończonych niepowodzeniem, sklasyfikowanych i oznaczonych etykietami plików oraz liczbę skanowanych bajtów.

Dane wejściowe

None

Dane wyjściowe

System.Object