Set-AIPFileClassification

모듈:

AzureInformationProtection

파일을 스캔하여 정책에 구성된 조건에 따라 파일에 대한 Azure Information Protection 레이블을 자동으로 설정합니다.

Syntax

Set-AIPFileClassification
   [-JustificationMessage <String>]
   [-Force]
   [-PreserveFileDetails]
   [-Path] <String[]>
   [<CommonParameters>]

Set-AIPFileClassification
   [-JustificationMessage <String>]
   [-Force]
   [-WhatIf]
   [-DiscoveryInfoTypes <String[]>]
   [-Path] <String[]>
   [<CommonParameters>]

Description

자동 분류를 위해 레이블을 구성할 때 Set-AIPFileClassification cmdlet은 하나 이상의 파일에 대한 레이블을 자동으로 적용할 수 있습니다.

이 cmdlet이 실행되면 파일 내용을 검사하고 구성된 조건이 레이블에 대해 충족되면 해당 레이블이 적용됩니다. 이 작업은 선택한 레이블이 보호를 적용하는 경우 자동으로 보호를 적용합니다.

기본적으로 파일에 이미 레이블이 있는 경우 기존 레이블 또는 보호를 바꾸지 않습니다.

파일이 수동으로 레이블이 지정되었기 때문에 레이블이 지정되지 않았거나, 지정한 조건과 일치하지 않거나, 파일 분류가 더 높은 경우 파일은 "적용할 레이블 없음"이라는 단일 주석으로 건너뜁니다.

자세한 내용은 다음을 참조하세요. 자동으로 콘텐츠에 민감도 레이블 적용

비대화형으로 cmdlet 실행

비대화형으로 이 cmdlet을 실행할 수 있습니다. 자세한 내용은 통합 레이블 지정 클라이언트 관리자 가이드를 참조하세요.

예제

예제 1: 폴더와 해당 하위 폴더의 모든 파일을 스캔하고 자동 분류에 대해 구성된 조건에 따라 레이블을 적용합니다

PS C:\> Set-AIPFileClassification -Path C:\Projects\ -PreserveFileDetails


FileName      : C:\Projects\Project1.docx
Status        : Success
Comment       :
MainLabelName : Confidential
MainLabelId   : 074e257c-1234-1234-1234-34a182080e71
SubLabelName  : Finance group
SubLabelId    : d9f23ae3-1234-1234-1234-f515f824c57b

FileName      : C:\Projects\Datasheet.pdf
Status        : Skipped
Comment       : No label to apply
MainLabelName : 
MainLabelId   : 
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Analysis.xlsx
Status        : Skipped
Comment       : No label to apply
MainLabelName : 
MainLabelId   : 
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Pricelist.xlsx
Status        : Skipped
Comment       : No label to apply
MainLabelName : 
MainLabelId   : 
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Dashboard.xlsx
Status        : Success
Comment       : 
MainLabelName : Public
MainLabelId   : f018e9e7-0cfc-4c69-b27a-ac3cb7df43cc
SubLabelName  : 
SubLabelId    :

이 명령은 Projects 폴더 및 해당 하위 폴더의 모든 파일을 검색하고 자동 레이블 지정 정책에서 구성된 조건에 따라 레이블을 설정합니다. 이 예제에서는 다섯 개의 파일이 있고, 두 개의 파일에 레이블이 자동으로 지정됩니다. Datasheet.pdf 파일의 내용이 이미 수동으로 레이블이 지정된 자동 분류 Analysis.xlsx 구성된 조건과 일치하지 않고 Pricelist.xlsx 레이블이 더 높기 때문에 레이블이 지정되지 않습니다. 명령이 -Force 매개 변수 없이 실행되므로 Analysis.xlsx 및 Pricelist.xlsx 대한 기존 레이블을 덮어쓰지 않습니다.

적용된 레이블이 Rights Management 보호를 적용하도록 구성되어 있으면 이 명령으로 레이블이 성공적으로 지정된 파일도 보호됩니다. 이 경우 이러한 파일의 Rights Management 소유자(Rights Management에 대한 모든 권한 있음)는 PowerShell 명령을 실행한 사용자입니다.

PreserveFileDetails 매개 변수가 지정되었으므로 레이블이 지정된 파일의 수정 날짜는 변경되지 않습니다.

예제 2: 폴더와 해당 하위 폴더의 모든 파일을 스캔하고 자동 분류에 대해 구성된 조건에 따라 레이블을 적용하여 기존 레이블을 무시합니다.

PS C:\> Set-AIPFileClassification -Path C:\Projects\ -Force -PreserveFileDetails


