Get-AIPScannerStatus

  • 參考
模組:
AzureInformationProtection

取得 Azure 資訊保護 掃描器的目前服務狀態。

Syntax

Get-AIPScannerStatus []

Description

Azure 資訊保護 傳統和統一卷標用戶端都支援此 Cmdlet，其使用方式不同，如下所示。

統一標籤用戶端

Get-AIPScannerStatus Cmdlet 會傳回有關目前掃描器叢集狀態的下列詳細數據：

  • 叢集名稱

  • 叢集狀態，包括：

    • 離線：服務未啟動
    • 閑置：服務正在執行，但目前未掃描
    • 掃描：服務正在執行，目前正在掃描檔案
    • 錯誤。 掃描器服務正在執行，但發生錯誤，導致無法掃描檔案。 例如，服務無法存取掃描儀組態的資料庫。

  • 掃描開始時間：上次掃描開始的時間，格式為UTC時間。

  • 從開始時間：掃描持續時間，格式如下： Days.HH:MM:SS

  • 節點資訊：掃描儀叢集中的節點清單

若要取得進一步的詳細數據，請使用下列其中一個或兩種方法：

  • 使用 NodesInfo 變數來檢視每個節點目前掃描狀態的詳細數據。 如需詳細資訊，請參閱下列範例。

  • 使用 Verbose 參數來檢視詳細數據，例如掃描的檔案數目、掃描的數據量，以及掃描的每個存放庫詳細數據。

    使用 Verbose 參數時，使用 RepositoriesStatus 或 CurrentScanSummary 變數進一步向下切入以尋找存放庫的詳細數據。

    可能的存放庫狀態包括：

    • 如果已略過存放庫，則略過
    • 擱置中，如果目前的掃描尚未開始掃描存放庫
    • 掃描，如果目前的掃描正在存放庫上執行
    • 已完成，如果目前的掃描已完成在存放庫上執行

如需詳細資訊，請參閱 驗證每個掃描器節點和存放庫的掃描詳細數據。

範例

範例 1：取得掃描儀服務的目前狀態， (統一卷標用戶端) 

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}

此輸出顯示掃描目前正在叢集上 contoso-test 執行，且已在 37 秒前於上午 03/10 上午 9：05：02 開始。

輸出也會顯示 contoso-test 叢集有3個節點。

範例 2：使用 Verbose 參數取得目前掃描的數據 (統一卷標用戶端) 

PS C:\> Get-AIPScannerStatus -Verbose

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

此輸出只會顯示單一存放庫。 在多個存放庫的情況下，每個存放庫都會個別列出。

範例 3：使用 NodesInfo 變數來取得每個節點上掃描狀態的詳細數據， (統一卷標用戶端) 

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
....

此輸出會先顯示目前掃描狀態的詳細數據，以及叢集中的節點清單，以及數據表中每個節點的詳細數據。

使用節點整數的進一步向下鑽研會顯示所選節點上掃描的詳細數據長清單，例如掃描、分類和標記的檔案數目，以及掃描的位元組數目。

使用 NodesInfo 變數向下切入節點詳細數據時，節點整數的開頭為 0。

範例 4：使用 Verbose 參數和 RepositoriesStatus 變數 (統一卷標用戶端) 

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

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

輸出會顯示針對內容掃描作業所設定之每個存放庫的掃描狀態。

範例 5：使用 Verbose 參數和 CurrentScanSummary 變數

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


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

輸出會顯示目前執行之掃描的進一步詳細數據，包括掃描數目、失敗、分類和標記的檔案，以及掃描的位元組數目。

輸入

None

輸出

System.Object