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

Get-AIPScannerStatus

  • 参考
模块:
AzureInformationProtection

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

语法

Get-AIPScannerStatus []

说明

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 秒前于 2021 年 3 月 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