Start-AIPScannerDiagnostics

與下列專案相關: 僅限統一標籤用戶端

啟動本機安裝的 AIP 掃描器服務的一系列健康情況檢查。

Syntax

Start-AIPScannerDiagnostics
     [-OnBehalfOf <PSCredential>]
     [-ResetConfig]
     [-VerboseErrorCount <integer>]
     [<CommonParameters>]

Description

Start-AIPScannerDiagnostics Cmdlet 會觸發一系列的診斷檢查,以確認掃描器部署狀況良好。

診斷檢查包括:

  • 資料庫是最新且可存取的
  • URL 可供存取
  • 找到驗證權杖,而且可以取得原則
  • 設定檔是在 Azure 入口網站 中設定
  • 離線/線上設定存在,而且可以取得
  • 規則有效

範例

範例 1:針對本機安裝的 AIP 掃描器啟動診斷工具

PS C:\> $scanner_account_creds= Get-Credential
PS C:\> Start-AIPScannerDiagnostics -onbehalf $scanner_account_creds

此範例會提示您輸入特定帳戶的認證,然後提供用來執行 AIP 掃描器服務之服務帳戶的認證。

範例 2:使用從掃描器記錄列印大量錯誤的診斷工具啟動診斷工具

PS C:\> $scanner_account_creds= Get-Credential
PS C:\> Start-AIPScannerDiagnostics -onbehalf $scanner_account_creds -Verbose -VerboseErrorCount 30

此範例會提示您輸入特定帳戶的認證,然後提供用來執行 AIP 掃描器服務之服務帳戶的認證。 最後 30 個錯誤會從掃描器記錄列印。

參數

-OnBehalfOf

定義您要在其中執行診斷的掃描器,當您在不是掃描器使用者的使用者下執行 命令時。

OnBehalfOf值會定義保存認證物件的變數。 診斷檢查會在 AIP 掃描器上針對該認證物件所定義的帳戶執行。

使用 Get-Credential Cmdlet 來取得儲存認證的變數。

注意

如果您在掃描器使用者下執行命令,則不需要此參數。

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResetConfig

重設原則快取。 使用時,即使上次重新整理髮生在四小時前,仍會重新整理原則。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VerboseErrorCount

只有在命令中使用 Verbose 參數時才相關。

如果您想要列印預設值為 10 以外的錯誤數,請定義您想要從掃描器記錄檔看到的錯誤數目。

Type:Integer
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸出

System.Object

備註

  • 此 Cmdlet 要求您在 -OnBehalfOf 參數中定義特定的掃描器帳戶。 OnBehalfOf 參數要求您以系統管理員身分執行 PowerShell 會話。

  • 診斷檢查會檢查掃描器部署必要條件。 只有在您已部署掃描器並 設定設定檔之後,才支援此 Cmdlet。

    如需詳細資訊,請參閱部署 Azure 資訊保護掃描器