Start-ScannerDiagnostics
ローカルにインストールされた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 コマンドレットを使用します。
注意
スキャナー ユーザーの下で コマンドを実行している場合、このパラメーターは必要ありません。
型: | PSCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ResetConfig
ポリシー キャッシュをリセットします。 使用すると、最後の更新が 4 時間以内に発生した場合でも、ポリシーが更新されます。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-VerboseErrorCount
Verbose パラメーターがコマンドで使用されている場合にのみ関連します。
既定の 10 以外のエラーを印刷する場合に、スキャナー ログから印刷されるエラーの数を定義します。
型: | Integer |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
出力
System.Object
メモ
このコマンドレットでは、 -OnBehalfOf パラメーターで特定のスキャナー アカウントを定義する必要があります。 OnBehalfOf パラメーターを使用するには、PowerShell セッションを管理者として実行する必要があります。
診断チェックでは、スキャナーのデプロイの前提条件がチェックされます。 このコマンドレットは、スキャナーをデプロイし、 プロファイルを構成した後にのみサポートされます。
詳細については、「Microsoft Purview 情報保護 スキャナーのデプロイ」を参照してください。