FileName      : C:\Projects\Project1.docx
Status        : Success
Comment       :
MainLabelName : Confidential
MainLabelId   : 074e257c-1234-1234-1234-34a182080e71
SubLabelName  : Finance group
SubLabelId    : d9f23ae3-1234-1234-1234-f515f824c57b

FileName      : C:\Projects\Datasheet.pdf
Status        : Skipped
Comment       : No label to apply
MainLabelName : 
MainLabelId   : 
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Analysis.xlsx
Status        : Success
Comment       :
MainLabelName : Public
MainLabelId   : f018e9e7-0cfc-4c69-b27a-ac3cb7df43cc
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Pricelist.xlsx
Status        : Success
Comment       :
MainLabelName : Public
MainLabelId   : f018e9e7-0cfc-4c69-b27a-ac3cb7df43cc
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Dashboard.xlsx
Status        : Success
Comment       : 
MainLabelName : Public
MainLabelId   : f018e9e7-0cfc-4c69-b27a-ac3cb7df43cc
SubLabelName  : 
SubLabelId    :

이 명령은 Projects 폴더 및 해당 하위 폴더의 모든 파일도 검색하고 자동 레이블 지정에 대해 구성된 조건에 따라 레이블을 설정한다는 측면에서 이전 예제와 비슷합니다. 그러나 이번에는 명령에 -Force 매개 변수가 포함되어 있으므로 Dashboard.xlsx대한 기존 레이블도 대체하고 Pricelist.xlsx.

Datasheet.pdf 내용이 구성된 조건과 일치하지 않으며 이 파일은 레이블 없이 유지됩니다.

예제 3: (통합 레이블 지정 클라이언트만 해당) WhatIf 모드에서 알려진 모든 중요한 정보 유형에 대한 파일 검색

PS C:\> Set-AIPFileClassification -Path C:\Projects\Project1.docx -WhatIf -DiscoveryInfoTypes All


MainLabelName           : General
MainLabelId             : 89a453df-5df4-4976-8191-jdn2fsf9560a
SubLabelName            :
SubLabelId              :
WhatIf                  : True
MatchedInformationTypes : {Credit Card Number, U.S. Social Security Number (SSN), International Classification of
                          Diseases (ICD-10-CM), International Classification of Diseases (ICD-9-CM)}
LastModifiedBy          :
LastModifiedTime        : 8/19/2014 5:11:26 AM
FileName                : C:\Projects\Project1.docx
Status                  : Success
Comment                 :

이 명령은 보호 또는 레이블을 적용하지 않고 Project1.docx 파일에서 알려진 모든 정보 유형을 검색합니다.

예제 4: (통합 레이블 지정 클라이언트만 해당) WhatIf 모드에서 특정 중요한 정보 유형에 대한 파일 검색

PS C:\> Set-AIPFileClassification -Path C:\Projects\Project1.docx -WhatIf -DiscoveryInfoTypes "50842eb7-edc8-4019-85dd-5a5c1f2bb085","a44669fe-0d48-453d-a9b1-2cc83f2cba77"

MainLabelName           : General
MainLabelId             : 89a453df-5df4-4976-8191-jdn2fsf9560a
SubLabelName            :
SubLabelId              :
WhatIf                  : True
MatchedInformationTypes : {Credit Card Number, U.S. Social Security Number (SSN)}
LastModifiedBy          :
LastModifiedTime        : 8/19/2014 5:11:26 AM
FileName                : Project1.docx
Status                  : Success
Comment                 :

이 명령은 보호 또는 레이블을 적용하지 않고 Project1.docx 파일에서 "신용 카드 번호" 및 "사회 보장 번호(SSN)"의 특정 정보 유형을 검색합니다.

예제 5: (통합 레이블 지정 클라이언트만 해당) WhatIf 모드에서 특정 중요한 정보 유형을 검색하고 찾은 값을 표시합니다.

PS C:\> $x=Set-AIPFileClassification -Path "C:\Projects\Project1.docx" -WhatIf -DiscoveryInfoTypes "50842eb7-edc8-4019-85dd-5a5c1f2bb085","a44669fe-0d48-453d-a9b1-2cc83f2cba77"
PS C:\> $x.MatchedInformationTypes

RulePackageSetId  : 00000000-0000-0000-0000-000000000000
RulePackageId     : 00000000-0000-0000-0000-000000000000
RuleId            : 50842eb7-edc8-4019-85dd-5a5c1f2bb085
Name              : Credit Card Number
Count             : 1
UniqueCount       : 1
Confidence        : 85
SensitiveContents : {Offset: 2089, Length: 19}
 
