Get-AIPScannerStatus

  • Odwołanie
Moduł:
AzureInformationProtection

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

Składnia

Get-AIPScannerStatus []

Opis

To polecenie cmdlet jest obsługiwane zarówno przez klientów klasycznych, jak i ujednoliconych etykietowania platformy Azure Information Protection z różnymi zastosowaniami, jak opisano poniżej.

Klient ujednoliconego etykietowania

Polecenie cmdlet Get-AIPScannerStatus 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 poniższe 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 jeszcze rozpoczęte skanowanie repozytorium
    • Skanowanie, jeśli bieżące skanowanie jest uruchomione w repozytorium
    • Zakończono, jeśli bieżące skanowanie zostało ukończone 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 (ujednoliconego klienta etykietowania)

PS C:\> Get-AIPScannerStatus
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 o godzinie 10.03.2021 9:05:02.

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

Przykład 2: Użyj parametru Verbose, aby pobrać dane dla bieżącego skanowania (ujednolicony klient etykietowania)

PS C:\> Get-AIPScannerStatus -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żda z nich będzie wyświetlana oddzielnie.

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

PS C:\> Get-AIPScannerStatus

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-AIPScannerStatus
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 zawierają szczegółowe informacje o bieżącym stanie skanowania, a także listę węzłów w klastrze, a następnie szczegóły dla 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, a także liczba skanowanych 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 (ujednoliconego klienta etykietowania)

PS C:\Windows\system32> $x=Get-AIPScannerStatus -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, a także liczbę skanowanych bajtów.

Dane wejściowe

None

Dane wyjściowe

System.Object