Set-FileLabel

Syntax

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

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

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

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

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

Description

För den Microsoft Purview Information Protection klienten anger cmdleten Set-FileLabel en känslighetsetikett för en eller flera filer. Den här åtgärden kan automatiskt tillämpa skydd när etiketter har konfigurerats för att tillämpa kryptering.

Dessutom kan du använda den här cmdleten för att tillämpa anpassade behörigheter när de skapas som ett ad hoc-skyddsprincipobjekt med cmdleten New-CustomPermissions .

När kommandot körs korrekt kan alla befintliga etiketter eller skydd ersättas.

Du kan köra denna cmdlet icke-interaktivt. Mer information finns i administratörsguiden för enhetlig etiketteringsklient.

Exempel

Exempel 1: Använd etiketten "Allmänt" för alla filer som för närvarande inte har någon etikett

PS C:\> Get-FileStatus -Path \\Finance\Projects\ | where {$_.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

Det här kommandot identifierar först alla filer som inte är märkta med hjälp av cmdleten Get-FileStatus . Sedan etiketteras dessa filer genom att etiketten "Allmänt" anges med dess ID.

Exempel 2: Använd etiketten "Allmänt" för att .docx filer som inte är märkta

PS C:\> Get-ChildItem C:\Projects\*.docx -File -Recurse | Get-FileStatus | where {$_.IsLabeled -eq $False} | Set-FileLabel -LabelId d9f23ae3-1234-1234-1234-f515f824c57b
FileName                   Status  Comment
--------                   ------  ------------
C:\Projects\Analysis.docx  Success
C:\Projects\Projects.docx  Success

Det här kommandot identifierar först alla .docx filer i mappen C:\Projects (och dess undermappar) med hjälp av Get-Child-Item och söker sedan efter de filer som inte är märkta med cmdleten Get-FileStatus . De resulterande filerna etiketteras sedan genom att etiketten "Allmänt" anges med dess ID.

Exempel 3: Använd etiketten "Allmänt" på alla filer i en mapp och någon av dess undermappar

PS C:\> 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

Det här kommandot anger en etikett med namnet "Allmänt" för alla filer i mappen Projects och någon av dess undermappar.

Om etiketten Allmänt har konfigurerats för att tillämpa kryptering krypteras även de filer som har etiketterats med det här kommandot. I det här fallet är Rights Management-ägaren (den som har behörighetsnivån Fullständig behörighet för Rights Management) till dessa filer den användare som körde PowerShell-kommandot.

I det här exemplet var en fil inte märkt (hoppades över) eftersom det krävde en motivering. Detta kan vara det avsedda resultatet för att säkerställa att en fil med en högre klassificeringsetikett eller ett högre skydd inte skrivs över av misstag med en lägre klassificeringsetikett eller att skyddet tas bort.

Om du vill aktivera det här skyddet måste Office 365 princip för klassificeringsetiketter konfigureras för att kräva motivering för att ta bort en etikett eller sänka klassificeringen. När du sedan kör det här kommandot utan parametern JustificationMessage och etiketten utlöser en motivering hoppas filen över med kommentaren "Ingen etikett att använda".

Exempel 4: Använd etiketten "Allmänt" på en enskild fil, vilket kräver motivering

PS C:\> Set-FileLabel -Path \\Finance\Projects\Analysis.xlsx -LabelId d9f23ae3-1324-1234-1234-f515f824c57b -JustificationMessage 'The previous label no longer applies'
FileName                          Status      Comment
--------                          ------      ------------
\\finance\projects\analysis.xlsx  Success

Det här kommandot anger etiketten "Allmänt" för en fil som redan är märkt med en högre känslighetsetikett. Principen för känslighetsetiketter är konfigurerad för att kräva motivering för att ta bort en etikett eller sänka klassificeringen. Eftersom kommandot innehåller ett motiveringsmeddelande tillämpas den nya etiketten.

Exempel 5: Skydda en fil med anpassade behörigheter

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

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

Det första kommandot skapar ett ad hoc-skyddsprincipobjekt som beviljar användare från olika organisationer användningsrättigheter från granskarbehörigheterna och även tillämpar ett förfallodatum.

Det andra kommandot skyddar en enda fil med namnet Analysis.docx med hjälp av anpassade behörigheter i det lagrade ad hoc-skyddsprincipobjektet.

Exempel 6: Tillämpa en etikett och anpassade behörigheter på filen

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

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

Det första kommandot skapar ett ad hoc-skyddsprincipobjekt som beviljar användare från olika organisationer användningsrättigheter från granskarbehörigheterna och även tillämpar ett förfallodatum.

Det andra kommandot tillämpar en etikett på en enda fil med namnet Analysis.docx och skyddar även filen med hjälp av anpassade behörigheter i det lagrade ad hoc-skyddsprincipobjektet. Om etiketten har konfigurerats för skyddsinställningar ersätts de av de anpassade behörigheterna.

Exempel 7: Sök igenom alla filer i en mapp och dess undermappar och tillämpa etiketter enligt de konfigurerade villkoren för automatisk etikettering

PS C:\> 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    :

Det här kommandot söker igenom alla filer i mappen Projects och någon av dess undermappar och anger etiketter enligt de konfigurerade villkoren i principen för automatisk etikettering. I det här exemplet finns det fem filer och två filer får etiketter automatiskt. Den Datasheet.pdf filen är inte märkt eftersom dess innehåll inte matchar de konfigurerade villkoren för automatisk etikettering Analysis.xlsx redan har etiketterats manuellt och Pricelist.xlsx har en högre etikett. Eftersom kommandot körs utan parametern -Force skrivs inte de befintliga etiketterna för Analysis.xlsx och Pricelist.xlsx över.

Om de etiketter som tillämpas också har konfigurerats för att använda Rights Management-skydd skyddas även de filer som får en etikett med det här kommandot. I det här fallet är Rights Management-ägaren (den som har behörighetsnivån Fullständig behörighet för Rights Management) till dessa filer den användare som körde PowerShell-kommandot.

Eftersom parametern PreserveFileDetails har angetts förblir ändringsdatumet för de märkta filerna oförändrat.

Exempel 8: Sök igenom alla filer i en mapp och dess undermappar och tillämpa etiketter enligt de konfigurerade villkoren för automatisk etikettering och åsidosätta befintliga etiketter

PS C:\> 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    :

Det här kommandot liknar föregående exempel eftersom det även söker igenom alla filer i mappen Projects och någon av dess undermappar och anger etiketter enligt de konfigurerade villkoren för automatisk etikettering. Men den här gången, eftersom kommandot innehåller parametern -Force , ersätter det även den befintliga etiketten för Dashboard.xlsxoch Pricelist.xlsx.

Innehållet i Datasheet.pdf matchade inte några konfigurerade villkor och den här filen förblir utan etikett.

Exempel 9: Sök igenom en fil i WhatIf-läge efter alla kända typer av känslig information

PS C:\> Set-FileLabel -AutoLabel -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                 :

Det här kommandot identifierar alla kända informationstyper i Project1.docx fil utan att använda skydd eller en etikett.

Exempel 10: Sök igenom en fil i WhatIf-läge efter specifika typer av känslig information

PS C:\> Set-FileLabel -AutoLabel -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                 :

Det här kommandot identifierar de specifika informationstyperna "Kreditkortsnummer" och "Personnummer (SSN)" i Project1.docx fil utan att använda skydd eller en etikett.

Exempel 11: Sök igenom en fil i WhatIf-läge efter specifika typer av känslig information och visa de värden som hittades

PS C:\> $x=Set-FileLabel -AutoLabel -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

Precis som i föregående exempel identifierar det första kommandot de specifika informationstyperna "Kreditkortsnummer" och "Personnummer (SSN)" i Project1.docx fil utan att använda skydd eller en etikett. Men i det här exemplet lagras resultaten i en variabel för vidare bearbetning.

Det andra kommandot används sedan för att visa innehållet i de matchade informationstyperna, som innehåller parametern SensitiveContents.

Det sista kommandot visar och formaterar för enklare läsning av data som identifieras av den första typen av känslig information, som i det här exemplet är kreditkortsinformationen.

Parametrar

-AutoLabel

-CustomPermissions

-DiscoveryInfoTypes

-Force

-JustificationMessage

-LabelId

-Owner

-Path

-PreserveFileDetails

-WhatIf

Indata

System.String[]

Utdata

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileResult

Relaterade länkar

• Get-FileStatus
• New-CustomPermissions
• Set-Authentication