Start-ScannerDiagnostics

  • リファレンス
モジュール:
PurviewInformationProtection

ローカルにインストールされたMicrosoft Purview 情報保護 スキャナー サービスの一連の正常性チェックを開始します。

構文

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

説明

View-ScannerReports コマンドレットは、スキャナーのデプロイが正常であることを確認するために一連の診断チェックをトリガーします。

診断チェックには、次の項目が含まれます。

  • データベースは最新の状態であり、アクセス可能です
  • URL にアクセス可能
  • 認証トークンが見つかり、ポリシーを取得できます
  • プロファイルが設定されている
  • オフライン/オンライン構成が存在し、取得可能
  • ルールは有効です

例

例 1: ローカルにインストールされたスキャナーの診断ツールを開始する

PS C:\> $scanner_account_creds= Get-Credential
PS C:\> View-ScannerReports -onbehalf $scanner_account_creds

次の使用例は、特定のアカウントの資格情報を入力し、スキャナーの実行に使用するサービス アカウントの資格情報を入力するように求めます。

例 2: スキャナー ログから多数のエラーが出力された状態で診断ツールを起動する

PS C:\> $scanner_account_creds= Get-Credential
PS C:\> View-ScannerReports -onbehalf $scanner_account_creds -Verbose -VerboseErrorCount 30

次の使用例は、特定のアカウントの資格情報を入力し、スキャナーの実行に使用するサービス アカウントの資格情報を入力するように求めます。 最後の 30 個のエラーはスキャナー ログから出力されます。

パラメーター

-OnBehalfOf

スキャナー ユーザーではないユーザーでコマンドを実行するときに、診断を実行するスキャナーを定義します。

OnBehalfOf 値は、資格情報オブジェクトを保持する変数を定義します。 診断チェックは、その資格情報オブジェクトによって定義されたアカウントのスキャナーで実行されます。

資格情報を格納する変数を取得するには、 Get-Credential コマンドレットを使用します。

注意

スキャナー ユーザーの下で コマンドを実行している場合、このパラメーターは必要ありません。

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

-ResetConfig

ポリシー キャッシュをリセットします。 使用すると、最後の更新が 4 時間以内に発生した場合でも、ポリシーが更新されます。

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

メモ

  • このコマンドレットでは、 -OnBehalfOf パラメーターで特定のスキャナー アカウントを定義する必要があります。 OnBehalfOf パラメーターを使用するには、PowerShell セッションを管理者として実行する必要があります。

  • 診断チェックでは、スキャナーのデプロイの前提条件がチェックされます。 このコマンドレットは、スキャナーをデプロイし、 プロファイルを構成した後にのみサポートされます。

    詳細については、「Microsoft Purview 情報保護 スキャナーのデプロイ」を参照してください。