Export-ContentExplorerData
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à di 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 aggregato. Se vengono usati solo i parametri TagName e TagType, il valore sarà il conteggio aggregato totale per tale tag. Se viene utilizzato anche il parametro Workload (Carico di lavoro), il valore è il conteggio aggregato nel carico di lavoro per quel tag. Se vengono usati i parametri UserPrincipalName o SiteUrl, il valore è il conteggio per la cartella specifica.
- MorePagesAvailable: mostra se sono rimasti altri record da esportare. Il valore è True o False.
- RecordsReturned: il 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 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 SIT/etichetta e quindi riutilizzare lo stesso script per ogni SIT/etichetta in ogni carico di lavoro in base alle esigenze.
Quando riprovi lo script, assicurati di riconnetterti prima alla sessione. Il token della sessione scade dopo circa un'ora, il che può causare un errore del cmdlet. Per risolvere questo problema, riconnettersi alla sessione prima di riprovare lo script. Se lo script ha esito negativo, riavviarlo usando il cookie dell'ultima pagina restituito per continuare l'esportazione da dove era stato interrotto.
Consiglio
Per supportare gli script automatici che vengono eseguiti per molto tempo, è possibile usare l'autenticazione basata su certificati (CBA).
Per usare l'app di Azure, aggiungere il gruppo di ruoli di 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
Questo esempio esporta i record per il tipo di informazioni sensibili specificato nel sito di 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 record per il tipo di informazioni sensibili specificato per tutti i carichi di lavoro.
Parametri
-Aggregate
Applicabile: Sicurezza & conformità
Nota: Questo parametro è attualmente in anteprima privata, non è disponibile in tutte le organizzazioni ed è soggetto a modifiche.
Il parametro Aggregate restituisce i numeri aggregati a livello di cartella invece di restituire i dettagli a livello di elemento. Con questa opzione non è necessario specificare alcun valore.
L'utilizzo di questa opzione consente di ridurre notevolmente i tempi 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 degli 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: Sicurezza & conformità
Il parametro ConfidenceLevel consente di specificare il livello di confidenza della corrispondenza per i dettagli del file da esportare. 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: Sicurezza & conformità
Il parametro PageCookie consente di specificare se ottenere più dati quando il valore della proprietà MorePagesAvailable nell'output del comando è True. Se non si utilizza il parametro PageSize, vengono restituiti al massimo 100 record. Se si utilizza 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: Sicurezza & conformità
Il parametro PageSize consente di specificare 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: in cartelle vuote o con pochi file, questo parametro può causare un'esecuzione prolungata del comando mentre tenta di ottenere il conteggio delle dimensioni della pagina dei risultati. Per evitare questo problema, il comando restituisce i dati da 5 cartelle o il numero di record specificato dal parametro PageSize, a seconda dell'evento che si verifica per primo. Ad esempio, se sono presenti 10 cartelle con 1 record ciascuna, il comando restituisce 5 record delle prime 5 cartelle. Nell'esecuzione successiva, usando il cookie di pagina, restituisce 5 record dalle restanti 5 cartelle, 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: Sicurezza & conformità
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: Sicurezza & conformità
Il parametro TagName consente di specificare 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: Sicurezza & conformità
Il parametro TagType consente di specificare 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: Sicurezza & conformità
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.
Questo parametro viene usato 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: Sicurezza & conformità
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
- SharePoint Online 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.