Start-AIPScannerDiagnostics

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

関連: 統合ラベル付けクライアントのみ

ローカルにインストールされた 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

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

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 セッションを実行する必要があります。

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

    詳細については、「Azure Information Protection スキャナーのデプロイ」を参照してください。