Set-RetentionCompliancePolicy
Questo cmdlet è disponibile solo in PowerShell per sicurezza e conformità. Per altre informazioni, vedere PowerShell per sicurezza e conformità.
Usare il cmdlet Set-RetentionCompliancePolicy per modificare i criteri di conservazione esistenti nel Portale di conformità di Microsoft Purview.
Nota: l'esecuzione di questo cmdlet causa una sincronizzazione completa all'interno dell'organizzazione, che è un'operazione significativa. Se è necessario aggiornare più criteri, attendere che la distribuzione dei criteri riesca prima di eseguire di nuovo il cmdlet per i criteri successivi. Per informazioni sullo stato della distribuzione, vedere Get-RetentionCompliancePolicy.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Set-RetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-AddExchangeLocation <MultiValuedProperty>]
[-AddExchangeLocationException <MultiValuedProperty>]
[-AddModernGroupLocation <MultiValuedProperty>]
[-AddModernGroupLocationException <MultiValuedProperty>]
[-AddOneDriveLocation <MultiValuedProperty>]
[-AddOneDriveLocationException <MultiValuedProperty>]
[-AddPublicFolderLocation <MultiValuedProperty>]
[-AddSharePointLocation <MultiValuedProperty>]
[-AddSharePointLocationException <MultiValuedProperty>]
[-AddSkypeLocation <MultiValuedProperty>]
[-AddSkypeLocationException <MultiValuedProperty>]
[-Applications <MultiValuedProperty>]
[-Comment <String>]
[-Confirm]
[-DeletedResources <String>]
[-Enabled <Boolean>]
[-EnforceSimulationPolicy <Boolean>]
[-Force]
[-PolicyTemplateInfo <PswsHashtable>]
[-PolicyRBACScopes <MultiValuedProperty>]
[-PriorityCleanup]
[-RemoveExchangeLocation <MultiValuedProperty>]
[-RemoveExchangeLocationException <MultiValuedProperty>]
[-RemoveModernGroupLocation <MultiValuedProperty>]
[-RemoveModernGroupLocationException <MultiValuedProperty>]
[-RemoveOneDriveLocation <MultiValuedProperty>]
[-RemoveOneDriveLocationException <MultiValuedProperty>]
[-RemovePublicFolderLocation <MultiValuedProperty>]
[-RemoveSharePointLocation <MultiValuedProperty>]
[-RemoveSharePointLocationException <MultiValuedProperty>]
[-RemoveSkypeLocation <MultiValuedProperty>]
[-RemoveSkypeLocationException <MultiValuedProperty>]
[-RestrictiveRetention <Boolean>]
[-StartSimulation <Boolean>]
[-WhatIf]
[<CommonParameters>] Set-RetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-AddAdaptiveScopeLocation <MultiValuedProperty>]
[-Applications <MultiValuedProperty>]
[-Comment <String>]
[-Confirm]
[-DeletedResources <String>]
[-Enabled <Boolean>]
[-EnforceSimulationPolicy <Boolean>]
[-Force]
[-PriorityCleanup]
[-RemoveAdaptiveScopeLocation <MultiValuedProperty>]
[-StartSimulation <Boolean>]
[-WhatIf]
[<CommonParameters>] Set-RetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-RetryDistribution]
[-Confirm]
[-DeletedResources <String>]
[-EnforceSimulationPolicy <Boolean>]
[-PriorityCleanup]
[-StartSimulation <Boolean>]
[-WhatIf]
[<CommonParameters>] Set-RetentionCompliancePolicy
[-Identity] <PolicyIdParameter>
[-AddTeamsChannelLocation <MultiValuedProperty>]
[-AddTeamsChannelLocationException <MultiValuedProperty>]
[-AddTeamsChatLocation <MultiValuedProperty>]
[-AddTeamsChatLocationException <MultiValuedProperty>]
[-Comment <String>]
[-Confirm]
[-DeletedResources <String>]
[-Enabled <Boolean>]
[-EnforceSimulationPolicy <Boolean>]
[-Force]
[-PriorityCleanup]
[-RemoveTeamsChannelLocation <MultiValuedProperty>]
[-RemoveTeamsChannelLocationException <MultiValuedProperty>]
[-RemoveTeamsChatLocation <MultiValuedProperty>]
[-RemoveTeamsChatLocationException <MultiValuedProperty>]
[-StartSimulation <Boolean>]
[-WhatIf]
[<CommonParameters>] Descrizione
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.
Nota: non usare un comando Foreach-Object con pipe quando si aggiungono o si rimuovono posizioni dell'ambito: "Value1","Value2",..."ValueN" | Foreach-Object {Set-RetentionCompliancePolicy -Identity "Regulation 123 Compliance" -RemoveExchangeLocation $_}.
Esempio
Esempio 1
Set-RetentionCompliancePolicy -Identity "Regulation 123 Compliance" -AddExchangeLocation "Kitty Petersen" -AddSharePointLocation "https://contoso.sharepoint.com/sites/teams/finance" -RemovePublicFolderLocation All -Comment "Added new counsel, 9/9/14"In questo esempio vengono apportate le modifiche seguenti ai criteri di conservazione esistenti denominati "Conformità al regolamento 123":
- Aggiunge la cassetta postale per l'utente Kitty Petersen.
- Aggiunge il sito
https://contoso.sharepoint.com/sites/teams/financedi SharePoint Online. - Elimina le cartelle pubbliche.
- Aggiorna il commento.
Esempio 2
$stringJson = @"
[{
'EmailAddress': 'USSales@contoso.onmicrosoft.com',
'SiteId': '9b2a8116-b9ec-4e2c-bf31-7eaa83697c4b'
}]
"@
Set-RetentionCompliancePolicy -Identity "Sales Policy" -RemoveModernGroupLocation "USSales@contoso.onmicrosoft.com" -DeletedResources $stringJsonNell'esempio vengono rimossi il gruppo e il sito di Microsoft 365 eliminati dai criteri specificati. Le risorse eliminate vengono identificate usando l'indirizzo di posta elettronica del gruppo di Microsoft 365 e l'ID sito correlato.
IMPORTANTE: prima di eseguire questo comando, assicurarsi di leggere le informazioni di attenzione per il parametro DeletedResources sugli indirizzi SMTP duplicati.
Esempio 3
$stringJson = @"
[{
'EmailAddress': 'USSales@contoso.onmicrosoft.com',
'SiteId': '8b2a8345-b9ec-3b6a-bf31-6eaa83697c4b'
}]
"@
Set-RetentionCompliancePolicy -Identity "Tenant Level Policy" -AddModernGroupLocationException "USSales@contoso.onmicrosoft.com" -DeletedResources $stringJsonL'esempio esclude il sito e il gruppo di Microsoft 365 eliminati specificati dai criteri a livello di tenant specificati. Le risorse eliminate vengono identificate usando l'indirizzo di posta elettronica del gruppo di Microsoft 365 e l'ID sito correlato.
IMPORTANTE: prima di eseguire questo comando, assicurarsi di leggere le informazioni di attenzione per il parametro DeletedResources sugli indirizzi SMTP duplicati.
Esempio 4
$stringJson = @"
[{
'EmailAddress': 'USSales2@contoso.onmicrosoft.com',
'SiteId': '9b2a8116-b9ec-4e2c-bf31-7eaa83697c4b'
},
{
'EmailAddress': 'USSales2@contoso.onmicrosoft.com',
'SiteId': '4afb7116-b9ec-4b2c-bf31-4abb83697c4b'
}]
"@
Set-RetentionCompliancePolicy -Identity "Sales Policy" -RemoveModernGroupLocation "USSales2@contoso.onmicrosoft.com" -DeletedResources $stringJsonQuesto esempio è simile all'esempio 2, ad eccezione del fatto che sono state specificate più risorse eliminate.
IMPORTANTE: prima di eseguire questo comando, assicurarsi di leggere le informazioni di attenzione per il parametro DeletedResources sugli indirizzi SMTP duplicati.
Esempio 5
$stringJson = @"
[{
'EmailAddress': 'SalesUser@contoso.onmicrosoft.com'
}]
"@
Set-RetentionCompliancePolicy -Identity "Teams Chat Retention Policy" -AddTeamsChatLocationException "SalesUser@contoso.onmicrosoft.com" -DeletedResources $stringJsonIn questo esempio viene esclusa la cassetta postale o l'utente di posta elettronica eliminato temporaneamente specificato dai criteri di conservazione di Teams indicati. È possibile identificare le risorse eliminate usando la cassetta postale o l'indirizzo di posta elettronica dell'utente di posta elettronica.
IMPORTANTE: prima di eseguire questo comando, assicurarsi di leggere le informazioni di attenzione per il parametro DeletedResources sugli indirizzi SMTP duplicati.
Esempio 6
$stringJson = @"
[{
'EmailAddress': 'SalesUser1@contoso.onmicrosoft.com'
},
{
'EmailAddress': 'SalesUser2@contoso.onmicrosoft.com'
}]
"@
Set-RetentionCompliancePolicy -Identity "Teams Chat Retention Policy" -AddTeamsChatLocationException "SalesUser1@contoso.onmicrosoft.com", "SalesUser2@contoso.onmicrosoft.com" -DeletedResources $stringJsonQuesto esempio è simile all'esempio 5, ad eccezione del fatto che sono state specificate più risorse eliminate.
IMPORTANTE: prima di eseguire questo comando, assicurarsi di leggere le informazioni di attenzione per il parametro DeletedResources sugli indirizzi SMTP duplicati.
Le esclusioni dei criteri devono rimanere entro i limiti supportati per i criteri di conservazione: limiti per i criteri di conservazione di Microsoft 365 e i criteri delle etichette di conservazione
Parametri
-AddAdaptiveScopeLocation
Il parametro AddAdaptiveScopeLocation specifica il percorso dell'ambito adattivo da aggiungere ai criteri. È possibile creare ambiti adattivi usando il cmdlet New-AdaptiveScope. È possibile usare qualsiasi valore che identifichi in modo univoco l'ambito adattivo. Ad esempio:
- Nome
- Nome distinto (DN)
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-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:
- Il parametro ExchangeLocation specifica le cassette postali da includere nel criterio. I valori validi sono:
- Una cassetta postale
Il valore All per tutte le cassette postali. È possibile utilizzare questo valore esclusivamente da solo.
- Nome
- Nome
- Indirizzo di posta elettronica
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-AddExchangeLocationException
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:
- 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
Il valore All per tutte le cassette postali. È possibile utilizzare questo valore esclusivamente da solo.
- Nome
- Nome
- Indirizzo di posta elettronica
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-AddModernGroupLocation
Il parametro AddModernGroupLocation specifica il Gruppi di Microsoft 365 da aggiungere all'elenco dei Gruppi di Microsoft 365 inclusi quando non si usa il valore All per il parametro ModernGroupLocation.
È possibile usare qualsiasi valore che identifichi in modo univoco il gruppo di Microsoft 365. Ad esempio:
- Nome
- Nome
- Indirizzo di posta elettronica
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-AddModernGroupLocationException
Il parametro AddModernGroupLocationException specifica il Gruppi di Microsoft 365 da aggiungere all'elenco di Gruppi di Microsoft 365 esclusi quando si usa il valore All per il parametro ModernGroupLocation.
È possibile usare qualsiasi valore che identifichi in modo univoco il gruppo di Microsoft 365. Ad esempio:
- Nome
- Nome
- Indirizzo di posta elettronica
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-AddOneDriveLocation
Il parametro AddOneDriveLocation specifica il OneDrive for Business siti da aggiungere all'elenco dei siti inclusi quando non si usa il valore All per il parametro OneDriveLocation. È possibile identificare il sito mediante il relativo valore URL.
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-AddOneDriveLocationException
Questo parametro specifica il OneDrive for Business siti da aggiungere all'elenco dei siti esclusi quando si usa il valore All per il parametro OneDriveLocation. È possibile identificare il sito mediante il relativo valore URL.
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-AddPublicFolderLocation
Il parametro AddPublicFolderLocation specifica che si desidera aggiungere tutte le cartelle pubbliche ai criteri di conservazione. Si utilizza il valore All per questo parametro.
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-AddSharePointLocation
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 richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
I siti di SharePoint Online non possono essere aggiunti ai criteri finché non sono stati indicizzati.
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-AddSharePointLocationException
Questo parametro specifica i siti di SharePoint Online da aggiungere all'elenco dei siti esclusi quando 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 richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-AddSkypeLocation
Il parametro AddSkypeLocation consente di specificare il Skype for Business utenti online da aggiungere dall'elenco degli utenti Skype for Business Online inclusi.
È possibile utilizzare qualsiasi valore che identifichi l'utente in modo univoco. Ad esempio:
- Nome
- Nome
- Indirizzo di posta elettronica
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-AddSkypeLocationException
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-AddTeamsChannelLocation
Il parametro AddTeamsChannelLocation specifica i team da aggiungere ai criteri.
È possibile usare qualsiasi valore che identifichi in modo univoco il team. Ad esempio:
- Nome
- Indirizzo di posta elettronica
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-AddTeamsChannelLocationException
Il parametro AddTeamsChannelLocationException specifica i teams da aggiungere all'elenco di esclusione quando si usa il valore All per il parametro TeamsChannelLocation. È possibile usare qualsiasi valore che identifichi in modo univoco il team. Ad esempio:
- Nome
- Indirizzo di posta elettronica
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-AddTeamsChatLocation
Il parametro AddTeamsChatLocation specifica gli utenti di Teams da aggiungere ai criteri.
È possibile utilizzare qualsiasi valore che identifichi l'utente in modo univoco. Ad esempio:
- Nome
- Nome
- Indirizzo di posta elettronica
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-AddTeamsChatLocationException
Il parametro AddTeamsChatLocationException specifica gli utenti di Teams da aggiungere all'elenco di esclusione quando si usa il valore All per il parametro TeamsChatLocation. È possibile utilizzare qualsiasi valore che identifichi l'utente in modo univoco. Ad esempio:
- Nome
- Indirizzo di posta elettronica
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-Applications
Il parametro Applications specifica la destinazione quando Gruppi di Microsoft 365 sono inclusi nel criterio (il parametro ModernGroups è impostato). I valori validi sono:
-
Group:Exchangeper la cassetta postale connessa al gruppo di Microsoft 365. -
Group:SharePointper il sito di SharePoint connesso al gruppo di Microsoft 365. -
"Group:Exchange,SharePoint"sia per la cassetta postale che per il sito di SharePoint connessi al gruppo di Microsoft 365. - blank (
$null): questo è il valore predefinito ed è funzionalmente equivalente al valore"Group:Exchange,SharePoint". Per tornare al valore predefinito sia della cassetta postale sia del sito di SharePoint per i gruppi di Microsoft 365 selezionati, specificare"Group:Exchange,SharePoint".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-Comment
Il parametro Comment consente di specificare un commento facoltativo. Se si specifica un valore che contiene degli spazi, è necessario racchiuderlo tra virgolette ("); ad esempio: "Questa è una nota per amministratori".
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | 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-*) 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, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-DeletedResources
Il parametro DeletedResources consente di specificare l'utente eliminato del gruppo, della cassetta postale o della posta elettronica di Microsoft 365 da rimuovere o aggiungere come esclusione al rispettivo elenco di percorsi. Utilizzare questo parametro con i parametri AddModernGroupLocationException e RemoveModernGroupLocation per Gruppi di Microsoft 365 eliminati oppure con il parametro AddTeamsChatLocationException per cassette postali o utenti di posta elettronica eliminati.
Un valore valido è una stringa JSON. Per esempi di sintassi e utilizzo di questo parametro, vedere la sezione Esempi.
ATTENZIONE: quando si usa un indirizzo SMTP con questo parametro, tenere presente che lo stesso indirizzo potrebbe essere usato anche per altre cassette postali o utenti di posta elettronica. Per verificare la presenza di altre cassette postali o utenti di posta elettronica con lo stesso indirizzo SMTP, usare il comando seguente e sostituire user@example.com con l'indirizzo SMTP per verificare: Get-Recipient -IncludeSoftDeletedRecipients user@contoso.com |Select-Object DisplayName, EmailAddresses, Description, Alias, RecipientTypeDetails, WhenSoftDeleted
Per impedire l'esclusione di cassette postali attive o utenti di posta elettronica con lo stesso indirizzo SMTP, inserire la cassetta postale in Blocco per controversia legale prima di eseguire il comando con il parametro DeletedResources.
Per altre informazioni sullo scenario del gruppo di Microsoft 365 eliminato, vedere Altre informazioni sull'eliminazione moderna dei gruppi in conservazione.
Per altre informazioni sullo scenario delle cassette postali inattive, vedere Informazioni sulle cassette postali inattive.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-Enabled
Il parametro Enabled consente di specificare se il criterio è abilitato. I valori validi sono:
- $true: i criteri sono abilitati. Questo è il valore predefinito.
- $true: il criterio è abilitato. Questo è il valore predefinito.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-EnforceSimulationPolicy
Il parametro EnforceSimulationPolicy consente di specificare se applicare un criterio di simulazione come criterio attivo. I valori validi sono:
- $true: applicare i criteri di simulazione come criteri attivi.
- $false: non applicare i criteri di simulazione come criteri attivi. Questo è il valore predefinito.
Per altre informazioni sulla modalità di simulazione, vedere Informazioni sulla modalità di simulazione.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | 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.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-Identity
Il parametro Identity consente di specificare i criteri di conservazione che si desidera modificare. È possibile utilizzare qualsiasi valore che identifichi il criterio in modo univoco. Ad esempio:
- Nome
- Nome distinto (DN)
- GUID
| Tipo: | PolicyIdParameter |
| Posizione: | 1 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-PolicyRBACScopes
Nota: Amministrazione unità non sono attualmente supportate, quindi questo parametro non funziona. Le informazioni presentate qui sono a scopo informativo quando viene rilasciato il supporto per le unità amministrative.
Il parametro PolicyRBACScopes consente di specificare le unità amministrative da assegnare ai criteri. Un valore valido è il Microsoft Entra ObjectID (valore GUID) dell'unità amministrativa. È possibile specificare più valori separati da virgole.
Le unità amministrative sono disponibili solo in Microsoft Entra ID P1 o P2. È possibile creare e gestire unità amministrative in Microsoft Graph PowerShell.
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-PolicyTemplateInfo
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Tipo: | PswsHashtable |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-PriorityCleanup
{{ Fill PriorityCleanup Description }}
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-RemoveAdaptiveScopeLocation
Il parametro RemoveAdaptiveScopeLocation specifica il percorso dell'ambito adattivo da rimuovere dai criteri. È possibile creare ambiti adattivi usando il cmdlet New-AdaptiveScope. È possibile usare qualsiasi valore che identifichi in modo univoco l'ambito adattivo. Ad esempio:
- Nome
- Nome distinto (DN)
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | 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.
È possibile utilizzare qualsiasi valore che identifichi la cassetta postale in modo univoco. Ad esempio:
- Nome
- Nome
- Indirizzo di posta elettronica
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-RemoveExchangeLocationException
Il parametro RemoveExchangeLocationException consente di specificare le cassette postali da rimuovere dall'elenco delle cassette postali escluse quando si usa il valore All per il parametro ExchangeLocation.
È possibile utilizzare qualsiasi valore che identifichi la cassetta postale in modo univoco. Ad esempio:
- Nome
- Nome
- Indirizzo di posta elettronica
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-RemoveModernGroupLocation
Il parametro RemoveModernGroupLocation consente di specificare il Gruppi di Microsoft 365 da rimuovere dall'elenco dei gruppi inclusi quando non si usa il valore All per il parametro ModernGroupLocation.
È possibile usare qualsiasi valore che identifichi in modo univoco il gruppo di Microsoft 365. Ad esempio:
- Nome
- Nome
- Indirizzo di posta elettronica
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-RemoveModernGroupLocationException
Il parametro RemoveModernGroupLocationException specifica il Gruppi di Microsoft 365 da rimuovere dall'elenco dei gruppi esclusi quando si usa il valore All per il parametro ModernGroupLocation.
È possibile usare qualsiasi valore che identifichi in modo univoco il gruppo di Microsoft 365. Ad esempio:
- Nome
- Nome
- Indirizzo di posta elettronica
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-RemoveOneDriveLocation
Il parametro RemoveOneDriveLocation specifica i siti OneDrive for Business da rimuovere dall'elenco dei siti inclusi quando non si usa il valore All per il parametro OneDriveLocation. È possibile identificare il sito mediante il relativo valore URL.
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-RemoveOneDriveLocationException
Questo parametro specifica il OneDrive for Business siti da rimuovere dall'elenco dei siti esclusi quando si usa il valore All per il parametro OneDriveLocation. È possibile identificare il sito mediante il relativo valore URL.
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-RemovePublicFolderLocation
Il parametro RemovePublicFolderLocation specifica che si desidera rimuovere tutte le cartelle pubbliche dai criteri di conservazione. Si utilizza il valore All per questo parametro.
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-RemoveSharePointLocation
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 richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-RemoveSharePointLocationException
Questo parametro specifica i siti di SharePoint Online da rimuovere dall'elenco dei siti esclusi quando 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 richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-RemoveSkypeLocation
Il parametro RemoveSkypeLocation consente di specificare il Skype for Business utenti online da rimuovere dall'elenco degli utenti Skype for Business Online inclusi.
È possibile utilizzare qualsiasi valore che identifichi l'utente in modo univoco. Ad esempio:
- Nome
- Nome
- Indirizzo di posta elettronica
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-RemoveSkypeLocationException
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-RemoveTeamsChannelLocation
Il parametro RemoveTeamsChannelLocation specifica i team da rimuovere dai criteri.
È possibile usare qualsiasi valore che identifichi in modo univoco il team. Ad esempio:
- Nome
- Indirizzo di posta elettronica
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-RemoveTeamsChannelLocationException
Il parametro RemoveTeamsChannelLocationException specifica teams da rimuovere dall'elenco di esclusione quando si usa il valore All per il parametro TeamsChannelLocation. È possibile usare qualsiasi valore che identifichi in modo univoco il team. Ad esempio:
- Nome
- Indirizzo di posta elettronica
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-RemoveTeamsChatLocation
Il parametro RemoveTeamsChatLocation specifica gli utenti di Teams da rimuovere dai criteri.
È possibile utilizzare qualsiasi valore che identifichi l'utente in modo univoco. Ad esempio:
- Nome
- Nome
- Indirizzo di posta elettronica
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-RemoveTeamsChatLocationException
Il parametro RemoveTeamsChatLocationException specifica gli utenti di Teams da rimuovere dall'elenco di esclusione quando si usa il valore All per il parametro TeamsChatLocation. È possibile utilizzare qualsiasi valore che identifichi l'utente in modo univoco. Ad esempio:
- Nome
- Indirizzo di posta elettronica
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
| Tipo: | MultiValuedProperty |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-RestrictiveRetention
Il parametro RestrictiveRetention consente di specificare se blocco di conservazione è abilitato per un criterio di conservazione o un criterio di etichetta di conservazione. I valori validi sono:
- $true: blocco di conservazione abilitato per i criteri. Nessuno (incluso un amministratore) può disattivare i criteri o renderli meno restrittivi.
- $false: blocco di conservazione non è abilitato per i criteri. Questo è il valore predefinito.
Una volta bloccato un criterio, nessun utente può disattivarlo o rimuoverne il contenuto. Non è possibile modificare o eliminare contenuto soggetto ai criteri durante il periodo di conservazione. L'unico modo per modificare i criteri di conservazione è aggiungere contenuto o estenderne la durata. Un criterio bloccato può essere aumentato o esteso, ma non può essere ridotto, disabilitato o disattivato.
Pertanto, prima di bloccare un criterio per la conservazione, è fondamentale comprendere i requisiti di conformità dell'organizzazione e non bloccare un criterio fino a quando non si è certi che sia ciò di cui si ha bisogno.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-RetryDistribution
L'opzione RetryDistribution specifica se ridistribuire i criteri in tutte le posizioni di Exchange Online e SharePoint Online. Con questa opzione non è necessario specificare alcun valore.
I percorsi le cui distribuzioni iniziali hanno avuto esito positivo non sono inclusi nel tentativo. Quando si utilizza questa opzione, vengono segnalati gli errori di distribuzione dei criteri.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-StartSimulation
Il parametro StartSimulation consente di specificare se avviare la simulazione per un criterio creato in modalità di simulazione. I valori validi sono:
- $true: avviare la simulazione.
- $false: non avviare la simulazione. Questo è il valore predefinito.
Per altre informazioni sulla modalità di simulazione, vedere Informazioni sulla modalità di simulazione.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |
-WhatIf
Il parametro WhatIf non funziona in PowerShell per sicurezza e conformità.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
| Si applica a: | Security & Compliance |