Condividi tramite

Get-FileStatus

  • Riferimento
Modulo:
PurviewInformationProtection

Ottiene l'etichetta e le informazioni di protezione Microsoft Purview Information Protection per un file o file specificato.

Sintassi

Get-FileStatus
   [-Path] <String[]>
   [<CommonParameters>]

Descrizione

Il cmdlet Get-FileStatus restituisce lo stato di un file specificato o di tutti i file in un percorso specificato. Questo stato include se il file ha un'etichetta e, in caso affermativo, il nome dell'etichetta, chi lo ha applicato, come è stato applicato e quando.

Se i file vengono archiviati in SharePoint Online, usare invece il cmdlet Get-FileSensitivityLabelInfo dal modulo SharePointOnlinePowerShell .

Lo stato restituito nel cmdlet Get-FileStatus include anche se il file è protetto da Rights Management e, in caso affermativo, quale modello di Rights Management è stato usato per applicare questa protezione. Se il file è stato protetto con autorizzazioni personalizzate (un criterio di diritti ad hoc) anziché un modello, viene visualizzato "Accesso con restrizioni" anziché il nome del modello. Inoltre, viene visualizzato il proprietario di Rights Management e l'autorità emittente di Rights Management e quando il file è stato protetto.

Questo cmdlet restituisce le informazioni sull'etichetta solo dal tenant.

Si noti che i file protetti da password restituiscono sempre lo stato di protezione False.

È possibile eseguire questo cmdlet in modo non interattivo.

Esempio

Esempio 1: Ottenere l'etichetta e lo stato di protezione di un singolo file

PS C:\> Get-FileStatus -Path \\Finance\Projects\Project.docx

FileName        : \\Finance\Projects\Project.docx
IsLabeled       : True
MainLabelId     : 074e257c-1234-1234-1234-34a182080e71
MainLabelName   : Confidential
SubLabelId      : d9f23ae3-1234-1234-1234-f515f824c57b
SubLabelName    : Finance group
LabelingMethod  : Privileged
LabelDate       : 12/12/2016 12:24:36 PM
IsRMSProtected  : True
RMSTemplateId   : e6ee2481-1234-1234-1234-f744eacd53b0
RMSTemplateName : Contoso - Confidential Finance
RMSOwner        : John@Contoso.com
RMSIssuer       : John@Contoso.com
ContentId       : 4ca757d2-83bf-4ec3-b93b-c7fe9433bf33

Questo comando fornisce informazioni su un file etichettato come "Confidential \ Finance group", ovvero un'etichetta configurata per il tenant. Questo file è stato etichettato manualmente da John ed è protetto anche usando il modello Rights Management, "Contoso - Confidential Finance".

Esempio 2: Ottenere l'etichetta e lo stato di protezione per tutti i file in una cartella ed esportare i risultati in un file CSV

PS C:\> Get-FileStatus -Path \\Finance\Projects\ | Export-Csv C:\Reports\Report.csv

Questo comando ottiene le informazioni sull'etichetta e sulla protezione di tutti i file nel server Finance, nella cartella Projects e in una delle relative sottocartelle. I risultati vengono esportati nel file denominato Report.csv in modo che possano essere ricercati e ordinati più facilmente. Se esiste un report precedente in C:\Reports\Report.csv, verrà sovrascritto.

Esempio 3: Elencare i file con etichetta "Riservato" ed esportare i risultati in un file CSV

PS C:\> Get-FileStatus -Path \\Finance\Projects\ | Where-Object {$_.MainLabelName -eq 'Confidential'} | Export-Csv C:\Reports\Report.csv

Questo comando ottiene l'etichetta e le informazioni di protezione solo per i file con etichetta "Riservato" (indipendentemente dalla relativa etichetta secondaria) nel server Finance, nella cartella Projects e in una delle relative sottocartelle. I risultati vengono esportati nel file denominato Report.csv in modo che possano essere ricercati e ordinati più facilmente. Se esiste un report precedente in C:\Reports\Report.csv, verrà sovrascritto.

Esempio 4: Numero di file con un'etichetta "Riservato"

PS C:\> (Get-FileStatus -Path C:\Projects\ | Where-Object {$_.MainLabelName -eq 'Confidential'}).Count

5

Questo comando fornisce il numero di file con l'etichetta "Riservato" presente nella cartella C:\Projects e in una delle relative sottocartelle. In questo esempio vengono trovati 5 file.

Parametri

-Path

Specifica un percorso locale, un percorso di rete o un URL di SharePoint Server per i file per cui si desidera ottenere le informazioni sull'etichetta e sulla protezione. I caratteri jolly non sono supportati.

Per i percorsi di SharePoint sono supportati gli elementi seguenti:

  • SharePoint Server 2019
  • SharePoint Server 2016
  • SharePoint Server 2013

Ad esempio:

I percorsi possono includere spazi quando si racchiude il valore del percorso tra virgolette.

Tipo:String[]
Alias:FullName, FileName
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

System.String[]

Output

Microsoft.InformationProtection.Powershell.AIP.Results.GetAIPFileStatusResult