New-ComplianceSearchAction

Modulo:
Exchange PowerShell

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni potrebbero essere esclusivi di un ambiente o dell'altro.

Usare il cmdlet New-ComplianceSearchAction per creare azioni per le ricerche di contenuto in Exchange Server e in Microsoft Purview.

Nota: molti parametri di questo cmdlet funzionano solo in Exchange locale. Per altre informazioni, vedere Modifiche di maggio 2025 a Microsoft Purview eDiscovery.

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

Sintassi

Export 

New-ComplianceSearchAction
    [-SearchName] <String[]>
    [-Export]
    [-ActionName <String>]
    [-ArchiveFormat <ComplianceExportArchiveFormat>]
    [-Confirm]
    [-FileTypeExclusionsForUnindexedItems <String[]>]
    [-EnableDedupe <Boolean>]
    [-ExchangeArchiveFormat <ComplianceExportArchiveFormat>]
    [-Force]
    [-Format <ComplianceDataTransferFormat>]
    [-IncludeCredential]
    [-IncludeSharePointDocumentVersions <Boolean>]
    [-JobOptions <Int32>]
    [-NotifyEmail <String>]
    [-NotifyEmailCC <String>]
    [-ReferenceActionName <String>]
    [-Region <String>]
    [-Report]
    [-RetentionReport]
    [-RetryOnError]
    [-Scenario <ComplianceSearchActionScenario>]
    [-Scope <ComplianceExportScope>]
    [-SearchNames <String[]>]
    [-SharePointArchiveFormat <ComplianceExportArchiveFormat>]
    [-ShareRootPath <String>]
    [-Version <String>]
    [-WhatIf]
    [<CommonParameters>]

Preview 

New-ComplianceSearchAction
    [-SearchName] <String[]>
    [-Preview]
    [-ActionName <String>]
    [-Confirm]
    [-Force]
    [-Format <ComplianceDataTransferFormat>]
    [-IncludeCredential]
    [-JobOptions <Int32>]
    [-ReferenceActionName <String>]
    [-Region <String>]
    [-RetryOnError]
    [-Scenario <ComplianceSearchActionScenario>]
    [-SearchNames <String[]>]
    [-Version <String>]
    [-WhatIf]
    [<CommonParameters>]

Purge 

New-ComplianceSearchAction
    [-SearchName] <String[]>
    [-Purge]
    [-PurgeType <ComplianceDestroyType>]
    [-ActionName <String>]
    [-Confirm]
    [-Force]
    [-Format <ComplianceDataTransferFormat>]
    [-IncludeCredential]
    [-JobOptions <Int32>]
    [-Region <String>]
    [-ReferenceActionName <String>]
    [-RetryOnError]
    [-Scenario <ComplianceSearchActionScenario>]
    [-SearchNames <String[]>]
    [-Version <String>]
    [-WhatIf]
    [<CommonParameters>]

Descrizione

Dopo aver creato una ricerca di contenuto usando il cmdlet New-ComplianceSearch e averla eseguita usando il cmdlet Start-ComplianceSearch, puoi assegnare un'azione di ricerca alla ricerca usando il cmdlet New-ComplianceSearchAction.

In Exchange locale, questo cmdlet è disponibile nel ruolo Ricerca cassette postali. Per impostazione predefinita, questo ruolo viene assegnato solo al gruppo di ruoli Gestione individuazione.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, si potrebbe non avere accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

In Microsoft 365, all'account usato per eseguire questo cmdlet deve essere assegnata una licenza di Microsoft 365 valida.

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.

Per usare questo cmdlet per le azioni di ripulitura in PowerShell per la sicurezza & la conformità, è necessario soddisfare i requisiti seguenti:

  • Usare PowerShell di Exchange Online versione 3.9.0 o successiva (agosto 2025). Per altre informazioni, vedere Novità del modulo PowerShell di Exchange Online. L'installazione di questa versione del modulo potrebbe richiedere di annullare tutte le versioni precedenti del modulo.
  • Eseguire il comando Connect-IPPSSession con l'opzione EnableSearchOnlySession .

Esempio

Esempio 1

New-ComplianceSearchAction -SearchName "Project X" -Preview

In questo esempio viene creata un'azione di ricerca di anteprima per la ricerca di contenuto denominata Progetto X.

Esempio 2

New-ComplianceSearchAction -SearchName "Project X" -Export

In questo esempio viene creata un'azione di ricerca di esportazione per la ricerca di contenuto denominata Progetto X.

Nota: questo esempio funziona solo in Exchange locale. Per altre informazioni, vedere Modifiche di maggio 2025 a Microsoft Purview eDiscovery.

