Export-ContentExplorerData

Modulo:: Exchange PowerShell

Questo cmdlet è disponibile solo in PowerShell per sicurezza e conformità. Per altre informazioni, vedere PowerShell per sicurezza e conformità.

Usare il cmdlet Export-ContentExplorerData per esportare i dettagli del file di classificazione dei dati nella conformità a Microsoft Purview.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

Default (Impostazione predefinita)

Export-ContentExplorerData
    [-TagName] <String>
    [-TagType] <String>
    [-Aggregate]
    [[-ConfidenceLevel] <String>]
    [[-PageCookie] <String>]
    [[-PageSize] <Int32>]
    [[-SiteUrl] <String>]
    [[-UserPrincipalName] <String>]
    [[-Workload] <String>]
    [<CommonParameters>]

Descrizione

L'output di questo cmdlet contiene le informazioni seguenti:

TotalCount: conteggio aggregazione. Se vengono usati solo i parametri TagName e TagType, il valore è il numero totale di aggregazioni per tale tag. Se viene usato anche il parametro Workload, il valore è il conteggio di aggregazione nel carico di lavoro per tale tag. Se vengono usati i parametri UserPrincipalName o SiteUrl, il valore è il conteggio per la cartella specifica.
MorePagesAvailable: indica se sono rimasti altri record da esportare. Il valore è True o False.
RecordsReturned: numero di record restituiti nella query.
PageCookie: usato per ottenere il set di record successivo quando MorePagesAvailable è True.
Registra i dati: l'output di questo cmdlet è una matrice. Dall'elemento della matrice 1 in poi, contiene i dati dei record

L'elenco seguente descrive le procedure consigliate per gli script che usano questo cmdlet:

È consigliabile non usare un singolo script per esportare più SIT/etichette. Creare invece uno script per un'etichetta/SIT e quindi riutiliare lo stesso script per ogni sit/etichetta in ogni carico di lavoro in base alle esigenze.
Quando si ritenta lo script, assicurarsi di riconnettersi prima alla sessione. Il token della sessione scade dopo circa un'ora, il che può causare l'esito negativo del cmdlet. Per risolvere questo problema, riconnettersi alla sessione prima di ripetere lo script. Se lo script ha esito negativo, riavviarlo usando l'ultimo cookie di pagina restituito per continuare l'esportazione da dove è stato interrotto.

Consiglio

Per supportare script automatici eseguiti per un lungo periodo di tempo, è possibile usare l'autenticazione basata su certificati.

Per usare l'app Azure, aggiungere il gruppo di ruoli visualizzatore elenco esplora contenuto all'identità dell'entità servizio.

Per usare questo cmdlet in PowerShell per sicurezza e conformità, è necessario disporre delle autorizzazioni. Per ulteriori informazioni, vedere Autorizzazioni nel portale di conformità di Microsoft Purview.

Esempio

Esempio 1

Export-ContentExplorerData -TagType SensitiveInformationType -TagName "Credit Card Number" -Workload EXO -UserPrincipalName erika@contoso.onmicrosoft.com

In questo esempio vengono esportati i record per il tipo di informazioni sensibili specificato dalla cassetta postale di Erika.

Esempio 2

Export-ContentExplorerData -TagType SensitiveInformationType -TagName "Credit Card Number" -Workload ODB -SiteUrl https://contoso-my.sharepoint.com/personal/erika_contoso_onmicrosoft_com

In questo esempio vengono esportati i record per il tipo di informazioni sensibili specificato nel sito OneDrive di Erika.

Esempio 3

Export-ContentExplorerData -TagType SensitiveInformationType -TagName "All Full Names"

Esempio 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

In questo esempio vengono esportati i record per il tipo di informazioni sensibili specificato per tutti i carichi di lavoro.

Parametri

-Aggregate

Applicabile: Conformità & sicurezza

Nota: Questo parametro è attualmente disponibile in anteprima privata, non è disponibile in tutte le organizzazioni ed è soggetto a modifiche.

L'opzione del parametro Aggregate restituisce i numeri aggregati a livello di cartella anziché restituire i dettagli a livello di elemento. Con questa opzione non è necessario specificare alcun valore.

L'uso di questa opzione riduce significativamente il tempo di esportazione. Per scaricare gli elementi in una cartella, eseguire questo cmdlet per cartelle specifiche.

Quando si usa questa opzione con i parametri TagName, TagType e Workload, il comando restituisce le informazioni seguenti:

