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

Für den Microsoft Purview Information Protection-Client legt das Cmdlet Set-FileLabel eine Vertraulichkeitsbezeichnung für eine oder mehrere Dateien fest. Diese Aktion kann automatisch Schutz anwenden, wenn Bezeichnungen für die Anwendung der Verschlüsselung konfiguriert sind.

Darüber hinaus können Sie mit diesem Cmdlet benutzerdefinierte Berechtigungen anwenden, wenn sie als Ad-hoc-Schutzrichtlinienobjekt mit dem Cmdlet New-CustomPermissions erstellt werden.

Wenn der Befehl erfolgreich ausgeführt wird, können vorhandene Bezeichnungen oder Schutz ersetzt werden.

Sie können dieses Cmdlet nicht interaktiv ausführen. Weitere Informationen finden Sie im Handbuch für den Clientadministrator für einheitliche Bezeichnungen.

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

Mit diesem Befehl werden zunächst alle Dateien identifiziert, die nicht mit dem Cmdlet "Get-FileStatus " bezeichnet werden. Anschließend werden diese Dateien durch Angabe der Bezeichnung "Allgemein" anhand ihrer ID bezeichnet.

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

Dieser Befehl identifiziert zunächst alle .docx Dateien im C:\Projects Ordner (und seinen Unterordnern) mithilfe von Get-Child-Item und sucht dann mithilfe des Cmdlets aus diesen Dateien nach Dateien, die nicht mit dem Get-FileStatus Cmdlet gekennzeichnet sind. Die resultierenden Dateien werden dann beschriftet, indem die Bezeichnung "Allgemein" anhand ihrer ID angegeben wird.

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

Mit diesem Befehl wird für alle Dateien im C:\Projects Ordner und in allen Unterordnern eine Bezeichnung mit dem Namen "Allgemein" festgelegt.

Wenn die Allgemeine Bezeichnung für die Anwendung der Verschlüsselung konfiguriert ist, werden die Dateien, die mit diesem Befehl erfolgreich gekennzeichnet wurden, ebenfalls verschlüsselt. In diesem Fall ist der Rechteverwaltungsbesitzer (der über die Berechtigung "Rechteverwaltung Vollzugriff") dieser Dateien verfügt, der Benutzer, der den PowerShell-Befehl ausgeführt hat.

In diesem Beispiel wurde eine Datei nicht bezeichnet (übersprungen), da sie eine Begründung erforderte. Dies kann das beabsichtigte Ergebnis sein, um sicherzustellen, dass eine Datei mit einer höheren Klassifizierungsbezeichnung oder einem Schutz nicht versehentlich mit einer niedrigeren Klassifizierungsbezeichnung überschrieben wird oder den Schutz entfernt hat.

Um diesen Schutz zu aktivieren, muss die Office 365-Klassifizierungsbezeichnungsrichtlinie so konfiguriert werden, dass eine Begründung zum Entfernen einer Bezeichnung oder zum Verringern der Klassifizierung erforderlich ist. Wenn Sie diesen Befehl dann ohne den Parameter "JustificationMessage " ausführen und die Bezeichnung die Begründung auslöst, wird die Datei mit dem Kommentar "Keine Bezeichnung angewendet" übersprungen.

$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

Mit diesem Befehl wird die Bezeichnung "Allgemein" für eine Datei festgelegt, die bereits mit einer höheren Vertraulichkeitsbezeichnung gekennzeichnet ist. Die Richtlinie für Vertraulichkeitsbezeichnungen ist so konfiguriert, dass eine Begründung zum Entfernen einer Bezeichnung oder zum Verringern der Klassifizierung erforderlich ist. Da der Befehl eine Begründungsmeldung enthält, wird die neue Bezeichnung erfolgreich angewendet.

$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

Der erste Befehl erstellt ein Ad-hoc-Schutzrichtlinienobjekt, das Benutzern aus verschiedenen Organisationen Nutzungsrechte aus den Berechtigungen des Prüfers gewährt und auch ein Ablaufdatum anwendet.

Der zweite Befehl schützt eine einzelne Datei, die mithilfe der benutzerdefinierten Berechtigungen im gespeicherten Ad-hoc-Schutzrichtlinienobjekt benannt Analysis.docx ist.

$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