Esempio 3

New-ComplianceSearchAction -SearchName "Remove Phishing Message" -Purge -PurgeType SoftDelete

In questo esempio vengono eliminati i risultati della ricerca restituiti da una ricerca di contenuto denominata Rimuovi messaggio di phishing. Gli elementi non indicizzati non vengono eliminati quando si usa il parametro Purge.

Esempio 4

New-ComplianceSearchAction -SearchName "Case 321 All Sites" -Export -SharePointArchiveFormat SingleZip -ExchangeArchiveFormat PerUserPst -Format FxStream

In questo esempio vengono esportati i risultati restituiti dalla ricerca di contenuto denominata "Caso 321 Tutti i siti". I risultati della ricerca vengono compressi ed esportati in un singolo file ZIP. Se la ricerca includeva percorsi di Exchange, i risultati della ricerca vengono esportati come un file PST per ogni cassetta postale.

Nota: questo esempio funziona solo in Exchange locale. Per altre informazioni, vedere Modifiche di maggio 2025 a Microsoft Purview eDiscovery.

Parametri

-ActionName

Applicabile: Sicurezza & conformità

Questo parametro è disponibile solamente nel servizio basato su cloud.

Il parametro ActionName consente di specificare un nome per l'azione di ricerca contenuto. Questo parametro viene utilizzato solo quando si specificano più ricerche di contenuto nel parametro SearchName.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
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

-ArchiveFormat

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sicurezza & Conformità

Questo parametro è deprecato e non viene più utilizzato.

Per specificare il formato per i risultati della ricerca di Exchange, utilizzare il parametro ExchangeArchiveFormat. Per specificare il formato per i risultati della ricerca di SharePoint e OneDrive, usare il parametro SharePointArchiveFormat.

Proprietà dei parametri

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

Set di parametri

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

-Confirm

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sicurezza & Conformità

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. Il modo in cui questa opzione influisce sul cmdlet varia se il cmdlet richiede o meno una conferma prima di procedere.

  • I cmdlet distruttivi (ad esempio, i cmdlet Remove-*) dispongono di una pausa incorporata che impone all'utente di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
  • La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non dispone di una pausa incorporata. Per questi cmdlet, se si specifica l'opzione Confirm senza un valore, viene introdotta una pausa che impone di confermare il comando prima di procedere.

Questo cmdlet ha una pausa incorporata, quindi è consigliabile usare -Confirm:$false per ignorare la conferma.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

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

-EnableDedupe

Applicabile: Sicurezza & conformità

Questo parametro è disponibile solamente nel servizio basato su cloud.

Questo parametro è riservato all'uso interno da parte di Microsoft.

Proprietà dei parametri

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

Set di parametri

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

-ExchangeArchiveFormat

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sicurezza & Conformità

Nota: questo parametro funziona solo in Exchange locale. Per altre informazioni, vedere Modifiche di maggio 2025 a Microsoft Purview eDiscovery.

Questo parametro è funzionale solo al servizio basato su cloud.

Questo parametro richiede il ruolo di esportazione in PowerShell per la sicurezza & la conformità. Per impostazione predefinita, questo ruolo viene assegnato solo al gruppo di ruoli eDiscovery Manager.

Il parametro ExchangeArchiveFormat consente di specificare come esportare i risultati della ricerca di Exchange. I valori validi sono:

  • PerUserPst: un file PST per ogni cassetta postale.
  • SinglePst: un file PST che contiene tutti i messaggi esportati.
  • SingleFolderPst: un file PST con una singola cartella radice per l'intera esportazione.
  • IndividualMessage: esporta ogni messaggio come file di messaggio .msg. Questo è il valore predefinito.
  • PerUserZip: un file ZIP per ogni cassetta postale. Ogni file ZIP contiene i file dei messaggi di .msg esportati dalla cassetta postale.
  • SingleZip: un file ZIP per tutte le cassette postali. Il file ZIP contiene tutti i file dei messaggi .msg esportati da tutte le cassette postali. Questa impostazione di output è disponibile solo in PowerShell.

Per specificare il formato per i risultati della ricerca di SharePoint e OneDrive, usare il parametro SharePointArchiveFormat.

Proprietà dei parametri

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

Set di parametri

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

-Export

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sicurezza & Conformità

Nota: questo parametro funziona solo in Exchange locale. Per altre informazioni, vedere Modifiche di maggio 2025 a Microsoft Purview eDiscovery.

Questo parametro è funzionale solo al servizio basato su cloud.

Questo parametro richiede il ruolo di esportazione in PowerShell per la sicurezza & la conformità. Per impostazione predefinita, questo ruolo viene assegnato solo al gruppo di ruoli eDiscovery Manager.

