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 el 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
El resultado 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 total agregado de esa etiqueta. Si también se usa el parámetro Workload, el valor es el recuento agregado en 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 por exportar. El valor será Verdadero o Falso.
- RecordsReturned: Número de registros devueltos en la consulta.
- PageCookie: se usa para obtener el siguiente conjunto de registros cuando MorePagesAvailable es True.
- Registra datos: El resultado de este cmdlet es una matriz. A partir del elemento de matriz 1 en adelante, contiene datos de registros
En la lista siguiente se describen los procedimientos recomendados para los 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 un SIT o etiqueta y, a continuación, vuelva a usar el mismo script para cada SIT o 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 última cookie de página devuelta para continuar la exportación desde donde la 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 rol "Visor de lista de 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 registros para el 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 para el 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: Seguridad & cumplimiento
Nota: Este parámetro se encuentra 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 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 utiliza 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.
- El recuento de elementos en las carpetas marcadas 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 |
| Mandatory: | 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: Seguridad & cumplimiento
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:
- de impacto
- medium
- de alta
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 |
| Mandatory: | 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: Seguridad & cumplimiento
El parámetro PageCookie especifica si se obtendrán más datos cuando el valor de la propiedad MorePagesAvailable en la salida del comando sea 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 10 000 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 |
| Mandatory: | 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: Seguridad & cumplimiento
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 con pocos archivos, este parámetro puede hacer que el comando se ejecute durante mucho tiempo mientras intenta obtener el recuento tamaño de página 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 ocurra 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 paginación, 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 |
| Mandatory: | 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: Seguridad & cumplimiento
El parámetro SiteUrl especifica la dirección URL del sitio desde donde exportar los detalles del archivo.
Este parámetro se usa 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 |
| Mandatory: | 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: Seguridad & cumplimiento
El parámetro TagName especifica el nombre de la etiqueta desde la que se exportarán 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 |
| Mandatory: | 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: Seguridad & cumplimiento
El parámetro TagType especifica el tipo de etiqueta desde el que se exportarán 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 |
| Mandatory: | 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: Seguridad & cumplimiento
El parámetro UserPrincipalName especifica la cuenta de usuario en formato UPN desde donde exportar los detalles del mensaje. Un valor UPN de ejemplo es erika@contoso.onmicrosoft.com.
Este parámetro se usa para 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 |
| Mandatory: | 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: Seguridad & cumplimiento
El parámetro Workload especifica la ubicación desde la que se exportarán 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 |
| Mandatory: | 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.