Set-AppRetentionCompliancePolicy

Modulo:
Exchange PowerShell

Questo cmdlet è disponibile solo in PowerShell per sicurezza e conformità. Per altre informazioni, vedere PowerShell per sicurezza e conformità.

Usare il Set-AppRetentionCompliancePolicy per modificare i criteri di conformità della conservazione delle app.

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

Sintassi

Identity (Impostazione predefinita) 

Set-AppRetentionCompliancePolicy
    [-Identity] <PolicyIdParameter>
    [-AddExchangeLocation <MultiValuedProperty>]
    [-AddExchangeLocationException <MultiValuedProperty>]
    [-AddModernGroupLocation <MultiValuedProperty>]
    [-AddModernGroupLocationException <MultiValuedProperty>]
    [-Applications <String[]>]
    [-Comment <String>]
    [-Confirm]
    [-DeletedResources <String>]
    [-Enabled <Boolean>]
    [-Force]
    [-PolicyRBACScopes <MultiValuedProperty>]
    [-RemoveExchangeLocation <MultiValuedProperty>]
    [-RemoveExchangeLocationException <MultiValuedProperty>]
    [-RemoveModernGroupLocation <MultiValuedProperty>]
    [-RemoveModernGroupLocationException <MultiValuedProperty>]
    [-RestrictiveRetention <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

AdaptiveScopeLocation 

Set-AppRetentionCompliancePolicy
    [-Identity] <PolicyIdParameter>
    [-AddAdaptiveScopeLocation <MultiValuedProperty>]
    [-Applications <String[]>]
    [-Comment <String>]
    [-Confirm]
    [-DeletedResources <String>]
    [-Enabled <Boolean>]
    [-Force]
    [-RemoveAdaptiveScopeLocation <MultiValuedProperty>]
    [-WhatIf]
    [<CommonParameters>]

DisableRestrictiveRetentionParameterSet 

Set-AppRetentionCompliancePolicy
    [-Identity] <PolicyIdParameter>
    [-Confirm]
    [-DeletedResources <String>]
    [-WhatIf]
    [<CommonParameters>]

InformationBarrierDefault 

Set-AppRetentionCompliancePolicy
    [-Identity] <PolicyIdParameter>
    [-Confirm]
    [-DeletedResources <String>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

OrganizationSegmentsDefault 

Set-AppRetentionCompliancePolicy
    [-Identity] <PolicyIdParameter>
    [-Confirm]
    [-DeletedResources <String>]
    [-WhatIf]
    [<CommonParameters>]

RetryDistributionParameterSet 

Set-AppRetentionCompliancePolicy
    [-Identity] <PolicyIdParameter>
    [-Confirm]
    [-RetryDistribution]
    [-WhatIf]
    [<CommonParameters>]

TeamLocation 

Set-AppRetentionCompliancePolicy
    [-Identity] <PolicyIdParameter>
    [-Comment <String>]
    [-Confirm]
    [-DeletedResources <String>]
    [-Enabled <Boolean>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

Descrizione

I cmdlet *-AppRetentionCompliance* vengono usati per i criteri con ambiti dei criteri adattivi e tutti i criteri statici nei percorsi descritti in Cmdlet di conservazione per i percorsi più recenti. È possibile impostare l'elenco degli ambiti inclusi o esclusi solo per tutti i carichi di lavoro inclusi, il che significa che probabilmente sarà necessario creare un criterio per carico di lavoro.

I cmdlet *-RetentionCompliance* continuano a supportare principalmente le posizioni descritte in Cmdlet di conservazione per le posizioni meno recenti.

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.

Esempio

Esempio 1

Set-AppRetentionCompliancePolicy -Identity "Regulation 563 Marketing" -Applications "User:MicrosoftTeams","Group:MicrosoftTeams,VivaEngage" -AddExchangeLocation "Scott Smith" -Comment "Added new counsel, 9/9/21"

In questo esempio viene aggiunto un nuovo utente ai criteri di conservazione dell'ambito statico esistenti denominato Regulation 563 Marketing configurati per i messaggi dei canali privati di Teams.

Esempio 2

$stringJson = @"
[{
     'EmailAddress': 'SalesUser@contoso.onmicrosoft.com'
}]
"@
Set-AppRetentionCompliancePolicy -Identity "Teams Private Channel Retention Policy" -AddExchangeLocationException "SalesUser@contoso.onmicrosoft.com" -DeletedResources $stringJson

Questo esempio esclude l'utente della cassetta postale o della posta elettronica eliminato temporaneamente specificato dai criteri di conservazione configurati per i messaggi del canale privato di Teams. È possibile identificare le risorse eliminate usando la cassetta postale o l'indirizzo di posta elettronica dell'utente.

IMPORTANTE: prima di eseguire questo comando, assicurarsi di leggere le informazioni di avvertenza per il parametro DeletedResources relative agli indirizzi SMTP duplicati.

Le esclusioni dei criteri devono rimanere entro i limiti supportati per i criteri di conservazione. Per altre informazioni, vedere Limiti per i criteri di conservazione di Microsoft 365 e i criteri delle etichette di conservazione.

Esempio 3

$stringJson = @"
[{
     'EmailAddress': 'SalesUser1@contoso.onmicrosoft.com'
},
{
     'EmailAddress': 'SalesUser2@contoso.onmicrosoft.com'
}]
"@
Set-AppRetentionCompliancePolicy -Identity "Teams Private Chat Retention Policy" -AddExchangeLocationException "SalesUser1@contoso.onmicrosoft.com", "SalesUser2@contoso.onmicrosoft.com" -DeletedResources $stringJson

Questo esempio è simile all'esempio 2, tranne per il fatto che sono specificate più risorse eliminate.

IMPORTANTE: prima di eseguire questo comando, assicurarsi di leggere le informazioni di avvertenza per il parametro DeletedResources relative agli indirizzi SMTP duplicati.

Parametri

-AddAdaptiveScopeLocation

Applicabile: Sicurezza & conformità

Il parametro AddAdaptiveScopeLocation consente di specificare il percorso dell'ambito adattivo da aggiungere al criterio. Gli ambiti adattivi vengono creati 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".

Proprietà dei parametri

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

Set di parametri

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

-AddExchangeLocation

Applicabile: Sicurezza & conformità

Il parametro AddExchangeLocation consente di specificare le cassette postali da aggiungere all'elenco delle cassette postali incluse quando non si utilizza 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".

Proprietà dei parametri

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

Set di parametri

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

-AddExchangeLocationException

Applicabile: Sicurezza & conformità

Il parametro AddExchangeLocationException consente di specificare 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".

Proprietà dei parametri

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

Set di parametri

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

-AddModernGroupLocation

Applicabile: Sicurezza & conformità

Il parametro AddModernGroupLocation consente di specificare i 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".

Proprietà dei parametri

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

Set di parametri

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

-AddModernGroupLocationException

Applicabile: Sicurezza & conformità

Il parametro AddModernGroupLocationException consente di specificare i Gruppi di Microsoft 365 da aggiungere all'elenco dei 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".

Proprietà dei parametri

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

Set di parametri

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

-Applications

Applicabile: Sicurezza & conformità

Il parametro Applications consente di specificare le applicazioni da includere nel criterio.

Questo parametro usa la sintassi seguente: "LocationType:App1,LocationType:App2,...LocationType:AppN

LocationType è un utente o un gruppo.

App è un valore supportato, come illustrato negli esempi seguenti.

  • App di Microsoft 365: Ad esempio:

    "User:Exchange,User:OneDriveForBusiness,Group:Exchange,Group:SharePoint" o "User:MicrosoftTeams","User:VivaEngage"

  • Esperienze di Microsoft Copilot: attualmente in anteprima. È necessario utilizzare tutti i valori seguenti contemporaneamente:

    "User:M365Copilot,CopilotForSecurity,CopilotinFabricPowerBI,CopilotStudio,CopilotinBusinessApplicationplatformsSales,SQLCopilot"

    Nota: anche se è necessario usare CopilotinBusinessApplicationplatformsSales and SQLCopilot, questi valori sono attualmente irrilevanti.

  • App AI aziendali: attualmente in anteprima. È necessario utilizzare tutti i valori seguenti contemporaneamente:

    "User:Entrabased3PAIApps,ChatGPTEnterprise,AzureAIServices"

  • Altre app di intelligenza artificiale: attualmente in anteprima. È necessario utilizzare tutti i valori seguenti contemporaneamente:

    "User:CloudAIAppChatGPTConsumer,CloudAIAppGoogleGemini,BingConsumer,DeepSeek"

Proprietà dei parametri

Tipo:

String[]

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

Set di parametri

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

-Comment

Applicabile: Sicurezza & conformità

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".

Proprietà dei parametri

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

Set di parametri

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

-Confirm

Applicabile: Sicurezza & conformità

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

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

Proprietà dei parametri

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

Set di parametri

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

-DeletedResources

Applicabile: Sicurezza & conformità

Il parametro DeletedResources consente di specificare la cassetta postale o l'utente di posta elettronica eliminato da aggiungere come esclusione al rispettivo elenco di posizioni. Usare questo parametro con il parametro AddTeamsChatLocationException per le cassette postali eliminate o gli utenti di posta elettronica che devono essere esclusi da un criterio di conservazione solo di Teams.

Un valore valido è una stringa JSON. Fare riferimento alla sezione Esempi per esempi di sintassi e utilizzo di questo parametro.

Per informazioni sullo scenario di cassetta postale inattiva, vedere Informazioni sulle cassette postali inattive.

ATTENZIONE: questo parametro utilizza l'indirizzo SMTP della cassetta postale o dell'utente di posta elettronica eliminato, che potrebbe essere specificato anche per altre cassette postali o utenti di posta. Se si usa questo parametro senza prima eseguire ulteriori passaggi, vengono escluse anche altre cassette postali e utenti di posta elettronica con lo stesso indirizzo SMTP nel criterio di conservazione. Per verificare la presenza di altre cassette postali o utenti di posta elettronica con lo stesso indirizzo SMTP, usare il comando seguente e sostituirlo user@contoso.com con l'indirizzo SMTP per controllare: Get-Recipient -IncludeSoftDeletedRecipients user@contoso.com | Select-Object DisplayName, EmailAddresses, Description, Alias, RecipientTypeDetails, WhenSoftDeleted

Per evitare l'esclusione delle cassette postali attive o degli utenti di posta elettronica con lo stesso indirizzo SMTP, impostare la cassetta postale in attesa per controversia legale prima di eseguire il comando con il parametro DeletedResources.

Proprietà dei parametri

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

Set di parametri

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

-Enabled

Applicabile: Sicurezza & conformità

Il parametro Enabled abilita o disabilita il criterio. I valori validi sono:

  • $true: Il criterio è abilitato. Questo è il valore predefinito.
  • $true: il criterio è abilitato. Questo è il valore predefinito.

Proprietà dei parametri

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

Set di parametri

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

-Force

Applicabile: Sicurezza & conformità

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

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

Proprietà dei parametri

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

Set di parametri

Identity
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
AdaptiveScopeLocation
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
TeamLocation
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
InformationBarrierDefault
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Identity

Applicabile: Sicurezza & conformità

Il parametro Identity consente di specificare i criteri di conformità della conservazione delle app che si desidera modificare. È possibile utilizzare qualsiasi valore che identifichi il criterio in modo univoco. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • GUID

Proprietà dei parametri

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

Set di parametri

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

-PolicyRBACScopes

Applicabile: Sicurezza & conformità

Nota: le unità di amministrazione non sono attualmente supportate, quindi questo parametro non è funzionale. 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 al criterio. Un valore valido è l'ObjectID di Microsoft Entra (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.

Proprietà dei parametri

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

Set di parametri

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

-RemoveAdaptiveScopeLocation

Applicabile: Sicurezza & conformità

Il parametro RemoveAdaptiveScopeLocation specifica il percorso dell'ambito adattivo da rimuovere dal criterio. Gli ambiti adattivi vengono creati 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".

Proprietà dei parametri

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

Set di parametri

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

-RemoveExchangeLocation

Applicabile: Sicurezza & conformità

Il parametro RemoveExchangeLocation consente di specificare le cassette postali da rimuovere dall'elenco delle cassette postali incluse quando non si utilizza 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".

Proprietà dei parametri

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

Set di parametri

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

-RemoveExchangeLocationException

Applicabile: Sicurezza & conformità

Il parametro RemoveExchangeLocationException consente di specificare le cassette postali da rimuovere dall'elenco delle cassette postali escluse quando si utilizza 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".

Proprietà dei parametri

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

Set di parametri

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

-RemoveModernGroupLocation

Applicabile: Sicurezza & conformità

Il parametro RemoveModernGroupLocation consente di specificare i 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".

Proprietà dei parametri

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

Set di parametri

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

-RemoveModernGroupLocationException

Applicabile: Sicurezza & conformità

Il parametro RemoveModernGroupLocationException consente di specificare i 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".

Proprietà dei parametri

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

Set di parametri

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

-RestrictiveRetention

Applicabile: Sicurezza & conformità

Il parametro RestrictiveRetention consente di specificare se il blocco di conservazione è abilitato per il criterio. I valori validi sono:

  • $true: il blocco di conservazione è abilitato per il criterio. Nessuno, incluso un amministratore, può disattivare il criterio o renderlo meno restrittivo.
  • $false: il blocco di conservazione non è abilitato per il criterio. Questo è il valore predefinito.

Dopo che un criterio è stato bloccato, nessuno può disattivarlo o disabilitarlo o rimuovere app da tale criterio. Gli unici modi per modificare il criterio sono aggiungervi app 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, è fondamentale comprendere i requisiti di conformità dell'organizzazione e non bloccare un criterio finché non si è certi che sia quello necessario.

Proprietà dei parametri

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

Set di parametri

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

-RetryDistribution

Applicabile: Sicurezza & conformità

L'opzione RetryDistribution consente di specificare se ridistribuire il criterio in tutte le posizioni. 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.

Nota: poiché il processo di ripetizione dei tentativi di distribuzione è un'operazione significativa, eseguirlo solo se necessario e per un criterio alla volta. Non è progettato per essere eseguito ogni volta che si aggiorna un criterio. Se si esegue uno script per aggiornare più criteri, attendere che la distribuzione dei criteri abbia esito positivo prima di eseguire nuovamente il comando per il criterio successivo.

Proprietà dei parametri

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

Set di parametri

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

-WhatIf

Applicabile: Sicurezza & conformità

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

Proprietà dei parametri

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

Set di parametri

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

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.