L'opzione Esporta specifica che l'azione per la ricerca di contenuto consiste nell'esportare l'insieme completo di risultati che corrispondono ai criteri di ricerca. Con questa opzione non è necessario specificare alcun valore.

Per restituire solo le informazioni relative a ogni elemento rilevato in un report, utilizzare l'opzione Report.

Proprietà dei parametri

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

Set di parametri

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

-FileTypeExclusionsForUnindexedItems

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sicurezza & Conformità

Nota: questo parametro funziona solo in Exchange locale. Per altre informazioni, vedere Modifiche di maggio 2025 a Microsoft Purview eDiscovery.

FileTypeExclusionsForUnindexedItems specifica i tipi di file da escludere in quanto non possono essere indicizzati. È possibile specificare più valori separati da virgole.

Proprietà dei parametri

Tipo:

String[]

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

Set di parametri

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

-Force

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sicurezza & Conformità

L'interruttore di forza nasconde i messaggi di avviso o di conferma. Con questa opzione non è necessario specificare alcun valore.

È possibile utilizzare questa opzione per eseguire attività a livello di programmazione, se la richiesta di un input amministrativo è inappropriata.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
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

-Format

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sicurezza & Conformità

In PowerShell per la sicurezza & la conformità questo parametro richiede il ruolo Esportazione. Per impostazione predefinita, questo ruolo viene assegnato solo al gruppo di ruoli eDiscovery Manager.

Il parametro Format consente di specificare il formato dei risultati di ricerca quando si utilizza l'opzione Export. I valori validi sono:

  • FxStream: Esporta in file PST. Questa è l'unica opzione disponibile quando si esportano i risultati della ricerca dal Portale di conformità di Microsoft Purview.
  • MIME: Esporta in .eml file di messaggi. Questo è il valore predefinito quando si utilizzano i cmdlet per esportare i risultati della ricerca.
  • Messaggio di posta elettronica: esportare in .msg file di messaggi.

Proprietà dei parametri

Tipo:ComplianceDataTransferFormat
Valore predefinito:None
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

-IncludeCredential

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sicurezza & Conformità

L'opzione IncludeCredential specifica se includere le credenziali nei risultati. Con questa opzione non è necessario specificare alcun valore.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
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

-IncludeSharePointDocumentVersions

Applicabile: Sicurezza & conformità

Nota: questo parametro funziona solo in Exchange locale. Per altre informazioni, vedere Modifiche di maggio 2025 a Microsoft Purview eDiscovery.

Questo parametro è disponibile solamente nel servizio basato su cloud.

Il parametro IncludeSharePointDocumentVersions consente di specificare se esportare le versioni precedenti del documento quando si utilizza l'opzione Export. I valori validi sono:

  • $true: esporta tutte le versioni del documento.
  • $false: esporta solo la versione pubblicata corrente del documento. Questo è il valore predefinito.

Proprietà dei parametri

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

Set di parametri

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

-JobOptions

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sicurezza & Conformità

Questo parametro è riservato all'uso interno da parte di Microsoft.

Proprietà dei parametri

Tipo:Int32
Valore predefinito:None
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

-NotifyEmail

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sicurezza & Conformità

Nota: questo parametro funziona solo in Exchange locale. Per altre informazioni, vedere Modifiche di maggio 2025 a Microsoft Purview eDiscovery.

In PowerShell per la sicurezza & la conformità questo parametro richiede il ruolo Esportazione. Per impostazione predefinita, questa opzione viene assegnata solo al gruppo di ruoli eDiscovery Manager.

Il parametro NotifyEmail consente di specificare la destinazione dell'indirizzo di posta elettronica per i risultati della ricerca quando si utilizza l'opzione Export.

Il destinatario specificato è indicato nel campo To: del messaggio.

Proprietà dei parametri

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

Set di parametri

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

-NotifyEmailCC

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sicurezza & Conformità

Nota: questo parametro funziona solo in Exchange locale. Per altre informazioni, vedere Modifiche di maggio 2025 a Microsoft Purview eDiscovery.

In PowerShell per la sicurezza & la conformità questo parametro richiede il ruolo Esportazione. Per impostazione predefinita, questo ruolo viene assegnato solo al gruppo di ruoli eDiscovery Manager.

Il parametro NotifyEmailCC consente di specificare la destinazione dell'indirizzo di posta elettronica per i risultati della ricerca quando si utilizza l'opzione Export.

Il destinatario specificato è indicato nel campo Cc: del messaggio.

Proprietà dei parametri

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

Set di parametri

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

