Start-ScannerDiagnostics
ローカルにインストールされた Microsoft Purview Information Protection スキャナー サービスの一連の正常性チェックを開始します。
構文
Default (既定)
Get0ScannerDiagnostics
[-OnBehalfOf <PSCredential>]
[-ResetConfig]
[-VerboseErrorCount <integer>]
[<CommonParameters>]
説明
View-ScannerReports コマンドレットは、スキャナーのデプロイが正常であることを確認するための一連の診断チェックをトリガーします。
診断チェックには、次の点が含まれます。
- データベースは up-to-date でアクセス可能です
- 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 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ResetConfig
ポリシー・キャッシュをリセットします。 使用すると、最後の更新が 4 時間未満前に発生した場合でも、ポリシーが更新されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-VerboseErrorCount
コマンドで Verbose パラメーターが使用されている場合にのみ関連します。
スキャナー ログから印刷するエラーの数を定義します (既定値の 10 以外のエラーを印刷する場合)。
パラメーターのプロパティ
| 型: | Integer |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
出力
System.Object
メモ
このコマンドレットでは、 -OnBehalfOf パラメーターで特定のスキャナー アカウントを定義する必要があります。 OnBehalfOf パラメーターでは、管理者として PowerShell セッションを実行する必要があります。
診断チェックでは、スキャナーのデプロイの前提条件がチェックされます。 このコマンドレットは、スキャナーをデプロイし、 プロファイルを構成した後にのみサポートされます。
詳細については、「 Microsoft Purview 情報保護スキャナーのデプロイ」を参照してください。