Get-AIPFileStatus

  • Referencia
Módulo:
AzureInformationProtection

Obtiene la información de protección y etiqueta de Azure Information Protection para un archivo o archivos especificados.

Sintaxis

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

Description

El cmdlet Get-AIPFileStatus devuelve el estado de Azure Information Protection de un archivo especificado o de todos los archivos de una ruta de acceso especificada. Este estado incluye si el archivo tiene una etiqueta y, si es así, el nombre de la etiqueta, quién lo aplicó, cómo se aplicó y cuándo.

Si los archivos se almacenan en SharePoint Online, use el cmdlet Get-FileSensitivityLabelInfo del módulo sharePointOnlinePowerShell en su lugar.

El estado devuelto en el cmdlet Get-AIPFileStatus también incluye si el archivo está protegido por Rights Management y, si es así, qué plantilla de Rights Management se usó para aplicar esta protección. Si el archivo estaba protegido con permisos personalizados (una directiva de derechos ad hoc) en lugar de una plantilla, se muestra "Acceso restringido" en lugar del nombre de la plantilla. Además, se muestra el propietario de Rights Management y el emisor de Rights Management , y cuándo se protegió el archivo.

Este cmdlet solo devuelve información de etiqueta de su propio inquilino.

Tenga en cuenta que los archivos protegidos con contraseña siempre devuelven el estado de protección false.

Puede ejecutar este cmdlet de forma no interactiva. Para obtener más información, consulte la guía de administración del cliente de etiquetado unificado.

Ejemplos

Ejemplo 1: Obtener la etiqueta y el estado de protección de un único archivo

PS C:\> Get-AIPFileStatus -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

Este comando proporciona información sobre un archivo etiquetado como "Confidencial \ Grupo Finance", que es una etiqueta que está configurada para el inquilino. John etiquetó manualmente este archivo y también está protegido mediante la plantilla Rights Management, "Contoso - Confidential Finance".

Ejemplo 2: Obtener la etiqueta y el estado de protección de todos los archivos de una carpeta y exportar los resultados a un archivo CSV

PS C:\> Get-AIPFileStatus -Path \\Finance\Projects\ | Export-Csv C:\Reports\AIP-status.csv

Este comando obtiene la información de etiqueta y protección de todos los archivos del servidor Finance, en la carpeta Projects y en cualquiera de sus subcarpetas. Los resultados se exportan al archivo denominado AIP-status.csv para que se puedan buscar y ordenar más fácilmente. Si existe un informe anterior en C:\Reports\Report.csv, se sobrescribirá.

Ejemplo 3: Enumerar los archivos etiquetados como "Confidencial" y exportar los resultados a un archivo CSV

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

Este comando obtiene la información de etiqueta y protección de solo los archivos con la etiqueta "Confidencial" (independientemente de su subetiqueta) en el servidor Finance, en la carpeta Projects y en cualquiera de sus subcarpetas. Los resultados se exportan al archivo denominado AIP-status.csv para que se puedan buscar y ordenar más fácilmente. Si existe un informe anterior en C:\Reports\Report.csv, se sobrescribirá.

Ejemplo 4: Recuento de archivos con una etiqueta "Confidencial"

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

5

Este comando proporciona el número de archivos con la etiqueta "Confidencial" que se encuentran en la carpeta C:\Projects y cualquiera de sus subcarpetas. En este ejemplo, se encuentran 5 archivos.

Parámetros

-Path

Especifica una ruta de acceso local, una ruta de acceso de red o una dirección URL de SharePoint Server a los archivos para los que desea obtener la información de etiqueta y protección. No se admiten caracteres comodín.

En el caso de las rutas de acceso de SharePoint, se admite lo siguiente:

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

Por ejemplo:

Las rutas de acceso pueden incluir espacios al incluir el valor de ruta de acceso con comillas.

Tipo:String[]
Alias:FullName, FileName
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Entradas

System.String[]

Salidas

Microsoft.InformationProtection.Powershell.AIP.Results.GetAIPFileStatusResult