-Preview

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sicurezza & Conformità

Nota: questo parametro funziona solo in Exchange locale. Per altre informazioni, vedere Modifiche di maggio 2025 a Microsoft Purview eDiscovery.

In PowerShell per la sicurezza & la conformità questo parametro richiede il ruolo di anteprima. Per impostazione predefinita, questo ruolo viene assegnato solo al gruppo di ruoli eDiscovery Manager.

L'opzione Anteprima specifica che l'azione della ricerca nel contenuto consiste nell'visualizzare in anteprima i risultati che corrispondono ai criteri di ricerca. Con questa opzione non è necessario specificare alcun valore.

Proprietà dei parametri

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

Set di parametri

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

-Purge

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sicurezza & Conformità

Nota: in PowerShell per la sicurezza & la conformità questo parametro è disponibile solo nel ruolo Ricerca ed eliminazione. Per impostazione predefinita, questo ruolo viene assegnato solo ai gruppi di ruoli Gestione organizzazione e Investigatore dati.

L'opzione Elimina specifica che l'azione per la ricerca di contenuto consiste nel rimuovere gli elementi che soddisfano i criteri di ricerca. Con questa opzione non è necessario specificare alcun valore.

  • È possibile rimuovere al massimo 10 elementi per ogni cassetta postale alla volta. Poiché la possibilità di cercare e di rimuovere i messaggi è uno strumento di intervento, questo limite garantisce che i messaggi vengano rimossi rapidamente dalle cassette postali. Questa operazione non ha lo scopo di pulizia delle cassette postali degli utenti.

    Suggerimento: per eliminare più di 10 elementi, fare riferimento a ediscoverySearch: purgeData nell'API Graph Microsoft, che consente di eliminare un massimo di 100 elementi per posizione.

  • È possibile rimuovere elementi da un massimo di 50.000 cassette postali usando una singola ricerca contenuto. Per rimuovere elementi da più di 50.000 cassette postali, è necessario creare ricerche di contenuto separate. Per altre informazioni, vedere Cercare ed eliminare messaggi di posta elettronica nell'organizzazione di Microsoft 365.

  • Gli elementi non indicizzati non vengono rimossi dalle cassette postali quando si usa questa opzione.

  • Il valore del parametro PurgeType controlla il modo in cui gli elementi vengono rimossi.

Proprietà dei parametri

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

Set di parametri

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

-PurgeType

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sicurezza & Conformità

Nota: in PowerShell per la sicurezza & la conformità questo parametro è disponibile solo nel ruolo Ricerca ed eliminazione. Per impostazione predefinita, questo ruolo viene assegnato solo ai gruppi di ruoli Gestione organizzazione e Investigatore dati.

Il parametro PurgeType consente di specificare come rimuovere gli elementi quando l'azione è Purge. I valori validi sono:

  • Eliminazione temporanea: gli elementi eliminati possono essere recuperati dagli utenti fino al termine del periodo di conservazione degli elementi eliminati.
  • HardDelete (solo cloud): gli elementi eliminati vengono contrassegnati per la rimozione definitiva dalla cassetta postale e vengono rimossi definitivamente la volta successiva che la cassetta postale viene elaborata dall'Assistente cartelle gestite. Se nella cassetta postale è abilitato il ripristino di singoli elementi, gli elementi eliminati vengono rimossi definitivamente al termine del periodo di conservazione degli elementi eliminati.

Proprietà dei parametri

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

Set di parametri

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

-ReferenceActionName

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sicurezza & Conformità

Questo parametro è riservato all'uso interno da parte di Microsoft.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
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

-Region

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sicurezza & Conformità

Questo parametro è riservato all'uso interno da parte di Microsoft.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
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

-Report

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sicurezza & Conformità

Nota: questo parametro funziona solo in Exchange locale. Per altre informazioni, vedere Modifiche di maggio 2025 a Microsoft Purview eDiscovery.

Questo parametro è funzionale solo al servizio basato su cloud.

L'opzione Report specifica che l'azione per la ricerca di contenuto consiste nell'esportare un report sui risultati (informazioni su ogni elemento anziché l'insieme completo di risultati) che soddisfano i criteri di ricerca. Con questa opzione non è necessario specificare alcun valore.

Proprietà dei parametri

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

Set di parametri

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

-RetentionReport

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sicurezza & Conformità

Nota: questo parametro funziona solo in Exchange locale. Per altre informazioni, vedere Modifiche di maggio 2025 a Microsoft Purview eDiscovery.

L'opzione RetentionReport specifica che l'azione per la ricerca di contenuto consiste nell'esportare un rapporto di conservazione. Con questa opzione non è necessario specificare alcun valore.

Proprietà dei parametri

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

Set di parametri

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

-RetryOnError

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sicurezza & Conformità

L'opzione RetryOnError consente di specificare se tentare di nuovo l'operazione per tutti gli elementi che hanno restituito esito negativo, senza eseguire nuovamente l'intera operazione. Con questa opzione non è necessario specificare alcun valore.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
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

-Scenario

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sicurezza & Conformità

In PowerShell per la sicurezza & la conformità questo parametro richiede il ruolo di anteprima. Per impostazione predefinita, questo ruolo viene assegnato solo al gruppo di ruoli eDiscovery Manager.

Il parametro Scenario consente di specificare il tipo di scenario. I valori validi sono:

  • AnalyzeWithZoom: preparare i risultati della ricerca per l'elaborazione in Microsoft Purview eDiscovery Premium.
  • Generale: esporta i risultati della ricerca nel computer locale. I messaggi di posta elettronica vengono esportati nei file con estensione pst. I documenti di SharePoint e OneDrive vengono esportati nei formati nativi di Office.
  • GenerateReportsOnly
  • Inventario
  • RetentionReports
  • Anteprima valutazione

Proprietà dei parametri

Tipo:ComplianceSearchActionScenario
Valore predefinito:None
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

-Scope

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sicurezza & Conformità

Nota: questo parametro funziona solo in Exchange locale. Per altre informazioni, vedere Modifiche di maggio 2025 a Microsoft Purview eDiscovery.

Il parametro Scope specifica gli elementi da includere in un'azione di tipo Export. I valori validi sono:

  • IndexedItemsOnly
  • UnindexedItemsOnly
  • BothIndexedAndUnindexedItems

Proprietà dei parametri

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

Set di parametri

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

-SearchName

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sicurezza & Conformità

Il parametro SearchName consente di specificare il nome della ricerca di contenuto esistente da associare all'azione di ricerca di contenuto. È possibile specificare più ricerche di contenuto separate da virgole.

Puoi trovare la ricerca di contenuto eseguendo il comando Get-ComplianceSearch | Format-Table -Nome automatico,Stato.

Proprietà dei parametri

Tipo:

String[]

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

Set di parametri

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

-SearchNames

Applicabile: Sicurezza & conformità

Questo parametro è disponibile solamente nel servizio basato su cloud.

Il parametro SearchNames consente di specificare i nomi delle ricerche di contenuto esistenti da associare all'azione di ricerca contenuto. I nomi dei contenuti da cercare sono separati da virgole.

Puoi trovare i nomi dei contenuti da cercare eseguendo il comando Get-ComplianceSearch | Format-Table -Nome automatico,Stato.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
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

-SharePointArchiveFormat

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sicurezza & Conformità

Nota: questo parametro funziona solo in Exchange locale. Per altre informazioni, vedere Modifiche di maggio 2025 a Microsoft Purview eDiscovery.

Questo parametro è funzionale solo al servizio basato su cloud.

Questo parametro richiede il ruolo di esportazione. Per impostazione predefinita, questo ruolo viene assegnato solo al gruppo di ruoli eDiscovery Manager.

Il parametro SharePointArchiveFormat consente di specificare come esportare i risultati della ricerca di SharePoint e OneDrive. I valori validi sono:

  • IndividualMessage: Esporta i file non compressi. Questo è il valore predefinito.
  • PerUserZip: un file ZIP per ogni utente. Ogni file ZIP contiene i file esportati per l'utente.
  • SingleZip: un file ZIP per tutti gli utenti. Il file ZIP contiene tutti i file esportati da tutti gli utenti. Questa impostazione di output è disponibile solo in PowerShell.

Per specificare il formato per i risultati della ricerca di Exchange, utilizzare il parametro ExchangeArchiveFormat.

Proprietà dei parametri

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

Set di parametri

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

-ShareRootPath

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Questo parametro è disponibile solo in Exchange locale.

Nota: questo parametro funziona solo in Exchange locale. Per altre informazioni, vedere Modifiche di maggio 2025 a Microsoft Purview eDiscovery.

{{ Fill ShareRootPath Description }}

Proprietà dei parametri

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

Set di parametri

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

-Version

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sicurezza & Conformità

Questo parametro è riservato all'uso interno da parte di Microsoft.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
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

-WhatIf

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sicurezza & Conformità

Il parametro WhatIf non funziona in PowerShell per sicurezza e conformità.

L'opzione WhatIf mostra le operazioni eseguite dal comando senza apportare modifiche. Con questa opzione non è necessario specificare alcun valore.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:wi

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

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.