SharePoint e OneDrive: elenco di SiteUlrs.
Exchange Online e Microsoft Teams: elenco di UPN.
Numero di elementi nelle cartelle contrassegnate con il tag pertinente.

Proprietà dei parametri

Tipo:	SwitchParameter
Valore predefinito:	False
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	Named
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-ConfidenceLevel

Applicabile: Conformità & sicurezza

Il parametro ConfidenceLevel consente di specificare il livello di attendibilità della corrispondenza per l'esportazione dei dettagli del file. I valori validi sono:

basso
Medio
alto

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Valori accettati:	high, medium, low
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	0
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-PageCookie

Applicabile: Conformità & sicurezza

Il parametro PageCookie specifica se ottenere altri dati quando il valore della proprietà MorePagesAvailable nell'output del comando è True. Se non si usa il parametro PageSize, vengono restituiti al massimo 100 record. Se si usa il parametro PageSize, è possibile restituire un massimo di 10000 record.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	1
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-PageSize

Applicabile: Conformità & sicurezza

Il parametro PageSize specifica il numero massimo di record da restituire in una singola query. L'input valido per questo parametro è un numero intero compreso tra 1 e 10000. Il valore predefinito è 100.

Nota: nelle cartelle vuote o nelle cartelle con pochi file, questo parametro può causare l'esecuzione del comando per un lungo periodo di tempo quando tenta di ottenere il conteggio pageSize dei risultati. Per evitare questo problema, il comando restituisce i dati di 5 cartelle o il numero di record specificato dal parametro PageSize, a seconda del completamento per primo. Ad esempio, se sono presenti 10 cartelle con 1 record ciascuno, il comando restituisce 5 record delle prime 5 cartelle. Nell'esecuzione successiva tramite cookie di pagina, restituisce 5 record dalle 5 cartelle rimanenti, anche se il valore pageSize è 10.

Proprietà dei parametri

Tipo:	Int32
Valore predefinito:	0
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	2
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-SiteUrl

Applicabile: Conformità & sicurezza

Il parametro SiteUrl consente di specificare l'URL del sito da cui esportare i dettagli del file.

Questo parametro viene usato per i carichi di lavoro di SharePoint e OneDrive.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	3
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-TagName

Applicabile: Conformità & sicurezza

Il parametro TagName specifica il nome dell'etichetta da cui esportare i dettagli del file. Se il valore contiene spazi è necessario racchiuderlo tra virgolette.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	4
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-TagType

Applicabile: Conformità & sicurezza

Il parametro TagType specifica il tipo di etichetta da cui esportare i dettagli del file. I valori validi sono:

Conservazione
SensitiveInformationType
Riservatezza
TrainableClassifier

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	5
Obbligatorio:	True
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-UserPrincipalName

Applicabile: Conformità & sicurezza

Il parametro UserPrincipalName consente di specificare l'account utente in formato UPN da cui esportare i dettagli del messaggio. Un valore UPN di esempio è erika@contoso.onmicrosoft.com.

Usare questo parametro per i carichi di lavoro di Exchange e Microsoft Teams.

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	6
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

-Workload

Applicabile: Conformità & sicurezza

Il parametro Workload consente di specificare il percorso da cui esportare i dettagli del file. I valori validi sono:

EXO o Exchange
ODB o OneDrive
SPO o SharePoint
Teams

Proprietà dei parametri

Tipo:	String
Valore predefinito:	None
Supporta i caratteri jolly:	False
DontShow:	False

Set di parametri

(All)

Posizione:	7
Obbligatorio:	False
Valore dalla pipeline:	False
Valore dalla pipeline in base al nome della proprietà:	False
Valore dagli argomenti rimanenti:	False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.

Commenti e suggerimenti

Questa pagina è stata utile?

Condividi tramite

Export-ContentExplorerData

Sintassi

Default (Impostazione predefinita)

Descrizione

Esempio

Esempio 1

Esempio 2

Esempio 3

Esempio 4

Parametri

-Aggregate

Proprietà dei parametri

Set di parametri

-ConfidenceLevel

Proprietà dei parametri

Set di parametri

-PageCookie

Proprietà dei parametri

Set di parametri

-PageSize

Proprietà dei parametri

Set di parametri

-SiteUrl

Proprietà dei parametri

Set di parametri

-TagName

Proprietà dei parametri

Set di parametri

-TagType

Proprietà dei parametri

Set di parametri

-UserPrincipalName

Proprietà dei parametri

Set di parametri

-Workload

Proprietà dei parametri

Set di parametri

CommonParameters

Commenti e suggerimenti