Set-AIPFileLabel

Syntax

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

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

Set-AIPFileLabel
   [-JustificationMessage <String>]
   [-RemoveLabel]
   [-PreserveFileDetails]
   [-Path] <String[]>
   [<CommonParameters>]

Set-AIPFileLabel
   [-JustificationMessage <String>]
   [-RemoveLabel]
   [-RemoveProtection]
   [-PreserveFileDetails]
   [-Path] <String[]>
   [<CommonParameters>]

Set-AIPFileLabel
   [-JustificationMessage <String>]
   [-RemoveProtection]
   [-PreserveFileDetails]
   [-Path] <String[]>
   [<CommonParameters>]

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

Beschreibung

Für den AIP-Client für einheitliche Bezeichnungen legt das Cmdlet Set-AIPFileLabel eine Vertraulichkeitsbezeichnung für eine oder mehrere Dateien fest oder entfernt sie. Diese Aktion kann automatisch Schutz anwenden, wenn Bezeichnungen für die Anwendung der Verschlüsselung konfiguriert sind.

Darüber hinaus können Sie dieses Cmdlet verwenden, um benutzerdefinierte Berechtigungen anzuwenden, wenn sie als Ad-hoc-Schutzrichtlinienobjekt mit dem Cmdlet New-AIPCustomPermissions erstellt werden.

Wenn der Befehl erfolgreich ausgeführt wird, kann jede vorhandene Bezeichnung oder ein vorhandener Schutz ersetzt werden.

Sie können dieses Cmdlet nicht interaktiv ausführen. Weitere Informationen finden Sie im Unified Labeling Client Administratorhandbuch.

Beispiele

Beispiel 1: Anwenden der Bezeichnung "Allgemein" auf alle Dateien, die derzeit keine Bezeichnung haben

PS C:\> Get-AIPFileStatus -Path \\Finance\Projects\ | where {$_.IsLabeled -eq $False} | Set-AIPFileLabel -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

Dieser Befehl identifiziert zunächst alle Dateien, die nicht mit dem Cmdlet Get-AIPFileStatus bezeichnet werden. Anschließend werden diese Dateien beschriftet, indem die Bezeichnung "Allgemein" anhand ihrer ID angegeben wird.

Beispiel 2: Anwenden der Bezeichnung "Allgemein" auf .docx Dateien, die nicht beschriftet sind

PS C:\> Get-ChildItem C:\Projects\*.docx -File -Recurse | Get-AIPFileStatus | where {$_.IsLabeled -eq $False} | Set-AIPFileLabel -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 Ordner C:\Projects (und die zugehörigen Unterordner) mithilfe von Get-Child-Item und sucht dann aus diesen Dateien die Dateien, die nicht mit dem Cmdlet Get-AIPFileStatus bezeichnet sind. Die resultierenden Dateien werden dann beschriftet, indem die Bezeichnung "Allgemein" anhand ihrer ID angegeben wird.

Beispiel 3: (Nur Client für einheitliche Bezeichnungen) Anwenden der Bezeichnung "Allgemein" auf alle Dateien in einem Ordner und einem seiner Unterordner

PS C:\> Set-AIPFileLabel -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 die Bezeichnung "Allgemein" für alle Dateien im Ordner "Projekte " und in jedem seiner Unterordner festgelegt.

Wenn die Bezeichnung Allgemein für die Anwendung der Verschlüsselung konfiguriert ist, werden auch die Dateien verschlüsselt, die mit diesem Befehl erfolgreich beschriftet wurden. In diesem Fall handelt es sich beim Rights Management-Besitzer (der über die Berechtigung des Rights Management-Vollzugriffs verfügt) dieser Dateien um den Benutzer, der den PowerShell-Befehl ausgeführt hat.

