Start-AIPScannerDiagnostics
関連: 統合ラベル付けクライアントのみ
ローカルにインストールされた AIP スキャナー サービスの一連の正常性チェックを開始します。
構文
Start-AIPScannerDiagnostics
[-OnBehalfOf <PSCredential>]
[-ResetConfig]
[-VerboseErrorCount <integer>]
[<CommonParameters>]
説明
Start-AIPScannerDiagnostics コマンドレットは、スキャナーのデプロイが正常であることを確認するために一連の診断チェックをトリガーします。
診断チェックには、次の項目が含まれます。
- データベースは最新の状態でアクセス可能です
- URL にアクセスできます
- 認証トークンが見つかり、ポリシーを取得できます
- プロファイルは、Azure portalで設定されます
- オフライン/オンライン構成が存在し、取得可能
- ルールは有効です
例
例 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 コマンドレットを使用して、資格情報を格納する変数を取得します。
Note
スキャナー ユーザーの下でコマンドを実行している場合、このパラメーターは必要ありません。
型: | 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 セッションを実行する必要があります。
診断チェックでは、スキャナーのデプロイの前提条件がチェックされます。 このコマンドレットは、スキャナーをデプロイし、 プロファイルを構成した後にのみサポートされます。
詳細については、「Azure Information Protection スキャナーのデプロイ」を参照してください。