Get-ComplianceSearchAction

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.

Usare il cmdlet Get-ComplianceSearchAction per visualizzare informazioni sulle azioni di ricerca di conformità.

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

Sintassi

Get-ComplianceSearchAction
   [[-Identity] <ComplianceSearchActionIdParameter>]
   [-Case <String>]
   [-Details]
   [-DomainController <Fqdn>]
   [-IncludeCredential]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]
Get-ComplianceSearchAction
   [-Preview]
   [-Case <String>]
   [-Details]
   [-DomainController <Fqdn>]
   [-IncludeCredential]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]
Get-ComplianceSearchAction
   [-Purge]
   [-Case <String>]
   [-Details]
   [-DomainController <Fqdn>]
   [-IncludeCredential]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]
Get-ComplianceSearchAction
   [-Export]
   [-Case <String>]
   [-Details]
   [-DomainController <Fqdn>]
   [-IncludeCredential]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Descrizione

Dopo aver creato ed eseguito una ricerca di conformità utilizzando il cmdlet New-ComplianceSearch e dopo aver avviato la ricerca mediante il cmdlet Start-ComplianceSearch, è possibile assegnare un'operazione di ricerca tramite il cmdlet New-ComplianceSearchAction. Utilizzare il cmdlet Get-ComplianceSearchAction per tenere traccia dello stato di avanzamento dell'operazione di ricerca di conformità.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano 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 Exchange locale questo cmdlet è disponibile nel ruolo Ricerca cassette postali. Per impostazione predefinita, questo ruolo viene assegnato solo al gruppo di ruoli Gestione individuazione.

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

Esempio

Esempio 1

Get-ComplianceSearchAction

In questo esempio viene visualizzato un elenco riepilogativo di tutte le operazioni di ricerca di conformità.

Esempio 2

Get-ComplianceSearchAction -Identity "Case 1234_Preview" | Format-List

In questo esempio vengono visualizzati i dettagli sull'operazione di ricerca di conformità denominata "Case 1234_Preview"

Parametri

-Case

Questo parametro è disponibile solamente nel servizio basato su cloud.

Il parametro Case filtra i risultati in base al nome del case specificato. Se il valore contiene spazi è necessario racchiuderlo tra virgolette.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Details

L'opzione Details consente di specificare se includere informazioni dettagliate nei risultati. Con questa opzione non è necessario specificare alcun valore.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-DomainController

Questo parametro è disponibile solo in Exchange locale.

Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

-Export

L'opzione Export consente di filtrare i risultati per operazioni di ricerca di conformità Export. Con questa opzione non è necessario specificare alcun valore.

Non è possibile usare questa opzione con i parametri Identity, Preview o Purge.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-Identity

Il parametro Identity consente di specificare l'operazione di ricerca di conformità da visualizzare. È possibile utilizzare qualsiasi valore che identifichi l'operazione di ricerca di conformità in modo univoco. Ad esempio:

  • Nome: il nome dell'azione di ricerca di conformità usa la sintassi "Compliance Search Name_Action". Ad esempio, "Case 1234_Preview".
  • JobRunId (GUID)

Non è possibile usare questo parametro con i parametri Export, Preview o Purge.

Quando si usa il parametro Identity, nei risultati vengono restituiti altri dettagli. Ad esempio:

  • Nella riga Risultati vengono popolati i valori delle proprietà Conteggio elementi, Dimensioni totali e Dettagli.
  • Le righe di posizione vengono aggiunte ai risultati.
  • Il valore della proprietà NumBinding viene popolato.
  • Vengono popolate le proprietà della posizione interessate, ad esempio ExchangeLocation.
  • Il valore della proprietà CaseName viene popolato.
Type:ComplianceSearchActionIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-IncludeCredential

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-Preview

L'opzione Preview consente di filtrare i risultati in base alle operazioni di ricerca di conformità Preview. Con questa opzione non è necessario specificare alcun valore.

Non è possibile usare questa opzione con i parametri Export, Identity o Purge.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-Purge

Nota: in & Security Compliance PowerShell questo parametro è disponibile solo nel ruolo Ricerca ed eliminazione. Per impostazione predefinita, questo ruolo viene assegnato solo ai gruppi di ruoli Gestione organizzazione e Ricerca dati.

L'opzione Purge consente di filtrare i risultati in base alle operazioni di ricerca di conformità Purge. Con questa opzione non è necessario specificare alcun valore.

Non è possibile usare questa opzione con i parametri Export, Identity o Preview.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-ResultSize

Il parametro ResultSize consente di specificare il numero massimo di risultati da restituire. Se si desidera restituire tutte le richieste che soddisfano la query, impostare questo parametro sul valore unlimited. Il valore predefinito è 1000.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance