Set-ScannerConfiguration
Microsoft Purview Information Protection 스캐너에 대한 선택적 구성을 설정합니다.
구문
Default (기본값)
Set-ScannerConfiguration
[-ReportLevel <ReportLevel>]
[-OnlineConfiguration <OnlineConfiguration>]
[-FeatureSettings <Hashtable>]
Description
Set-ScannerConfiguration cmdlet은 Microsoft Purview Information Protection 스캐너에 대한 로컬 구성 설정을 지정합니다.
Microsoft Purview 규정 준수 포털 대부분의 스캐너 구성 설정을 구성하지만 스캐너가 온라인 구성을 지원할 수 없기 때문에 파일에서 구성 설정을 가져와야 하거나 로컬에서 만든 보고서의 보고서 수준을 변경해야 하는 경우 이 cmdlet을 사용해야 합니다.
모든 변경 사항은 다음에 스캐너가 실행될 때 사용됩니다. 변경 내용을 즉시 적용해야 하는 경우 Windows 서버 컴퓨터에서 Microsoft Purview Information Protection 스캐너를 다시 시작합니다.
예제
예제 1: 온라인 구성을 사용하도록 Microsoft Purview Information Protection 스캐너 설정
PS C:\> Set-ScannerConfiguration -OnlineConfiguration On
Configuration was set successfully.
이 명령은 Microsoft Purview Information Protection 서비스에서 직접 구성을 가져오도록 스캐너를 설정합니다.
예시 2: 클러스터 레벨 스캐너 기능 활성화 (미리보기)
PS C:\> Set-ScannerConfiguration -FeatureSettings @{CustomReporting=$true}
Configuration was set successfully.
이 명령어는 스캐너 클러스터 전체에 대한 사용자 지정 보고 기능을 활성화합니다. 모든 노드는 다음 스캔 사이클에 변경 사항을 감지합니다. 서비스를 다시 시작할 필요가 없습니다.
하나의 해시테이블에서 여러 기능을 전달할 수 있습니다. cmdlet은 작성 전에 모든 기능 이름과 값을 검증합니다; 어떤 항목이든 유효하지 않으면 통화가 종료되며 설정이 적용되지 않습니다.
만약 어떤 기능이 Microsoft Purview 포털에서 관리된다면, 명령어가 경고와 함께 건너뛰고 클러스터 상태는 변하지 않습니다. 같은 통화 내의 다른 기능들은 여전히 적용됩니다.
이 클라이언트 버전에서 지원하는 배경 및 기능 목록은 스캐너 기능 제어 (미리보기)를 참조하세요.
매개 변수
-FeatureSettings
(공개 미리보기) 클러스터 수준의 Microsoft Purview Information Protection 스캐너 기능을 구성합니다. 이 설정은 다음 스캔 사이클에서 클러스터 내 모든 노드에 적용됩니다. 서비스를 다시 시작할 필요가 없습니다.
-FeatureSettings 기능명과 설정 쌍의 PowerShell 해시테이블을 수용합니다. 각 키는 특징 이름입니다(예: ); CustomReporting각 특징에 대한 지원 값은 스캐너 기능 제어(미리보기)에 문서화되어 있습니다.
예: Set-ScannerConfiguration -FeatureSettings @{CustomReporting=$true}.
기능 이름과 값 모두 변경 전에 검증됩니다. 어떤 항목이든 유효하지 않으면 cmdlet이 종료되고 해시테이블의 항목이 적용되지 않습니다.
Microsoft Purview 포털에서 기능이 설정된 경우, cmdlet은 경고를 발하고 해당 기능의 행은 변경하지 않습니다. 포털 관리가 아닌 다른 기능들은 여전히 적용됩니다.
배경, 지원되는 기능 및 예시는 스캐너 기능 제어 (미리보기)를 참조하세요.
Microsoft Purview 포털에서 기능이 설정된 경우, cmdlet은 경고를 발하고 해당 기능의 행은 변경하지 않습니다. 포털 관리가 아닌 다른 기능들은 여전히 적용됩니다.
배경 설명, 이 클라이언트 버전에서 지원하는 기능 목록 및 예시는 스캐너 기능 제어 (미리보기)를 참조하세요.
매개 변수 속성
| 형식: | Hashtable |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-OnlineConfiguration
스캐너가 Microsoft Purview Information Protection 서비스(기본값)에서 직접 구성 설정을 가져올지 아니면 오프라인 구성 파일을 사용할지를 지정합니다.
에: 기본 설정입니다. 스캐너는 Microsoft Purview Information Protection 서비스에서 직접 구성 설정을 가져옵니다.
끄기: 스캐너는 Microsoft Purview Information Protection 서비스에서 직접 구성 설정을 가져올 수 없습니다. 대신, 스캐너는 파일에서 가져오는 설정에 의해 구성됩니다.
스캐너가 온라인 구성을 지원할 수 없는 경우에도 Azure Portal에서 스캐너를 구성해야 합니다. 그런 다음 포털에서 .json 파일로 스캐너 구성을 내보내고 Import-ScannerConfiguration cmdlet을 사용하여 이 파일을 가져옵니다.
매개 변수 속성
| 형식: | OnlineConfiguration |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ReportLevel
스캐너 보고서에 대한 로깅 수준을 정의합니다. 기본적으로 스캐너에서 성공적으로 레이블이 지정되거나 중요한 정보 유형을 포함하는 파일만 로그 파일에 포함됩니다.
로그 파일은 %localappdata%\Microsoft\MSIP\Scanner\Reports 폴더에 저장됩니다. 요약 보고서 (.txt) 에는 검사하는 데 걸린 시간, 검사된 파일 수, 분류 및 보호된 파일 수에 대한 통계가 포함됩니다. 상세 보고서 (.csv) 에는 각 파일에 대한 세부 정보가 있습니다. 폴더에는 각 검사 주기에 대해 최대 60개의 보고서가 저장되며 필요한 디스크 공간을 최소화하기 위해 최신 보고서를 제외한 모든 보고서가 압축됩니다.
| 로그 수준 | 설명 |
|---|---|
| 디버그 | 검색된 모든 파일과 결과 작업을 기록합니다. 이 수준의 로깅은 문제 해결에 유용하지만 Microsoft Purview Information Protection 스캐너의 속도가 느려집니다. 이 범주에는 조건을 충족하지 않는 파일과 지원되지 않는 파일 형식으로 인해 건너뛴 파일이 포함됩니다.
예를 들어 파일 형식이 이 작업을 지원하지 않는 경우 분류 전용으로 파일에 레이블을 지정하고 자동으로 제외되는 파일에 레이블을 지정하려고 합니다. |
| 정보 (기본값) | 다음과 같은 파일만 기록합니다. - 스캐너에 의해 성공적으로 레이블이 지정되었습니다. - 스캐너가 검색 모드가 아닌 경우 스캐너에 의해 레이블이 지정되었을 것입니다. - 중요한 정보 유형 포함 |
| 오류 | 스캐너가 레이블을 지정하거나 식별하려고 시도했지만 식별할 수 없었던 파일만 기록합니다. 예를 들어 파일이 사용 중이거나 스캐너 서비스에 파일에 대한 쓰기 권한이 없습니다. |
| 끄기 | 보고를 비활성화하여 스캐너의 성능을 극대화합니다. |
로컬 Windows 응용 프로그램 및 서비스 이벤트 로그인 Information Protection Scanner 에는 추가 로깅 정보가 포함되어 있습니다. 이벤트에는 각 검사 주기의 시작 및 종료 시간, 검사된 파일에 레이블이 적용된 경우, 보호가 적용되거나 제거된 시간이 포함됩니다.
매개 변수 속성
| 형식: | ReportLevel |
| Default value: | None |
| 허용되는 값: | Off, Debug, Info, Error |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |