Set-FileLabel

Set-FileLabel
    [-Path] <String[]>
    -LabelId <Guid>
    [-JustificationMessage <String>]
    [-Owner <String>]
    [-PreserveFileDetails]

Set-FileLabel
    [-Path] <String[]>
    -LabelId <Guid>
    -CustomPermissions <AIPCustomPermissions>
    [-JustificationMessage <String>]
    [-Owner <String>]
    [-PreserveFileDetails]

Set-FileLabel
    [-Path] <String[]>
    -CustomPermissions <AIPCustomPermissions>
    [-Owner <String>]
    [-PreserveFileDetails]

Set-FileLabel
    [-Path] <String[]>
    [-JustificationMessage <String>]
    [-Owner <String>]
    [-Force]
    [-PreserveFileDetails]
    [-AutoLabel]

Set-FileLabel
    [-Path] <String[]>
    [-PreserveFileDetails]
    [-WhatIf]
    [-DiscoveryInfoTypes <String[]>]

Microsoft Purview Information Protection 클라이언트의 경우 Set-FileLabel cmdlet은 하나 이상의 파일에 대한 민감도 레이블을 설정합니다. 이 작업은 레이블이 암호화를 적용하도록 구성된 경우 자동으로 보호를 적용할 수 있습니다.

또한 이 cmdlet을 사용하여 New-CustomPermissions cmdlet을 사용하여 임시 보호 정책 개체로 만들 때 사용자 지정 권한을 적용할 수 있습니다.

명령이 성공적으로 실행되면 기존 레이블 또는 보호를 바꿀 수 있습니다.

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

Get-FileStatus -Path \\Finance\Projects\ |
    Where-Object {$_.IsLabeled -eq $False} |
    Set-FileLabel -LabelId d9f23ae3-4321-4321-4321-f515f824c57b

FileName                              Status Comment
--------                              ------ ------------
\\Finance\Projects\Image.jpg          Success
\\Finance\Projects\Pricelist.pdf      Success
\\Finance\Projects\Announcement.docx  Success
\\Finance\Projects\Analysis.xlsx      Success

이 명령은 먼저 Get-FileStatus cmdlet을 사용하여 레이블이 지정되지 않은 모든 파일을 식별합니다. 그런 다음 이러한 파일은 ID로 "일반" 레이블을 지정하여 레이블이 지정됩니다.

Get-ChildItem C:\Projects\*.docx -File -Recurse |
    Get-FileStatus |
    Where-Object {$_.IsLabeled -eq $False} |
    Set-FileLabel -LabelId d9f23ae3-1234-1234-1234-f515f824c57b

FileName                   Status  Comment
--------                   ------  ------------
C:\Projects\Analysis.docx  Success
C:\Projects\Projects.docx  Success

이 명령은 먼저 .docx을 사용하여 폴더(및 해당 하위 폴더)의 C:\Projects 모든 파일을 식별한 다음 cmdlet을 Get-FileStatus 사용하여 레이블이 지정되지 않은 파일을 이러한 파일에서 찾습니다. 그런 다음 결과 파일은 해당 ID로 General 레이블을 지정하여 레이블을 지정합니다.

Set-FileLabel -Path C:\Projects\ -LabelId d9f23ae3-1324-1234-1234-f515f824c57b

FileName                    Status      Comment
--------                    ------      ------------
C:\Projects\Project1.docx   Success
C:\Projects\Datasheet.pdf   Success
C:\Projects\Image.jpg       Success
C:\Projects\Analysis.xlsx   Skipped    No label to apply
C:\Projects\Dashboard.xlsx  Success

이 명령은 폴더 및 해당 하위 폴더의 모든 파일에 C:\Projects 대해 "일반"이라는 레이블을 설정합니다.

일반 레이블이 암호화를 적용하도록 구성된 경우 이 명령으로 레이블이 성공적으로 지정된 파일도 암호화됩니다. 이 경우 이러한 파일의 권한 관리 소유자(권한 관리 모든 권한 권한이 있는 사람)는 PowerShell 명령을 실행한 사용자입니다.

이 예제에서는 한 파일에 근거가 필요하므로 레이블이 지정되지 않았습니다(건너뛰기). 이는 분류 레이블 또는 보호가 높은 파일이 실수로 더 낮은 분류 레이블로 덮어쓰여지지 않거나 보호가 제거되지 않도록 하기 위한 결과일 수 있습니다.

이 보호 기능을 사용하려면 레이블을 제거하거나 분류를 낮추기 위한 근거를 요구하도록 Office 365 분류 레이블 정책을 구성해야 합니다. 그런 다음 JustificationMessage 매개 변수 없이 이 명령을 실행하고 레이블이 근거를 트리거하면 파일은 "적용할 레이블 없음" 주석으로 건너뜁니다.

$setFileLabelSplat = @{
    Path = '\\Finance\Projects\Analysis.xlsx'
    LabelId = 'd9f23ae3-1324-1234-1234-f515f824c57b'
    JustificationMessage = 'The previous label no longer applies'
}
Set-FileLabel @setFileLabelSplat