Der erste Befehl erstellt ein Ad-hoc-Schutzrichtlinienobjekt, das Benutzern aus verschiedenen Organisationen Nutzungsrechte aus den Berechtigungen des Prüfers gewährt und auch ein Ablaufdatum anwendet.

Der zweite Befehl wendet eine Bezeichnung auf eine einzelne Datei mit dem Namen Analysis.docx an und schützt die Datei auch mithilfe der benutzerdefinierten Berechtigungen im gespeicherten Ad-hoc-Schutzrichtlinienobjekt. Wenn die Bezeichnung für Schutzeinstellungen konfiguriert ist, werden sie durch die benutzerdefinierten Berechtigungen ersetzt.

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    :

Mit diesem Befehl werden alle Dateien im Ordner "Projekte" und alle unterordner überprüft und Beschriftungen entsprechend den konfigurierten Bedingungen in der Richtlinie für die automatische Bezeichnung festgelegt. In diesem Beispiel gibt es fünf Dateien, und zwei Dateien werden automatisch bezeichnet. Die Datasheet.pdf Datei wird nicht beschriftet, da ihr Inhalt nicht den konfigurierten Bedingungen für die automatische Beschriftung Analysis.xlsx entspricht, wurde bereits manuell beschriftet und Pricelist.xlsx weist eine höhere Bezeichnung auf. Da der Befehl ohne den Force-Parameter ausgeführt wird, werden die vorhandenen Bezeichnungen für Analysis.xlsx und Pricelist.xlsx nicht überschrieben.

Wenn die angewendeten Bezeichnungen auch für die Anwendung des Rights Management-Schutzes konfiguriert sind, werden die Dateien, die mit diesem Befehl erfolgreich gekennzeichnet sind, ebenfalls geschützt. In diesem Fall ist der Rechteverwaltungsbesitzer (der über die Berechtigung "Rechteverwaltung Vollzugriff") dieser Dateien verfügt, der Benutzer, der den PowerShell-Befehl ausgeführt hat.

Da der Parameter PreserveFileDetails angegeben ist, bleibt das Änderungsdatum der bezeichneten Dateien unverändert.

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    :

Dieser Befehl ähnelt dem vorherigen Beispiel darin, dass er auch alle Dateien im Ordner "Projekte" und eines seiner Unterordner überprüft und Beschriftungen entsprechend den konfigurierten Bedingungen für die automatische Bezeichnung festlegt. Da der Befehl dieses Mal jedoch den Parameter Force enthält, wird auch die vorhandene Beschriftung für Dashboard.xlsxund Pricelist.xlsxersetzt.

Der Inhalt von Datasheet.pdf stimmte mit den konfigurierten Bedingungen nicht überein, und diese Datei bleibt ohne Bezeichnung.

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                 :

Mit diesem Befehl werden alle bekannten Informationstypen in Project1.docx Datei erkannt, ohne Schutz oder Bezeichnung anzuwenden.

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

Dieser Befehl ermittelt die spezifischen Informationstypen der Kreditkartennummer und der Sozialversicherungsnummer (SSN) in Project1.docx der Datei, ohne Schutz oder Bezeichnung anzuwenden.

$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

Ähnlich wie im vorherigen Beispiel ermittelt der erste Befehl die spezifischen Informationstypen der Kreditkartennummer und der Sozialversicherungsnummer (SSN) in Project1.docx der Datei, ohne Schutz oder eine Bezeichnung anzuwenden. In diesem Beispiel werden die Ergebnisse jedoch zur weiteren Verarbeitung in einer Variablen gespeichert.

Der zweite Befehl wird dann verwendet, um den Inhalt der übereinstimmenden Informationstypen anzuzeigen, die den Parameter SensitiveContents enthalten.

Mit dem letzten Befehl werden die Daten angezeigt und formatiert, die durch den ersten vertraulichen Informationstyp identifiziert werden, der in diesem Beispiel die Kreditkartendetails darstellt.

Wenn Sie das Set-FileLabel Cmdlet in einer Schleife ausführen, fügen Sie nach dem Cmdlet den folgenden Befehl hinzu:

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

Diese Befehle stellen sicher, dass der Garbage Collector ausgeführt wird und Arbeitsspeicher freigibt, der nicht mehr benötigt wird.