Set-FileLabel

Referens

Modul:: PurviewInformationProtection

Anger känslighetsetiketten och skyddet för en fil via manuell etikettering eller automatisk etikettering enligt etikettkonfigurationen eller anpassade behörigheter.

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.

Anteckning

När du kör cmdleten Set-FileLabel i en loop lägger du till följande två rader efter cmdleten: [GC]::Collect()
[GC]::WaitForPendingFinalizers()

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.

Anteckning

Det här kommandot använder Sökvägsalias för FullName, så att Get-Child-Item kan användas med Get-FileStatus.

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 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

När -AutoLabel används körs cmdleten i läget för automatisk etikettering. När cmdleten -AutoLabel inte används körs den i manuellt etiketteringsläge.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-CustomPermissions

Anger variabelnamnet som lagrar en ad hoc-skyddsprincip, som skapades med hjälp av cmdleten New-CustomPermissions . Ad hoc-skyddsprincipen används för att skydda filen eller filerna med anpassade behörigheter.

Typ:	AIPCustomPermissions
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DiscoveryInfoTypes

Ange vilka typer av känslig information som ska identifieras när du använder parametern WhatIf .

Om du vill söka efter specifika typer av känslig information anger du entitets-ID-nummer för den informationstypen, som du hittar i Typer av känslig information i Exchange Server.

Till exempel är "50842eb7-edc8-4019-85dd-5a5c1f2bb085" numret som ska anges för typ av känslig information för kreditkortsnummer.

Typ:	String[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Force

Ersätter en befintlig etikett när angivna villkor tillämpas.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-JustificationMessage

Motiveringen för att sänka klassificeringsetiketten, ta bort en etikett eller ta bort skydd, om känslighetsprincipen kräver att användarna anger den här informationen. Om inställningen av en etikett utlöser motiveringen och den här orsaken inte anges tillämpas inte etiketten. I det här fallet returneras statusen ”Skipped” (Överhoppad) med kommentaren ”Justification required” (Motivering krävs).

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-LabelId

Anger identiteten (ID) för etiketten som ska tillämpas. När en etikett har underetiketter anger du alltid ID:t för bara en underetikett och inte den överordnade etiketten.

Så här hittar du etikett-ID:t:

Etikett-ID-värdet visas inte i efterlevnadsportal i Microsoft Purview. Du kan dock använda följande powershell-kommando Office 365 Security & Compliance Center för att hitta det här värdet:Get-Label | Format-Table -Property DisplayName, Name, Guid

För filer som har tillämpade etiketter kan du också köra cmdleten Get-FileStatus för att identifiera etikett-ID :t (MainLabelId eller SubLabelId).

Typ:	Guid
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Owner

Anger ägare för att tillämpa etikett eller skydd på filen.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Path

Anger en lokal sökväg, nätverkssökväg eller SharePoint Server-URL till de filer som du vill hämta information om etiketten och skyddet för.

Jokertecken stöds inte och WebDav-platser stöds inte.

För SharePoint-sökvägar stöds följande:

SharePoint Server 2022
SharePoint Server 2019
SharePoint Server 2016
SharePoint Server 2013

Exempel:

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

Sökvägar kan innehålla blanksteg när du omger sökvägsvärdet med citattecken.

Typ:	String[]
Alias:	FullName, FileName
Position:	0
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-PreserveFileDetails

Ange den här parametern för att lämna det ändrade datumet (Windows och SharePoint) och ändrat av (SharePoint) värden oförändrade för dokument som du etiketterar:

För lokala filer eller nätverksfiler förblir det ändrade värdet för datum oförändrat.
För SharePoint-filer förblir värdena För ändringsdatum och Ändrad av oförändrade.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Indata

System.String[]

Utdata

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileResult

Dela via

Set-FileLabel

Syntax

Description

Exempel

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

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

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

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

Exempel 5: Skydda en fil med anpassade behörigheter

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

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

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

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

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

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

Parametrar

-AutoLabel

-CustomPermissions

-DiscoveryInfoTypes

-Force

-JustificationMessage

-LabelId

-Owner

-Path

-PreserveFileDetails

-WhatIf

Indata

Utdata

Ytterligare resurser

Dela via

Set-FileLabel

Syntax

Description

Exempel

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

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

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

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

Exempel 5: Skydda en fil med anpassade behörigheter

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

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

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

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

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

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

Parametrar

-AutoLabel

-CustomPermissions

-DiscoveryInfoTypes

-Force

-JustificationMessage

-LabelId

-Owner

-Path

-PreserveFileDetails

-WhatIf

Indata

Utdata

Relaterade länkar

Ytterligare resurser