다음을 통해 공유

Start-AIPScannerDiagnostics

  • 참조
모듈:
AzureInformationProtection

관련 대상: 통합 레이블 지정 클라이언트만

로컬에 설치된 AIP 스캐너 서비스에 대한 일련의 상태 검사를 시작합니다.

구문

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

Description

Start-AIPScannerDiagnostics cmdlet은 스캐너 배포가 정상인지 확인하기 위해 일련의 진단 검사를 트리거합니다.

진단 검사에는 다음이 포함되는지 여부가 포함되었습니다.

  • 데이터베이스는 최신 상태이며 액세스할 수 있습니다.
  • 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 cmdlet을 사용하여 자격 증명을 저장하는 변수를 가져옵니다.

참고

스캐너 사용자 아래에서 명령을 실행하는 경우 이 매개 변수가 필요하지 않습니다.

형식:PSCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ResetConfig

정책 캐시를 다시 설정합니다. 사용하는 경우 마지막 새로 고침이 4시간 전에 발생한 경우에도 정책이 새로 고쳐집니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-VerboseErrorCount

명령에서 Verbose 매개 변수를 사용하는 경우에만 관련됩니다.

기본값인 10이 아닌 여러 오류를 인쇄하려는 경우 스캐너 로그에서 인쇄할 오류 수를 정의합니다.

형식:Integer
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

출력

System.Object

참고

  • 이 cmdlet을 사용하려면 -OnBehalfOf 매개 변수에서 특정 스캐너 계정을 정의해야 합니다. OnBehalfOf 매개 변수를 사용하려면 PowerShell 세션을 관리자 권한으로 실행해야 합니다.

  • 진단 검사는 스캐너 배포 필수 구성 요소를 확인합니다. 이 cmdlet은 스캐너를 배포하고 프로필을 구성한 후에만 지원됩니다.

    자세한 내용은 Azure Information Protection 스캐너 배포를 참조하세요.