通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Get-ScanStatus

  • 参考
模块:
PurviewInformationProtection

获取Microsoft Purview 信息保护扫描程序的服务的当前状态。

语法

Get-ScanStatus []

说明

Get-ScanStatus cmdlet 返回有关当前扫描程序群集状态的以下详细信息：

  • 群集名称

  • 群集状态，包括：

    • 脱机：服务未启动
    • 空闲：服务正在运行，但当前未扫描
    • 正在扫描：服务正在运行，当前正在扫描文件
    • 错误。 扫描程序服务正在运行，但遇到阻止扫描文件的错误。 例如，服务无法访问扫描程序配置的数据库。

  • 扫描开始时间：上次扫描开始的时间，采用 UTC 时间格式。

  • 开始时间：扫描持续时间，格式如下： Days.HH:MM:SS

  • 节点信息：扫描程序群集中的节点列表

若要获取更多详细信息，请使用以下一种或两种方法：

  • 使用 NodesInfo 变量可查看有关每个节点的当前扫描状态的详细信息。 有关详细信息，请参阅示例。

  • 使用 Verbose 参数可查看详细信息，例如扫描的文件数、扫描的数据量以及扫描的每个存储库的详细信息。

    使用 Verbose 参数时，请使用 RepositoriesStatus 或 CurrentScanSummary 变量进一步向下钻取以查找存储库的更多详细信息。

    可能的存储库状态包括：

    • “跳过”：如果存储库被跳过
    • 挂起，如果当前扫描未开始扫描存储库
    • “正在扫描”：如果当前扫描正在存储库上运行
    • 已完成（如果当前扫描已完成在存储库上运行）

有关详细信息，请参阅 验证每个扫描程序节点和存储库的扫描详细信息。

示例

示例 1：获取扫描程序服务的当前状态

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}

此输出显示扫描当前正在群集上运行 contoso-test ，扫描在 37 秒前开始，即 2021 年 3 月 10 日上午 9：05：02。

输出还显示 contoso-test 群集有三个节点。

示例 2：使用 Verbose 参数获取当前扫描的数据

PS C:\> Get-ScanStatus -Verbose

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

此输出仅显示单个存储库。 对于多个存储库，每个存储库单独列出。

示例 3：使用 NodesInfo 变量获取有关每个节点上的扫描状态的详细信息

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

此输出首先显示有关当前扫描状态的详细信息和群集中的节点列表，然后在表中显示每个节点的详细信息。

使用节点整数进一步向下钻取显示有关所选节点上扫描的详细信息的长列表，例如扫描、分类和标记的文件数，以及扫描的字节数。

使用 NodesInfo 变量向下钻取节点详细信息时，节点整数从 0 开始。

示例 4：使用 Verbose 参数和 RepositoriesStatus 变量

PS C:\Windows\system32> $x=Get-ScanStatus - 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