Get-RMSFileStatus

Referenz

Modul:: AzureInformationProtection

Ruft den RMS-Schutzstatus einer angegebenen Datei ab.

Syntax

Get-RMSFileStatus
   -File <String>
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-RMSFileStatus gibt den Schutzstatus (unabhängig davon, ob die Datei durch die Rechteverwaltung geschützt ist) einer angegebenen Datei zurück.

Eine geschützte Datei verfügt über den Status "Protected (Native) oder Protected (Generic)", und eine nicht geschützte Datei hat den Status " Nicht geschützt".

Beachten Sie, dass eine systemeigene geschützte Containerdatei, z. B. eine Outlook-Datendatei (). PST) gibt immer den Schutzstatus von "Unprotected" zurück.

Beispiele

Beispiel 1: Auflisten des Schutzstatus für eine angegebene Datei

PS C:\>Get-RMSFileStatus -File "C:\Test.docx"
FileName             Status
--------             ------
C:\Test.docx         Unprotected

Dieser Befehl listet den Rights Management-Schutzstatus für die angegebene Datei C:\Test.docxauf.

Da eine Datei mit einer .docx Dateinamenerweiterung nativen Schutz unterstützt, gibt der Status "Protected (Native)" oder "Unprotected" zurück.

Beispiel 2: Auflisten des Schutzstatus für alle Dateien in einem Ordner und unterordnern

PS C:\>foreach ($file in (Get-ChildItem -Path C:\Documents -Recurse -Force | where {!$_.PSIsContainer})) {Get-RMSFileStatus -f $file.PSPath}

Obwohl das Cmdlet Get-RMSFileStatus gleichzeitig für eine Datei funktioniert, können Sie den folgenden Windows PowerShell Befehl verwenden, um den Status aller Dateien in einem Ordner (in unserem Beispiel "C:\Documents") und dessen Unterordner abzurufen.

Derselbe Befehl kann mit einem UNC-Pfad anstelle eines Laufwerks und Pfads verwendet werden.

Beispiel 3: Erstellen einer .CSV Datei mit dem Schutzstatus für alle Dateien in einem Ordner und unterordnern

PS C:\>$(foreach ($file in (Get-ChildItem -Path C:\Documents\ -Recurse -Force | where {!$_.PSIsContainer})) {Get-RMSFileStatus -f $file.PSPath}) | Export-Csv -Path C:\Temp\ProtectedFilesList.csv -Encoding ascii -NoTypeInformation

Sie können das vorherige Beispiel weiter erweitern, indem Sie die Ergebnisse in eine .CSV Datei ausgeben, sodass Sie die Informationen sortieren und sortieren können.

In diesem Beispiel wird die .CSV Datei ProtectedFilesList.csv benannt und im Ordner "C:\Temp " gespeichert. Wenn die Datei bereits vorhanden ist, wird sie überschrieben.

Parameter

-File

Gibt den vollqualifizierten Pfad zur Datei an, um zu überprüfen, ob er durch rechteverwaltung geschützt ist.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False