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

W przypadku klienta usługi Microsoft Purview Information Protection polecenie cmdlet Set-FileLabel ustawia etykietę poufności dla co najmniej jednego pliku. Ta akcja może automatycznie stosować ochronę, gdy etykiety są skonfigurowane do stosowania szyfrowania.

Ponadto możesz użyć tego polecenia cmdlet, aby zastosować uprawnienia niestandardowe podczas tworzenia ich jako obiektu zasad ochrony ad hoc za pomocą polecenia cmdlet New-CustomPermissions .

Po pomyślnym uruchomieniu polecenia można zastąpić dowolną istniejącą etykietę lub ochronę.

To polecenie cmdlet można uruchomić nieinterakcyjne. Aby uzyskać więcej informacji, zobacz Ujednolicony przewodnik administratora klienta etykietowania.

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

To polecenie najpierw identyfikuje wszystkie pliki, które nie są oznaczone za pomocą polecenia cmdlet Get-FileStatus . Następnie te pliki są oznaczone etykietą, określając etykietę "Ogólne" według jego identyfikatora.

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

To polecenie najpierw identyfikuje wszystkie .docx pliki w folderze C:\Projects (i jego podfolderach) przy użyciu polecenia Get-Child-Item, a następnie znajduje z tych plików te, które nie są oznaczone etykietą przy Get-FileStatus użyciu polecenia cmdlet. Wynikowe pliki są następnie oznaczane etykietami, określając etykietę Ogólne według jej identyfikatora.

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

To polecenie ustawia etykietę o nazwie "Ogólne" dla wszystkich plików w folderze C:\Projects i wszystkich jego podfolderach.

Jeśli etykieta Ogólna jest skonfigurowana do stosowania szyfrowania, pliki, które zostały pomyślnie oznaczone za pomocą tego polecenia, również będą szyfrowane. W takim przypadku właściciel usługi Rights Management (który ma uprawnienie Pełna kontrola usługi Rights Management) tych plików jest użytkownikiem, który uruchomił polecenie programu PowerShell.

W tym przykładzie jeden plik nie został oznaczony etykietą (pominiętą), ponieważ wymaga uzasadnienia. Może to być zamierzony wynik, aby upewnić się, że plik z wyższą etykietą klasyfikacji lub ochroną nie został przypadkowo zastąpiony niższą etykietą klasyfikacji lub czy ochrona została usunięta.

Aby włączyć tę ochronę, należy skonfigurować zasady etykiet klasyfikacji usługi Office 365, aby wymagać uzasadnienia usunięcia etykiety lub obniżenia klasyfikacji. Po uruchomieniu tego polecenia bez parametru JustificationMessage i etykieta wyzwala uzasadnienie, plik zostanie pominięty z komentarzem "Brak etykiety do zastosowania".

$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

To polecenie ustawia etykietę "Ogólne" dla pliku, który jest już oznaczony etykietą o większej poufności. Zasady etykiet poufności są skonfigurowane tak, aby wymagać uzasadnienia usunięcia etykiety lub obniżenia klasyfikacji. Ponieważ polecenie zawiera komunikat uzasadnienia, nowa etykieta zostanie pomyślnie zastosowana.

$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

Pierwsze polecenie tworzy obiekt zasad ochrony ad hoc, który przyznaje użytkownikom z różnych organizacji prawa użytkowania z uprawnień recenzenta, a także stosuje datę wygaśnięcia.

Drugie polecenie chroni pojedynczy plik o nazwie Analysis.docx przy użyciu uprawnień niestandardowych w przechowywanym obiekcie zasad ochrony ad hoc.

$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

Pierwsze polecenie tworzy obiekt zasad ochrony ad hoc, który przyznaje użytkownikom z różnych organizacji prawa użytkowania z uprawnień recenzenta, a także stosuje datę wygaśnięcia.

Drugie polecenie stosuje etykietę do pojedynczego pliku o nazwie Analysis.docx, a także chroni plik przy użyciu uprawnień niestandardowych w przechowywanym obiekcie zasad ochrony ad hoc. Jeśli etykieta jest skonfigurowana pod kątem ustawień ochrony, zostaną one zastąpione przez uprawnienia niestandardowe.

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    :

To polecenie skanuje wszystkie pliki w folderze Projects i dowolnym z jego podfolderów i ustawia etykiety zgodnie ze skonfigurowanymi warunkami w zasadach automatycznego etykietowania. W tym przykładzie istnieje pięć plików, a dwa pliki są automatycznie oznaczone etykietą. Plik Datasheet.pdf nie jest oznaczony etykietą, ponieważ jego zawartość nie jest zgodna ze skonfigurowanymi warunkami automatycznego etykietowania Analysis.xlsx , został już ręcznie oznaczony etykietą i Pricelist.xlsx ma wyższą etykietę. Ponieważ polecenie jest uruchamiane bez parametru Force , istniejące etykiety dla Analysis.xlsx i Pricelist.xlsx nie są zastępowane.

Jeśli zastosowane etykiety są również skonfigurowane do zastosowania ochrony usługi Rights Management, pliki, które zostały pomyślnie oznaczone za pomocą tego polecenia, są również chronione. W takim przypadku właściciel usługi Rights Management (który ma uprawnienie Pełna kontrola usługi Rights Management) tych plików jest użytkownikiem, który uruchomił polecenie programu PowerShell.

Ponieważ parametr PreserveFileDetails jest określony, data modyfikacji plików oznaczonych etykietami pozostaje niezmieniona.

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    :

To polecenie jest podobne do poprzedniego przykładu, ponieważ skanuje również wszystkie pliki w folderze Projects i dowolnym z jego podfolderów oraz ustawia etykiety zgodnie ze skonfigurowanymi warunkami automatycznego etykietowania. Jednak tym razem, ponieważ polecenie zawiera parametr Force , zastępuje ono również istniejącą etykietę dla Dashboard.xlsx, i Pricelist.xlsx.

Zawartość pliku Datasheet.pdf nie spełnia żadnych skonfigurowanych warunków i ten plik pozostaje bez etykiety.

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                 :

To polecenie umożliwia odnalezienie wszystkich znanych typów informacji w pliku Project1.docx bez stosowania ochrony ani etykiety.

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

To polecenie wykrywa określone typy informacji, takie jak numer karty kredytowej i numer ubezpieczenia społecznego (SSN) w Project1.docx pliku, bez stosowania ochrony lub etykiety.

$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

Podobnie jak w poprzednim przykładzie, pierwsze polecenie odnajduje określone typy informacji, takie jak numer karty kredytowej i numer ubezpieczenia społecznego (SSN) w Project1.docx pliku bez stosowania ochrony lub etykiety. Jednak w tym przykładzie wyniki są przechowywane w zmiennej do dalszego przetwarzania.

Drugie polecenie jest następnie używane do wyświetlania zawartości dopasowanych typów informacji, który zawiera parametr SensitiveContents.

Końcowe polecenie wyświetla i formatuje, aby ułatwić odczytywanie danych zidentyfikowanych przez pierwszy typ informacji poufnych, który w tym przykładzie to szczegóły karty kredytowej.

Podczas uruchamiania Set-FileLabel polecenia cmdlet w pętli dodaj następujące polecenie po poleceniu cmdlet:

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

Te polecenia zapewniają, że moduł odśmiecania pamięci jest uruchamiany i zwalnia pamięć, która nie jest już potrzebna.