Condividi tramite


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 $stringJson

Nell'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 $stringJson

L'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 $stringJson

Questo 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 $stringJson

In 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 $stringJson

Questo 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:Exchange per la cassetta postale connessa al gruppo di Microsoft 365.
  • Group:SharePoint per 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