Export-ContentExplorerData
Este cmdlet está disponível apenas no PowerShell de Segurança e Conformidade. Para obter mais informações, consulte PowerShell de Segurança e Conformidade..
Use o cmdlet Export-ContentExplorerData para exportar detalhes do arquivo de classificação de dados em conformidade do Microsoft Purview.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
Export-ContentExplorerData
[-TagName] <String>
[-TagType] <String>
[-Aggregate]
[[-ConfidenceLevel] <String>]
[[-PageCookie] <String>]
[[-PageSize] <Int32>]
[[-SiteUrl] <String>]
[[-UserPrincipalName] <String>]
[[-Workload] <String>]
[<CommonParameters>]
Description
A saída desse cmdlet contém as seguintes informações:
- TotalCount: Contagem agregada. Se apenas os parâmetros TagName e TagType forem usados, o valor será a contagem agregada total dessa marca. Se o parâmetro Workload também for usado, o valor será a contagem agregada na carga de trabalho dessa marca. Se os parâmetros UserPrincipalName ou SiteUrl forem usados, o valor será a contagem dessa pasta específica.
- MorePagesAvailable: mostra se há mais registros restantes para exportar. O valor é True ou False.
- RecordsReturned: o número de registros retornados na consulta.
- PageCookie: usado para obter o próximo conjunto de registros quando MorePagesAvailable é verdadeiro.
- Registra dados: A saída deste cmdlet é uma matriz. Do item 1 da matriz em diante, contém dados de registros
A lista a seguir descreve as práticas recomendadas para scripts usando este cmdlet:
Recomendamos não usar um único script para exportar vários SITs/Rótulos. Em vez disso, crie um script para um SIT/Rótulo e reutilize o mesmo script para cada SIT/Rótulo em cada carga de trabalho, conforme necessário.
Ao repetir o script, certifique-se de se reconectar à sessão primeiro. O token da sessão expira após cerca de uma hora, o que pode fazer com que o cmdlet falhe. Para corrigir esse problema, reconecte-se à sessão antes de repetir o script. Se o script falhar, reinicie-o usando o cookie da última página retornado para continuar a exportação de onde parou.
Dica
Para oferecer suporte a scripts autônomos executados por um longo tempo, você pode usar a autenticação baseada em certificado (CBA).
Para usar o aplicativo do Azure, adicione o grupo de funções do Visualizador de Lista do Content Explorer à Identidade da Entidade de Serviço.
Para usar este cmdlet no PowerShell de Segurança e Conformidade, você precisa receber permissões. Para obter mais informações, confira Permissões no portal de conformidade do Microsoft Purview.
Exemplos
Exemplo 1
Export-ContentExplorerData -TagType SensitiveInformationType -TagName "Credit Card Number" -Workload EXO -UserPrincipalName erika@contoso.onmicrosoft.com
Este exemplo exporta registros para o tipo de informações confidenciais especificado da caixa de correio de Erika.
Exemplo 2
Export-ContentExplorerData -TagType SensitiveInformationType -TagName "Credit Card Number" -Workload ODB -SiteUrl https://contoso-my.sharepoint.com/personal/erika_contoso_onmicrosoft_com
Este exemplo exporta registros para o tipo de informações confidenciais especificado no site do OneDrive de Erika.
Exemplo 3
Export-ContentExplorerData -TagType SensitiveInformationType -TagName "All Full Names"
Exemplo 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
Este exemplo exporta registros para o tipo de informações confidenciais especificado para todas as cargas de trabalho.
Parâmetros
-Aggregate
Aplicável: Segurança & Conformidade
Observação: Este parâmetro está atualmente em Visualização Privada, não está disponível em todas as organizações e está sujeito a alterações.
A opção de parâmetro de agregação retorna os números agregados no nível da pasta em vez de retornar detalhes no nível do item. Não é preciso especificar um valor com essa opção.
O uso dessa opção reduz significativamente o tempo de exportação. Para baixar os itens em uma pasta, execute este cmdlet para pastas específicas.
Quando você usa essa opção com os parâmetros TagName, TagType e Workload, o comando retorna as seguintes informações:
- SharePoint e OneDrive: a lista de SiteUlrs.
- Exchange Online e Microsoft Teams: a lista de UPNs.
- A contagem de itens nas pastas carimbadas com a marca relevante.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ConfidenceLevel
Aplicável: Segurança & Conformidade
O parâmetro ConfidenceLevel especifica o nível de confiança da correspondência para os detalhes do arquivo a serem exportados. Os valores válidos são:
- low
- medium
- high
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Valores aceitos: | high, medium, low |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PageCookie
Aplicável: Segurança & Conformidade
O parâmetro PageCookie especifica se deseja obter mais dados quando o valor da propriedade MorePagesAvailable na saída do comando é True. Se você não usar o parâmetro PageSize, no máximo 100 registros serão retornados. Se você usar o parâmetro PageSize, no máximo 10.000 registros poderão ser retornados.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PageSize
Aplicável: Segurança & Conformidade
O parâmetro PageSize especifica o número máximo de registros a serem retornados em uma única consulta. A entrada válida para esse parâmetro é um número inteiro entre 1 e 10000. O valor padrão é 100.
Observação: em pastas vazias ou com poucos arquivos, esse parâmetro pode fazer com que o comando seja executado por um longo tempo enquanto tenta obter a contagem PageSize dos resultados. Para evitar esse problema, o comando retorna dados de 5 pastas ou o número de registros especificados pelo parâmetro PageSize, o que for concluído primeiro. Por exemplo, se houver 10 pastas com 1 registro cada, o comando retornará 5 registros das 5 principais pastas. Na próxima execução usando o cookie de página, ele retorna 5 registros das 5 pastas restantes, mesmo que o valor PageSize seja 10.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | 0 |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 2 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SiteUrl
Aplicável: Segurança & Conformidade
O parâmetro SiteUrl especifica a URL do site a partir da qual exportar os detalhes do arquivo.
Você usa esse parâmetro para cargas de trabalho do SharePoint e do OneDrive.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 3 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-TagName
Aplicável: Segurança & Conformidade
O parâmetro TagName especifica o nome do rótulo do qual exportar detalhes do arquivo. Se o valor contiver espaços, coloque-o entre aspas.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 4 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-TagType
Aplicável: Segurança & Conformidade
O parâmetro TagType especifica o tipo de rótulo do qual exportar os detalhes do arquivo. Os valores válidos são:
- Retenção
- SensitiveInformationType
- Confidencialidade
- TrainableClassifier
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 5 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-UserPrincipalName
Aplicável: Segurança & Conformidade
O parâmetro UserPrincipalName especifica a conta de usuário no formato UPN da qual exportar os detalhes da mensagem. Um exemplo de valor UPN é erika@contoso.onmicrosoft.com.
Você usa esse parâmetro para cargas de trabalho do Exchange e do Microsoft Teams.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 6 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Workload
Aplicável: Segurança & Conformidade
O parâmetro Workload especifica o local do qual exportar os detalhes do arquivo. Os valores válidos são:
- EXO ou Exchange
- ODB ou OneDrive
- SPO ou SharePoint
- Teams
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 7 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.