FileName                          Status      Comment
--------                          ------      ------------
\\finance\projects\analysis.xlsx  Success

이 명령은 이미 높은 민감도 레이블로 레이블이 지정된 파일에 대해 "일반" 레이블을 설정합니다. 민감도 레이블 정책은 레이블을 제거하거나 분류를 낮추기 위한 근거를 요구하도록 구성됩니다. 명령에 근거 메시지가 포함되어 있으므로 새 레이블이 성공적으로 적용됩니다.

$newCustomPermissionsSplat = @{
    Users = 'user1@contoso.com', 'user2@vanarsdel.com'
    Permissions = 'Reviewer'
    ExpirationDate = (Get-Date -Month 1 -Day 1 -Year 2020)
}
$permissions = New-CustomPermissions @newCustomPermissionsSplat
Set-FileLabel C:\Projects\Analysis.docx -CustomPermissions $permissions

FileName                   Status Comment
--------                   ------ ------------
C:\Projects\Analysis.docx  Success

첫 번째 명령은 검토자 권한에서 다른 조직의 사용 권한을 사용자에게 부여하고 만료 날짜도 적용하는 임시 보호 정책 개체를 만듭니다.

두 번째 명령은 저장된 임시 보호 정책 개체의 사용자 지정 권한을 사용하여 명명된 Analysis.docx 단일 파일을 보호합니다.

$permissions = New-CustomPermissions -Users a@a.com, b@b.com -Permissions Reviewer
$setFileLabelSplat = @{
    LabelId = 'd9f23ae3-1324-1234-1234-f515f824c57b'
    CustomPermissions = $permissions
}
Set-FileLabel @setFileLabelSplat C:\Projects\Analysis.docx

FileName                   Status Comment
--------                   ------ ------------
C:\Projects\Analysis.docx  Success

첫 번째 명령은 검토자 권한에서 다른 조직의 사용 권한을 사용자에게 부여하고 만료 날짜도 적용하는 임시 보호 정책 개체를 만듭니다.

두 번째 명령은 Analysis.docx 명명된 단일 파일에 레이블을 적용하고 저장된 임시 보호 정책 개체의 사용자 지정 권한을 사용하여 파일을 보호합니다. 레이블이 보호 설정에 대해 구성된 경우 사용자 지정 권한으로 바뀝니다.

Set-FileLabel -AutoLabel -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 폴더의 모든 파일과 해당 하위 폴더를 검색하고 자동 레이블 지정 정책에서 구성된 조건에 따라 레이블을 설정합니다. 이 예제에는 5개의 파일이 있고 두 개의 파일이 자동으로 레이블이 지정됩니다. Datasheet.pdf 파일의 내용이 자동 레이블 지정 Analysis.xlsx 에 대해 구성된 조건과 일치하지 않고 이미 수동으로 레이블이 지정되었으며 Pricelist.xlsx 더 높은 레이블이 있기 때문에 레이블이 지정되지 않았습니다. 명령은 Force 매개변수 없이 실행되기 때문에 및 에 Analysis.xlsx 대한 Pricelist.xlsx 기존 레이블은 덮어쓰여지지 않습니다.

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

PreserveFileDetails 매개 변수가 지정되었기 때문에 레이블이 지정된 파일의 수정된 날짜는 변경되지 않은 상태로 유지됩니다.

Set-FileLabel -Autolabel -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 내용이 구성된 조건과 일치하지 않으며 이 파일은 레이블 없이 남아 있습니다.

Set-FileLabel -AutoLabel -Path C:\Projects\Project1.docx -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 파일에서 알려진 모든 정보 유형을 검색합니다.

$setFileLabelSplat = @{
    AutoLabel = -AutoLabel
    Path = 'C:\Projects\Project1.docx'
    DiscoveryInfoTypes = "50842eb7-edc8-4019-85dd-5a5c1f2bb085", "a44669fe-0d48-453d-a9b1-2cc83f2cba77"
}
Set-FileLabel @setFileLabelSplat

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                 :

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

$setFileLabelSplat = @{
    AutoLabel = -AutoLabel
    Path = 'C:\Projects\Project1.docx'
    DiscoveryInfoTypes = '50842eb7-edc8-4019-85dd-5a5c1f2bb085',
        'a44669fe-0d48-453d-a9b1-2cc83f2cba77'
}
$x = Set-FileLabel @setFileLabelSplat
$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}

$x.MatchedInformationTypes[0].SensitiveContents | Format-List

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

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

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

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

루프에서 cmdlet을 Set-FileLabel 실행하는 경우 cmdlet 뒤에 다음 명령을 추가합니다.

• [GC]::Collect()
• [GC]::WaitForPendingFinalizers()

이러한 명령은 가비지 수집기가 실행되고 더 이상 필요하지 않은 메모리를 해제하도록 합니다.