Set-ComplianceSearch
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 Set-ComplianceSearch per modificare le ricerche di conformità non in esecuzione in Exchange Server 2016 o versioni successive e nel Portale di conformità di Microsoft Purview.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Set-ComplianceSearch
[-Identity] <ComplianceSearchIdParameter>
[-AddExchangeLocation <String[]>]
[-AddExchangeLocationExclusion <String[]>]
[-AddSharePointLocation <String[]>]
[-AddSharePointLocationExclusion <String[]>]
[-AllowNotFoundExchangeLocationsEnabled <Boolean>]
[-Confirm]
[-ContentMatchQuery <String>]
[-Description <String>]
[-ExchangeLocation <String[]>]
[-ExchangeLocationExclusion <String[]>]
[-Force]
[-HoldNames <String[]>]
[-IncludeOrgContent <Boolean>]
[-IncludeUserAppContent <Boolean>]
[-Language <CultureInfo>]
[-Name <String>]
[-PublicFolderLocation <String[]>]
[-RefinerNames <String[]>]
[-RemoveExchangeLocation <String[]>]
[-RemoveExchangeLocationExclusion <String[]>]
[-RemovePublicFolderLocation <String[]>]
[-RemoveSharePointLocation <String[]>]
[-RemoveSharePointLocationExclusion <String[]>]
[-SharePointLocation <String[]>]
[-SharePointLocationExclusion <String[]>]
[-WhatIf]
[<CommonParameters>] Descrizione
È 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
Set-ComplianceSearch -Identity "Project X" -ExchangeLocation AllIn questo esempio viene modificata la ricerca di conformità esistente denominata Project X. L'ambito della ricerca di Exchange viene modificato in tutte le cassette postali.
Esempio 2
Set-ComplianceSearch -Identity "Contoso Case Search 1" -HoldNames All -ExchangeLocation $null -SharePointLocation $nullIn questo esempio viene modificata una ricerca di conformità esistente associata a un caso di eDiscovery nel Portale di conformità di Microsoft Purview. L'ambito della ricerca viene modificato dalla ricerca di cassette postali e siti di SharePoint selezionati alla ricerca di tutti i percorsi di contenuto che sono stati messi in attesa nel caso di eDiscovery.
Esempio 3
Set-ComplianceSearch -Identity "China Subsidiary Search" -Language zh-CNIn questo esempio l'impostazione della lingua per una ricerca di conformità esistente viene modificata in cinese.
Potrebbe essere necessario modificare l'impostazione della lingua se si usano parole chiave non in inglese nella query di ricerca ,specificata nel parametro ContentMatchQuery.
Parametri
-AddExchangeLocation
Il parametro AddExchangeLocation consente di specificare le cassette postali da aggiungere all'elenco delle cassette postali incluse quando non si usa il valore All per il parametro ExchangeLocation. I valori validi sono:
- Una normale cassetta postale utente. L'inclusione di altri tipi di cassette postali (ad esempio, cassette postali inattive o Microsoft 365 utenti guest) è controllata dal parametro AllowNotFoundExchangeLocationsEnabled.
- Una cassetta postale
Per specificare una cassetta postale o un gruppo di distribuzione, usare l'indirizzo di posta elettronica. È possibile specificare più valori separati da virgole.
| Type: | String[] |
| 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 |
-AddExchangeLocationExclusion
Questo parametro funziona solo in Exchange locale.
Questo parametro specifica le cassette postali da aggiungere all'elenco delle cassette postali escluse quando si usa il valore All per il parametro ExchangeLocation. I valori validi sono:
- Una normale cassetta postale utente. L'inclusione di altri tipi di cassette postali (ad esempio, cassette postali inattive o Microsoft 365 utenti guest) è controllata dal parametro AllowNotFoundExchangeLocationsEnabled.
- Una cassetta postale
Per specificare una cassetta postale o un gruppo di distribuzione, usare l'indirizzo di posta elettronica. È possibile specificare più valori separati da virgole.
| Type: | String[] |
| 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 |
-AddSharePointLocation
Questo parametro è disponibile solamente nel servizio basato su cloud.
Il parametro AddSharePointLocation consente di specificare i siti di SharePoint Online da aggiungere all'elenco dei siti inclusi quando non si usa il valore All per il parametro SharePointLocation. È possibile identificare il sito mediante il relativo valore URL.
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AddSharePointLocationExclusion
Questo parametro è disponibile solamente nel servizio basato su cloud.
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-AllowNotFoundExchangeLocationsEnabled
Il parametro AllowNotFoundExchangeLocationsEnabled specifica se includere cassette postali diverse dalle normali cassette postali utente nella ricerca di conformità. I valori validi sono:
- $true: la ricerca non prova a convalidare l'esistenza della cassetta postale prima di procedere. Questo valore è necessario se si desidera eseguire ricerche nelle cassette postali che non vengono risolte come cassette postali normali.
- $false: la ricerca tenta di convalidare l'esistenza della cassetta postale prima di procedere. Se si specifica una cassetta postale che non è una normale cassetta postale utente, la ricerca avrà esito negativo. Questo è il valore predefinito.
I tipi di cassetta postale interessati dal valore di questo parametro includono:
- Cassette postali inattive
- Utenti senza licenza di Exchange Online che usano applicazioni di Office
- Utenti guest
- Utenti locali la cui identità è sincronizzata con l'organizzazione Microsoft 365
| Type: | Boolean |
| 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 |
-Confirm
L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.
- I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone 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 hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
| Type: | SwitchParameter |
| Aliases: | cf |
| 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 |
-ContentMatchQuery
Il parametro ContentMatchQuery consente di specificare un filtro di ricerca dei contenuti.
Questo parametro utilizza una stringa di ricerca di testo o una query formattata tramite il linguaggio KQL (Keyword Query Language). Per altre informazioni, vedere Informazioni di riferimento sulla sintassi KQL (Keyword Query Language) e Query con parole chiave e condizioni di ricerca per eDiscovery.
| Type: | String |
| 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 |
-Description
Il parametro Description consente di specificare una descrizione per la ricerca di conformità. 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: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-ExchangeLocation
Il parametro ExchangeLocation consente di specificare le cassette postali da includere. I valori validi sono:
- Una normale cassetta postale utente. L'inclusione di altri tipi di cassette postali (ad esempio, cassette postali inattive o Microsoft 365 utenti guest) è controllata dal parametro AllowNotFoundExchangeLocationsEnabled.
- Una cassetta postale
- Valore All per tutte le cassette postali. È possibile utilizzare questo valore solo singolarmente.
Per specificare una cassetta postale o un gruppo di distribuzione, usare l'indirizzo di posta elettronica. È possibile specificare più valori separati da virgole.
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".
| Type: | String[] |
| 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 |
-ExchangeLocationExclusion
Questo parametro funziona solo in Exchange locale.
Questo parametro specifica le cassette postali da escludere quando si usa il valore All per il parametro ExchangeLocation. I valori validi sono:
- Una normale cassetta postale utente. L'inclusione di altri tipi di cassette postali (ad esempio, cassette postali inattive o Microsoft 365 utenti guest) è controllata dal parametro AllowNotFoundExchangeLocationsEnabled.
- Una cassetta postale
Per specificare una cassetta postale o un gruppo di distribuzione, usare l'indirizzo di posta elettronica. È possibile specificare più valori separati da virgole.
| Type: | String[] |
| 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 |
-Force
L'opzione 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.
| 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 |
-HoldNames
Questo parametro è disponibile solamente nel servizio basato su cloud.
Il parametro HoldNames specifica che i percorsi del contenuto che sono stati inseriti in attesa nel caso di eDiscovery verranno cercati. Utilizzare il valore All per il parametro. È possibile utilizzare questo parametro solo per le ricerche di conformità associate a un caso di eDiscovery.
Se le posizioni del contenuto nella ricerca di conformità includono cassette postali, è anche necessario usare il parametro ExchangeLocation con il valore $null. Analogamente, se la ricerca di conformità include siti di SharePoint, è necessario usare anche il parametro SharePointLocation con il valore $null.
Inoltre, se una posizione dei contenuti è stata archiviata in caso basato su query, verranno cercati solo gli elementi archiviati quando viene riavviata questa ricerca di conformità. Ad esempio, se un utente è stato archiviato in un caso basato su query che conserva gli elementi inviati o creati prima di una data specifica, verranno cercati solo tali elementi utilizzando i criteri di ricerca specificati dalla ricerca di conformità.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Identity
Il parametro Identity indica la ricerca di conformità da modificare.
Quando si utilizza questo parametro, il parametro Identity è obbligatorio, ma il valore viene ignorato. Ad esempio, utilizzare il valore 000 per il parametro Identity.
- Nome
- JobRunId (GUID)
JobRunId (GUID)
| Type: | ComplianceSearchIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-IncludeOrgContent
{{ Fill IncludeOrgContent Description }}
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-IncludeUserAppContent
Questo parametro è disponibile solamente nel servizio basato su cloud.
Il parametro IncludeUserAppContent specifica che si vuole cercare nella posizione di archiviazione basata sul cloud gli utenti che non hanno un normale account utente Microsoft 365 nell'organizzazione. Questi tipi di utenti includono utenti senza una licenza Exchange Online che usano applicazioni di Office, Microsoft 365 utenti guest e utenti locali la cui identità è sincronizzata con l'organizzazione Microsoft 365. I valori validi sono:
- $true: il percorso di archiviazione basato sul cloud per gli utenti specificati in uno dei parametri di posizione di Exchange verrà incluso nella ricerca. Se si usa il valore All per il parametro ExchangeLocation, nella ricerca verrà incluso il percorso di archiviazione basato sul cloud per qualsiasi utente guest o locale.
- $false: il percorso di archiviazione basato sul cloud per gli utenti specificati nel parametro ExchangeLocation non verrà incluso nella ricerca. Questo è il valore predefinito.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Language
Il parametro Language consente di specificare la lingua per la ricerca di conformità.
L'input valido per questo parametro è un valore di codice delle impostazioni cultura supportato dalla classe CultureInfo Microsoft .NET Framework. Ad esempio, da-DK per il danese o ja-JP per il giapponese. Per altre informazioni, vedere Classe CultureInfo.
| Type: | CultureInfo |
| 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 |
-Name
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | String |
| 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 |
-PublicFolderLocation
Questo parametro è disponibile solamente nel servizio basato su cloud.
Il parametro PublicFolderLocation consente di specificare che si desidera includere tutte le cartelle pubbliche nella ricerca. Si utilizza il valore All per questo parametro.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RefinerNames
Questo parametro è disponibile solamente nel servizio basato su cloud.
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveExchangeLocation
Il parametro RemoveExchangeLocation consente di specificare le cassette postali da rimuovere dall'elenco delle cassette postali incluse quando non si usa il valore All per il parametro ExchangeLocation. I valori validi sono:
- Questo parametro specifica le cassette postali da rimuovere dall'elenco delle cassette postali escluse quando si utilizza il valore All per il ExchangeLocation parametro. I valori validi sono:
- Una cassetta postale
Per specificare una cassetta postale o un gruppo di distribuzione, usare l'indirizzo di posta elettronica. È possibile specificare più valori separati da virgole.
| Type: | String[] |
| 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 |
-RemoveExchangeLocationExclusion
Questo parametro funziona solo in Exchange locale.
Questo parametro specifica le cassette postali da rimuovere dall'elenco delle cassette postali escluse quando si usa il valore All per il parametro ExchangeLocation. I valori validi sono:
- Questo parametro specifica le cassette postali da rimuovere dall'elenco delle cassette postali escluse quando si utilizza il valore All per il ExchangeLocation parametro. I valori validi sono:
- Una cassetta postale
Per specificare una cassetta postale o un gruppo di distribuzione, usare l'indirizzo di posta elettronica. È possibile specificare più valori separati da virgole.
| Type: | String[] |
| 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 |
-RemovePublicFolderLocation
Questo parametro è disponibile solamente nel servizio basato su cloud.
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveSharePointLocation
Questo parametro è disponibile solamente nel servizio basato su cloud.
Il parametro RemoveSharePointLocation consente di specificare i siti di SharePoint Online da rimuovere dall'elenco dei siti inclusi quando non si usa il valore All per il parametro SharePointLocation. È possibile identificare il sito mediante il relativo valore URL.
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RemoveSharePointLocationExclusion
Questo parametro è disponibile solamente nel servizio basato su cloud.
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-SharePointLocation
Questo parametro è disponibile solamente nel servizio basato su cloud.
Il parametro SharePointLocation consente di specificare i siti di SharePoint Online da includere. È possibile identificare il sito mediante il relativo valore URL oppure utilizzare il valore All per includere tutti i siti.
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-SharePointLocationExclusion
Questo parametro è disponibile solamente nel servizio basato su cloud.
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-WhatIf
L'opzione WhatIf non funziona in PowerShell per la conformità alla sicurezza & .
L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.
| Type: | SwitchParameter |
| Aliases: | wi |
| 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 |