Export-ContentExplorerData

Módulo:: Exchange PowerShell

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..

Utilize o cmdlet Export-ContentExplorerData para exportar os detalhes do ficheiro de classificação de dados na 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

O resultado deste cmdlet contém as seguintes informações:

TotalCount: contagem agregada. Se forem utilizados apenas os parâmetros TagName e TagType, o valor é a contagem total agregada para essa etiqueta. Se o parâmetro Carga de Trabalho também for utilizado, o valor é a contagem agregada na carga de trabalho dessa etiqueta. Se forem utilizados os parâmetros UserPrincipalName ou SiteUrl, o valor é a contagem para essa pasta específica.
Mais Páginas Disponíveis: mostra se ainda existem mais registos para exportar. O valor é Verdadeiro ou Falso.
RecordsReturned: o número de registos devolvidos na consulta.
PageCookie: utilizado para obter o próximo conjunto de registos quando Mais Páginas Disponíveis é Verdadeiro.
Dados de registos: a saída deste cmdlet é uma matriz. A partir do item de matriz 1, contém dados de registos

A lista seguinte descreve as melhores práticas para scripts com este cmdlet:

Recomendamos que não utilize um único script para exportar vários SITs/Etiquetas. Em vez disso, crie um script para um SIT/Label e, em seguida, volte a utilizar o mesmo script para cada SIT/Label em cada carga de trabalho, conforme necessário.
Ao repetir o script, certifique-se de que volta a ligar à 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 este problema, volte a ligar à sessão antes de repetir o script. Se o script falhar, reinicie-o utilizando o cookie da última página devolvido para continuar a exportação a partir de onde ficou.

Dica

Para suportar scripts autónomos que são executados durante muito tempo, pode utilizar a autenticação baseada em certificados (CBA).

Para utilizar a aplicação Azure, adicione o grupo de funções Visualizador de Lista Explorer Conteúdo à Identidade do Principal 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 registos para o tipo de informações confidenciais especificado na caixa de correio da 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 registos para o tipo de informações confidenciais especificado no site do OneDrive da 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 registos para o tipo de informações confidenciais especificado para todas as cargas de trabalho.

Parâmetros

-Aggregate

Aplicável: Conformidade do & de Segurança

Nota: Este parâmetro está atualmente em Pré-visualização Privada, não está disponível em todas as organizações e está sujeito a alterações.

O parâmetro Agregar devolve os números agregados ao nível da pasta em vez de devolver detalhes ao nível do item. Não é preciso especificar um valor com essa opção.

A utilização deste comutador reduz significativamente o tempo de exportação. Para transferir os itens numa pasta, execute este cmdlet para pastas específicas.

Quando utiliza este comutador com os parâmetros TagName, TagType e Workload, o comando devolve 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 etiqueta 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: Conformidade do & de Segurança

O parâmetro ConfidenceLevel especifica o nível de confiança da correspondência para os detalhes do ficheiro a exportar. 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: Conformidade do & de Segurança

O parâmetro PageCookie especifica se pretende obter mais dados quando o valor da propriedade MorePagesAvailable na saída do comando é Verdadeiro. Se não utilizar o parâmetro PageSize, é devolvido um máximo de 100 registos. Se utilizar o parâmetro PageSize, pode ser devolvido um máximo de 10000 registos.

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: Conformidade do & de Segurança

O parâmetro PageSize especifica o número máximo de registos a devolver numa única consulta. A entrada válida para este parâmetro é um número inteiro entre 1 e 10000. O valor padrão é 100.

Nota: em pastas vazias ou pastas com poucos ficheiros, este parâmetro pode fazer com que o comando seja executado durante muito tempo, uma vez que tenta obter a contagem pageSize dos resultados. Para evitar este problema, o comando devolve dados de 5 pastas ou o número de registos especificados pelo parâmetro PageSize, o que for concluído primeiro. Por exemplo, se existirem 10 pastas com 1 registo cada, o comando devolve 5 registos das 5 pastas principais. Na próxima execução através do cookie de página, devolve 5 registos 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: Conformidade do & de Segurança

O parâmetro SiteUrl especifica o URL do site para exportar os detalhes do ficheiro.

Utilize este 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: Conformidade do & de Segurança

O parâmetro TagName especifica o nome da etiqueta para exportar os detalhes do ficheiro. 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: Conformidade do & de Segurança

O parâmetro TagType especifica o tipo de etiqueta para exportar os detalhes do ficheiro. 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: Conformidade do & de Segurança

O parâmetro UserPrincipalName especifica a conta de utilizador no formato UPN para exportar os detalhes da mensagem. Um valor UPN de exemplo é erika@contoso.onmicrosoft.com.

Utilize este 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: Conformidade do & de Segurança

O parâmetro Carga de Trabalho especifica a localização para exportar os detalhes do ficheiro. 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 suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.

Comentários

Esta página foi útil?

Compartilhar via

Export-ContentExplorerData

Sintaxe

Default (Default)

Description

Exemplos

Exemplo 1

Exemplo 2

Exemplo 3

Exemplo 4

Parâmetros

-Aggregate

Propriedades do parâmetro

Conjuntos de parâmetros

-ConfidenceLevel

Propriedades do parâmetro

Conjuntos de parâmetros

-PageCookie

Propriedades do parâmetro

Conjuntos de parâmetros

-PageSize

Propriedades do parâmetro

Conjuntos de parâmetros

-SiteUrl

Propriedades do parâmetro

Conjuntos de parâmetros

-TagName

Propriedades do parâmetro

Conjuntos de parâmetros

-TagType

Propriedades do parâmetro

Conjuntos de parâmetros

-UserPrincipalName

Propriedades do parâmetro

Conjuntos de parâmetros

-Workload

Propriedades do parâmetro

Conjuntos de parâmetros

CommonParameters

Comentários