In diesem Beispiel wurde eine Datei nicht beschriftet (ü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 höheren Schutz nicht versehentlich mit einer niedrigeren Klassifizierungsbezeichnung überschrieben oder der Schutz entfernt wird.

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

Beispiel 4: (Nur Client für einheitliche Bezeichnungen) Anwenden der Bezeichnung "Allgemein" auf eine einzelne Datei, die eine Begründung erfordert

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

Dieser Befehl legt die Bezeichnung "Allgemein" für eine Datei fest, die bereits mit einer höheren Klassifizierungsbezeichnung gekennzeichnet ist. Die Office 365 Klassifizierungsbezeichnungsrichtlinie ist so konfiguriert, dass eine Begründung für das Entfernen einer Bezeichnung oder das Herabstufen der Klassifizierung erforderlich ist. Da der Befehl eine Begründungsmeldung enthält, wurde die neue Bezeichnung erfolgreich angewendet.

Beispiel 5: (Nur Client für einheitliche Bezeichnungen) Entfernen einer Bezeichnung aus einer Datei

PS C:\> Set-AIPFileLabel C:\Projects\Analysis.docx -RemoveLabel -JustificationMessage 'The previous label no longer applies'

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

Dieser Befehl entfernt die vorhandene Bezeichnung aus der Datei mit dem Namen C:\Projects\Analysis.docxund gibt eine obligatorische Begründungsmeldung an.

Diese Begründungsmethode ist erforderlich, da die entsprechende Richtlinieneinstellung für Office 365 Klassifizierungsbezeichnungen aktiviert ist, um eine Begründung für das Entfernen einer Bezeichnung oder das Herabstufen der Klassifizierung zu erfordern.

Beispiel 6: (Nur Client für einheitliche Bezeichnungen) Schützen einer Datei mit benutzerdefinierten Berechtigungen

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

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

Mit dem ersten Befehl wird ein Ad-hoc-Schutzrichtlinienobjekt erstellt, das Benutzern aus verschiedenen Organisationen Nutzungsrechte aus dem Prüfer-Berechtigungen gewährt und außerdem ein Ablaufdatum anwendet.

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

Beispiel 7: (Nur Client für einheitliche Bezeichnungen) Anwenden einer Bezeichnung und benutzerdefinierter Berechtigungen auf die Datei

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

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

Mit dem ersten Befehl wird ein Ad-hoc-Schutzrichtlinienobjekt erstellt, das Benutzern aus verschiedenen Organisationen Nutzungsrechte aus dem Prüfer-Berechtigungen gewährt und außerdem ein Ablaufdatum anwendet.

Der zweite Befehl wendet eine Bezeichnung auf eine einzelne Datei namens 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.

Beispiel 8: (Nur Client für einheitliche Bezeichnungen) Entfernen des Schutzes für eine Datei

PS C:\> Set-AIPFileLabel C:\Projects\Analysis.docx -RemoveProtection

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

Dieser Befehl entfernt den Schutz einer einzelnen Datei mit dem Namen Analysis.docx.

Beispiel 9: (Nur Client für einheitliche Bezeichnungen) Entfernen des Schutzes und einer Bezeichnung aus einer Datei

PS C:\> Set-AIPFileLabel C:\Projects\Analysis.docx -RemoveProtection -RemoveLabel -JustificationMessage 'The previous label no longer applies'

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

Dieser Befehl entfernt die Bezeichnung und den benutzerdefinierten Schutz aus einer einzelnen Datei namens Analysis.docx. Da die Richtlinie so konfiguriert ist, dass eine Begründung zum Entfernen einer Bezeichnung erforderlich ist, wird auch der Begründungsgrund angegeben, sodass der Befehl abgeschlossen werden kann, ohne den Benutzer zur Angabe des Grunds aufzufordern.

Parameter

-CustomPermissions

-EnableTracking

-JustificationMessage

-LabelId

-Path

-PreserveFileDetails

-RemoveLabel

-RemoveProtection

Eingaben

System.String[]

Ausgaben

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileResult

Ähnliche Themen

• Get-AIPFileStatus
• New-AIPCustomPermissions
• Set-AIPFileClassification
• Set-AIPAuthentication