RulePackageSetId  : 00000000-0000-0000-0000-000000000000
RulePackageId     : 00000000-0000-0000-0000-000000000000
RuleId            : a44669fe-0d48-453d-a9b1-2cc83f2cba77
Name              : U.S. Social Security Number (SSN)
Count             : 1
UniqueCount       : 1
Confidence        : 85
SensitiveContents : {Offset: 7063, Length: 11}


PS C:\> $x.MatchedInformationTypes[0].SensitiveContents | fl

Offset  : 2089
Length  : 19
Value   : 4539-9572-7949-2212
Context : OLOGICAL SCIENCES     Credit Card #
          Expiration Date:      4539-9572-7949-2212
          8/2009                Department:     BIOLOGICAL SCIENCES     Anticipa

이전 예제와 마찬가지로 첫 번째 명령은 보호 또는 레이블을 적용하지 않고 Project1.docx 파일에서 "신용 카드 번호" 및 "SSN(사회 보장 번호)"의 특정 정보 유형을 검색합니다. 그러나 이 예제에서 결과는 추가 처리를 위해 변수에 저장됩니다.

그런 다음 두 번째 명령은 SensitiveContents 매개 변수를 포함하는 일치하는 정보 형식의 내용을 표시하는 데 사용됩니다.

마지막 명령은 첫 번째 중요한 정보 유형(이 예제에서는 신용 카드 세부 정보)으로 식별되는 데이터를 더 쉽게 읽을 수 있도록 표시 및 형식을 표시합니다.

매개 변수

-DiscoveryInfoTypes

참고: 이 매개 변수는 Azure Information Protection 통합 레이블 지정 클라이언트에서만 지원됩니다.

WhatIf 매개 변수를 사용할 때 검색할 중요한 정보 유형을 지정합니다.

특정 중요한 정보 유형을 검색하려면 해당 정보 형식에 대한 엔터티 ID 번호를 지정합니다. 이 번호는 Exchange Server 중요한 정보 유형에 나열되어 있습니다.

예를 들어 "50842eb7-edc8-4019-85dd-5a5c1f2bb085"는 신용 카드 번호 중요한 정보 유형에 대해 지정할 번호입니다.

Type:	String[]
Accepted values:	All, "rule_id_1", "rule_id_2"
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

구성된 조건이 적용될 때 기존 레이블을 바꿉니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-JustificationMessage

사용자가 Azure Information Protection 정책에 이 정보를 제공해야 하는 경우 분류 레이블을 낮추거나, 레이블을 제거하거나, 보호를 제거하기 위한 정당한 이유입니다.

레이블을 설정하면 근거를 트리거하고 이러한 이유가 제공되지 않으면 -Force 매개 변수가 설정된 경우에도 레이블이 적용되지 않습니다. 이 경우 반환된 상태는 다음 주석과 함께 "건너뛰기"입니다. "적용할 레이블 없음"

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

레이블 및 보호 정보를 가져올 파일에 대한 로컬 경로, 네트워크 경로 또는 SharePoint Server URL을 지정합니다.

와일드카드는 지원되지 않으며 WebDav 위치도 지원되지 않습니다.

SharePoint 경로의 경우 다음이 지원됩니다.

• SharePoint Server 2019
• SharePoint Server 2016
• SharePoint Server 2013

다음은 그 예입니다.

• C:\Folder\
• C:\Folder\Filename
• \\Server\Folder
• http://sharepoint.contoso.com/Shared%20Documents/Folder

경로 값을 따옴표로 묶으면 경로에 공백이 포함될 수 있습니다.

Type:	String[]
Aliases:	FullName, FileName
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-PreserveFileDetails

레이블을 지정하는 문서의 날짜를 변경하지 않고 유지하려면 이 매개 변수를 지정합니다.

로컬 또는 네트워크 파일의 경우 마지막으로 수정한 날짜는 변경되지 않습니다.

SharePoint 파일의 경우 수정된 날짜와 수정한 날짜는 변경되지 않습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

cmdlet이 실행되고 스캐너의 검색 모드와 동일한 경우 어떻게 되는지 보여 주세요. 입력 또는 출력 파일에는 변경 내용이 적용되지 않습니다.

DiscoveryInfoTypes와 함께 이 매개 변수를 사용하여 모든 중요한 정보 유형 또는 특정 중요한 정보 유형을 찾습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

입력

System.String[]

출력

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileClassificationResult

관련 링크

• Get-AIPFileStatus
• Set-AIPAuthentication
• Set-AIPFileLabel