Export-ContentExplorerData
Este cmdlet está disponible solo en Security & Compliance PowerShell. Para obtener más información, consulte Security & Compliance PowerShell.
Use el cmdlet Export-ContentExplorerData para exportar los detalles del archivo de clasificación de datos en cumplimiento de Microsoft Purview.
Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.
Sintaxis
Default (valor predeterminado)
Export-ContentExplorerData
[-TagName] <String>
[-TagType] <String>
[-Aggregate]
[[-ConfidenceLevel] <String>]
[[-PageCookie] <String>]
[[-PageSize] <Int32>]
[[-SiteUrl] <String>]
[[-UserPrincipalName] <String>]
[[-Workload] <String>]
[<CommonParameters>]
Description
La salida de este cmdlet contiene la siguiente información:
- TotalCount: recuento agregado. Si solo se usan los parámetros TagName y TagType, el valor es el recuento agregado total de esa etiqueta. Si también se usa el parámetro Workload, el valor es el recuento agregado de la carga de trabajo para esa etiqueta. Si se usan los parámetros UserPrincipalName o SiteUrl, el valor es el recuento de esa carpeta específica.
- MorePagesAvailable: muestra si quedan más registros para exportar. El valor es True o False.
- RecordsReturned: número de registros devueltos en la consulta.
- PageCookie: se usa para obtener el siguiente conjunto de registros cuando MorePagesAvailable es True.
- Datos de registros: la salida de este cmdlet es una matriz. Desde el elemento de matriz 1 en adelante, contiene datos de registros
En la lista siguiente se describen los procedimientos recomendados para scripts que usan este cmdlet:
Se recomienda no usar un solo script para exportar varios SIT o etiquetas. En su lugar, cree un script para una sit/etiqueta y, a continuación, vuelva a usar el mismo script para cada SIT/Etiqueta en cada carga de trabajo según sea necesario.
Al reintentar el script, asegúrese de volver a conectarse primero a la sesión. El token de la sesión expira después de aproximadamente una hora, lo que puede provocar un error en el cmdlet. Para corregir este problema, vuelva a conectarse a la sesión antes de volver a intentar el script. Si se produce un error en el script, reinícielo con la cookie de última página devuelta para continuar con la exportación desde donde lo dejó.
Sugerencia
Para admitir scripts desatendidos que se ejecutan durante mucho tiempo, puede usar la autenticación basada en certificados (CBA).
Para usar la aplicación Azure, agregue el grupo de roles visor de lista del Explorador de contenido a la identidad de entidad de servicio.
Para usar este cmdlet en Security & Compliance PowerShell, debe tener asignados permisos. Para obtener más información vea Permisos en el portal de cumplimiento de Microsoft Purview.
Ejemplos
Ejemplo 1
Export-ContentExplorerData -TagType SensitiveInformationType -TagName "Credit Card Number" -Workload EXO -UserPrincipalName erika@contoso.onmicrosoft.com
En este ejemplo se exportan los registros del tipo de información confidencial especificado desde el buzón de Erika.
Ejemplo 2
Export-ContentExplorerData -TagType SensitiveInformationType -TagName "Credit Card Number" -Workload ODB -SiteUrl https://contoso-my.sharepoint.com/personal/erika_contoso_onmicrosoft_com
En este ejemplo se exportan registros del tipo de información confidencial especificado en el sitio de OneDrive de Erika.
Ejemplo 3
Export-ContentExplorerData -TagType SensitiveInformationType -TagName "All Full Names"
Ejemplo 4
$Report = @()
$Content = Export-ContentExplorerData -TagType SensitiveInformationType -TagName "All Full Names" -ConfidenceLevel high -Workload sharepoint -PageSize 1000
[string]$PageCookie = $Content.PageCookie
$Report += $Content[1..$Content[0].RecordsReturned]
while($PageCookie -notlike " * ")
{
$NewContent = Export-ContentExplorerData -TagType SensitiveInformationType -TagName "All Full Names" -ConfidenceLevel high -Workload sharepoint -PageCookie $PageCookie -PageSize 1000
[string]$PageCookie = $NewContent.PageCookie
$Report += $NewContent[1..$NewContent[0].RecordsReturned]
}
$Report | Export-CSV C:\temp\CE_Report-AFN_high.csv -Encoding UTF8 -NoTypeInformation
En este ejemplo se exportan registros del tipo de información confidencial especificado para todas las cargas de trabajo.
Parámetros
-Aggregate
Aplicable: Cumplimiento de & de seguridad
Nota: Este parámetro está actualmente en versión preliminar privada, no está disponible en todas las organizaciones y está sujeto a cambios.
El modificador de parámetro Aggregate devuelve los números agregados de nivel de carpeta en lugar de devolver los detalles en el nivel de elemento. No es necesario especificar un valor con este modificador.
El uso de este modificador reduce significativamente el tiempo de exportación. Para descargar los elementos de una carpeta, ejecute este cmdlet para carpetas específicas.
Cuando se usa este modificador con los parámetros TagName, TagType y Workload, el comando devuelve la siguiente información:
- SharePoint y OneDrive: la lista de SiteUlrs.
- Exchange Online y Microsoft Teams: la lista de UPN.
- Recuento de elementos de las carpetas marcados con la etiqueta correspondiente.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ConfidenceLevel
Aplicable: Cumplimiento de & de seguridad
El parámetro ConfidenceLevel especifica el nivel de confianza de la coincidencia para los detalles del archivo que se van a exportar. Los valores admitidos son:
- Bajo
- medium
- Alto
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Valores aceptados: | high, medium, low |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 0 |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-PageCookie
Aplicable: Cumplimiento de & de seguridad
El parámetro PageCookie especifica si se obtienen más datos cuando el valor de la propiedad MorePagesAvailable en la salida del comando es True. Si no usa el parámetro PageSize, se devuelve un máximo de 100 registros. Si usa el parámetro PageSize, se puede devolver un máximo de 10000 registros.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 1 |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-PageSize
Aplicable: Cumplimiento de & de seguridad
El parámetro PageSize especifica el número máximo de registros que se devolverán en una sola consulta. La entrada válida para este parámetro es un entero entre 1 y 10000. El valor predeterminado es 100.
Nota: En carpetas vacías o carpetas con pocos archivos, este parámetro puede hacer que el comando se ejecute durante mucho tiempo mientras intenta obtener el recuento PageSize de los resultados. Para evitar este problema, el comando devuelve datos de 5 carpetas o el número de registros especificado por el parámetro PageSize, lo que se complete primero. Por ejemplo, si hay 10 carpetas con 1 registro cada una, el comando devuelve 5 registros de las 5 carpetas principales. En la siguiente ejecución mediante la cookie de página, devuelve 5 registros de las 5 carpetas restantes, incluso si el valor de PageSize es 10.
Propiedades de parámetro
| Tipo: | Int32 |
| Valor predeterminado: | 0 |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 2 |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-SiteUrl
Aplicable: Cumplimiento de & de seguridad
El parámetro SiteUrl especifica la dirección URL del sitio desde la que exportar los detalles del archivo.
Use este parámetro para cargas de trabajo de SharePoint y OneDrive.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 3 |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-TagName
Aplicable: Cumplimiento de & de seguridad
El parámetro TagName especifica el nombre de la etiqueta desde la que exportar los detalles del archivo. Si el valor contiene espacios, escríbalo entre comillas.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 4 |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-TagType
Aplicable: Cumplimiento de & de seguridad
El parámetro TagType especifica el tipo de etiqueta desde la que exportar los detalles del archivo. Los valores admitidos son:
- Retención
- SensitiveInformationType
- Sensibilidad
- TrainableClassifier
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 5 |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-UserPrincipalName
Aplicable: Cumplimiento de & de seguridad
El parámetro UserPrincipalName especifica la cuenta de usuario en formato UPN desde la que exportar los detalles del mensaje. Un valor UPN de ejemplo es erika@contoso.onmicrosoft.com.
Este parámetro se usa para las cargas de trabajo de Exchange y Microsoft Teams.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 6 |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Workload
Aplicable: Cumplimiento de & de seguridad
El parámetro Workload especifica la ubicación desde la que exportar los detalles del archivo. Los valores admitidos son:
- EXO o Exchange
- ODB o OneDrive
- SPO o SharePoint
- Teams
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 7 |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.