Set-DlpCompliancePolicy

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
Security & Compliance

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

Usare il cmdlet Set-DlpCompliancePolicy per modificare i criteri di prevenzione della perdita dei dati nel Portale di conformità di Microsoft Purview.

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

Sintassi

Set-DlpCompliancePolicy
   [-Identity] <PolicyIdParameter>
   [-AddEndpointDlpLocation <MultiValuedProperty>]
   [-AddEndpointDlpLocationException <MultiValuedProperty>]
   [-AddExchangeLocation <MultiValuedProperty>]
   [-AddOneDriveLocation <MultiValuedProperty>]
   [-AddOneDriveLocationException <MultiValuedProperty>]
   [-AddOnPremisesScannerDlpLocation <MultiValuedProperty>]
   [-AddOnPremisesScannerDlpLocationException <MultiValuedProperty>]
   [-AddPowerBIDlpLocation <MultiValuedProperty>]
   [-AddPowerBIDlpLocationException <MultiValuedProperty>]
   [-AddSharePointLocation <MultiValuedProperty>]
   [-AddSharePointLocationException <MultiValuedProperty>]
   [-AddTeamsLocation <MultiValuedProperty>]
   [-AddTeamsLocationException <MultiValuedProperty>]
   [-AddThirdPartyAppDlpLocation <MultiValuedProperty>]
   [-AddThirdPartyAppDlpLocationException <MultiValuedProperty>]
   [-Comment <String>]
   [-Confirm]
   [-ExceptIfOneDriveSharedBy <RecipientIdParameter[]>]
   [-ExceptIfOneDriveSharedByMemberOf <RecipientIdParameter[]>]
   [-ExchangeSenderMemberOf <RecipientIdParameter[]>]
   [-ExchangeSenderMemberOfException <RecipientIdParameter[]>]
   [-Force]
   [-Mode <PolicyMode>]
   [-OneDriveSharedBy <RecipientIdParameter[]>]
   [-OneDriveSharedByMemberOf <RecipientIdParameter[]>]
   [-PolicyRBACScopes <MultiValuedProperty>]
   [-PolicyTemplateInfo <PswsHashtable>]
   [-Priority <Int32>]
   [-RemoveEndpointDlpLocation <MultiValuedProperty>]
   [-RemoveEndpointDlpLocationException <MultiValuedProperty>]
   [-RemoveExchangeLocation <MultiValuedProperty>]
   [-RemoveOneDriveLocation <MultiValuedProperty>]
   [-RemoveOneDriveLocationException <MultiValuedProperty>]
   [-RemoveOnPremisesScannerDlpLocation <MultiValuedProperty>]
   [-RemoveOnPremisesScannerDlpLocationException <MultiValuedProperty>]
   [-RemovePowerBIDlpLocation <MultiValuedProperty>]
   [-RemovePowerBIDlpLocationException <MultiValuedProperty>]
   [-RemoveSharePointLocation <MultiValuedProperty>]
   [-RemoveSharePointLocationException <MultiValuedProperty>]
   [-RemoveTeamsLocation <MultiValuedProperty>]
   [-RemoveTeamsLocationException <MultiValuedProperty>]
   [-RemoveThirdPartyAppDlpLocation <MultiValuedProperty>]
   [-RemoveThirdPartyAppDlpLocationException <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]
Set-DlpCompliancePolicy
   [-Identity] <PolicyIdParameter>
   [-RetryDistribution]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

Per usare questo cmdlet in Security & Compliance PowerShell, è 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-DlpCompliancePolicy -Identity "Main PII" -RemoveExchangeLocation $_}.

Esempio

Esempio 1

Set-DlpCompliancePolicy -Identity "Main PII" -AddSharePointLocation "https://my.url1","https://my.url2" -AddOneDriveLocation "https://my.url3","https://my.url4"

In questo esempio vengono aggiunti gli URL specificati ai percorsi di SharePoint Online e OneDrive for Business per il criterio DLP denominato Informazioni personali principali senza influire sui valori URL esistenti.

Esempio 2

Set-DlpCompliancePolicy -Identity MainPII -Mode Disable

In questo esempio viene disabilitato il criterio "MainPII".

Esempio 3

Set-DlpCompliancePolicy -Identity "PowerBIPolicy" -AddPowerBILocation "workspaceID1","workspaceID2","workspaceID3"

Questo esempio aggiunge gli ID dell'area di lavoro specificati al percorso di Power BI per il criterio DLP denominato PowerBIPolicy senza influire sugli ID dell'area di lavoro esistenti.

Parametri

-AddEndpointDlpLocation

Nota: questo parametro richiede l'appartenenza ai ruoli Amministratore conformità o Amministratore dati conformità in Azure Active Directory.

Il parametro AddEndpointDLPLocation specifica gli account utente da aggiungere all'elenco degli account inclusi per Endpoint DLP se è stato usato il valore All per il parametro EndpointDLPLocation. L'account viene identificato in base al nome o all'indirizzo di posta elettronica.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Per altre informazioni sulla prevenzione della perdita dei dati degli endpoint, vedere Informazioni sulla prevenzione della perdita di dati degli endpoint.

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

-AddEndpointDlpLocationException

Nota: questo parametro richiede l'appartenenza ai ruoli Amministratore conformità o Amministratore dati conformità in Azure Active Directory.

Il parametro AddEndpointDlpLocationException specifica gli account utente da aggiungere all'elenco degli account esclusi per Endpoint DLP se è stato usato il valore All per il parametro EndpointDLPLocation. L'account viene identificato in base al nome o all'indirizzo di posta elettronica.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Per altre informazioni sulla prevenzione della perdita dei dati degli endpoint, vedere Informazioni sulla prevenzione della perdita di dati degli endpoint.

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

-AddExchangeLocation

Il parametro AddExchangeLocation aggiunge messaggi di posta elettronica ai criteri DLP se non sono già inclusi. Il valore valido per questo parametro è All.

Se il criterio non include già messaggi di posta elettronica (nell'output del cmdlet Get-DlpCompliancePolicy il valore della proprietà ExchangeLocation è vuoto), è possibile usare questo parametro nelle procedure seguenti:

  • Se si usa -AddExchangeLocation All da solo, il criterio si applica alla posta elettronica per tutti gli utenti.

  • Per includere la posta elettronica di membri del gruppo specifici nei criteri, usare -AddExchangeLocation All con il parametro ExchangeSenderMemberOf nello stesso comando. Nei criteri è incluso solo il messaggio di posta elettronica dei membri dei gruppi specificati.

  • Per escludere dal criterio la posta elettronica di membri del gruppo specifici, usare -AddExchangeLocation All con il parametro ExchangeSenderMemberOfException nello stesso comando. Solo i messaggi di posta elettronica dei membri dei gruppi specificati vengono esclusi dai criteri.

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

-AddOneDriveLocation

Il parametro AddOneDriveLocation aggiunge OneDrive for Business siti ai criteri DLP, se non sono già inclusi. Il valore valido per questo parametro è All.

Se il criterio non include già OneDrive for Business siti (nell'output del cmdlet Get-DlpCompliancePolicy il valore della proprietà OneDriveLocation è vuoto), è possibile usare questo parametro nelle procedure seguenti:

  • Se si usa -AddOneDriveLocation All da solo, il criterio si applica a tutti i siti OneDrive for Business.

  • Per includere i siti di account OneDrive specifici nei criteri, usare -AddOneDriveLocation All e il parametro OneDriveSharedBy per specificare gli utenti. Solo i siti degli utenti specificati sono inclusi nei criteri.

  • Per includere i siti di membri del gruppo specifici nei criteri, usare -AddOneDriveLocation All e il parametro OneDriveSharedByMemberOf per specificare i gruppi. Solo i siti dei membri dei gruppi specificati sono inclusi nei criteri.

  • Per escludere i siti di account OneDrive specifici dai criteri, usare -AddOneDriveLocation All e il parametro ExceptIfOneDriveSharedBy per specificare gli utenti. Solo i siti degli utenti specificati vengono esclusi dai criteri.

  • Per escludere i siti di membri del gruppo specifici dai criteri, usare -AddOneDriveLocation All e il parametro ExceptIfOneDriveSharedByMemberOf per specificare i gruppi. Solo i siti dei membri dei gruppi specificati vengono esclusi dai criteri.

Non è possibile specificare inclusioni ed esclusioni nello stesso criterio.

Nota: sebbene questo parametro accetti gli URL del sito, non specificare i valori degli URL del sito. Usare invece i parametri OneDriveSharedBy, ExceptIfOneDriveShareBy, OneDriveSharedByMemberOf e ExceptIfOneDriveSharedByMemberOf. Nelle impostazioni dei criteri DLP nel portale di Microsoft 365 Defender non è possibile specificare i siti da includere o escludere in base all'URL. È possibile specificare siti da includere o escludere solo da utenti o gruppi.

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

-AddOneDriveLocationException

Non usare questo parametro. Per una spiegazione, vedere il parametro AddOneDriveLocation.

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

-AddOnPremisesScannerDlpLocation

Il parametro AddOnPremisesScannerDlpLocation specifica le condivisioni file locali e le raccolte documenti e le cartelle di SharePoint da aggiungere all'elenco dei repository inclusi se è stato utilizzato il valore All per il parametro OnPremisesScannerDlpLocation.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Per altre informazioni sullo scanner locale DLP, vedere Informazioni sullo scanner locale per la prevenzione della perdita dei dati.

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

-AddOnPremisesScannerDlpLocationException

Il parametro AddOnPremisesScannerDlpLocationExclusion specifica le condivisioni file locali e le raccolte documenti e le cartelle di SharePoint da aggiungere all'elenco dei repository esclusi se è stato utilizzato il valore All per il parametro OnPremisesScannerDlpLocation.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Per altre informazioni sullo scanner locale DLP, vedere Informazioni sullo scanner locale per la prevenzione della perdita dei dati.

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

-AddPowerBIDlpLocation

Il parametro AddPowerBIDlpLocation specifica gli ID dell'area di lavoro di Power BI da aggiungere all'elenco delle aree di lavoro incluse se è stato usato il valore All per il parametro PowerBIDlpLocation. Sono consentite solo le aree di lavoro ospitate nelle capacità Premium Gen2.

È possibile trovare l'ID dell'area di lavoro usando una delle procedure seguenti:

  • Nel portale Amministrazione scegliere Aree di lavoro, quindi selezionare un'area di lavoro e scegliere > Altre opzioni (...) > Dettagli.
  • Esaminare l'URL di un'area di lavoro selezionata.
  • In PowerShell usare il comando Get-PowerBIWorkspace.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

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

-AddPowerBIDlpLocationException

Il parametro AddPowerBIDlpLocationException specifica gli ID dell'area di lavoro di Power BI da aggiungere all'elenco delle aree di lavoro escluse se è stato usato il valore All per il parametro PowerBIDlpLocation. Sono consentite solo le aree di lavoro ospitate nelle capacità Premium Gen2.

È possibile trovare l'ID dell'area di lavoro usando una delle procedure seguenti:

  • Nel portale Amministrazione scegliere Aree di lavoro, quindi selezionare un'area di lavoro e scegliere > Altre opzioni (...) > Dettagli.
  • Esaminare l'URL di un'area di lavoro selezionata.
  • In PowerShell usare il comando Get-PowerBIWorkspace.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

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

-AddSharePointLocation

Il parametro AddSharePointLocation specifica i siti di SharePoint Online da aggiungere all'elenco dei siti inclusi se è stato usato il valore All per il parametro SharePointLocation. È possibile identificare il sito mediante il relativo valore URL.

Non è possibile aggiungere siti di SharePoint Online ai criteri finché non sono stati indicizzati.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

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

-AddSharePointLocationException

Il parametro AddSharePointLocationException specifica i siti di SharePoint Online da aggiungere all'elenco dei siti esclusi se è stato utilizzato il valore All per il parametro SharePointLocation. È possibile identificare il sito mediante il relativo valore URL.

Non è possibile aggiungere siti di SharePoint Online ai criteri finché non sono stati indicizzati.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

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

-AddTeamsLocation

Il parametro AddTeamsLocation consente di specificare gli account, i gruppi di distribuzione o i gruppi di sicurezza abilitati alla posta elettronica da aggiungere all'elenco dei messaggi di chat e canale di Teams inclusi se è stato usato il valore All per il parametro TeamsLocation. Le voci vengono identificate in base all'indirizzo di posta elettronica o al nome dell'account, del gruppo di distribuzione o del gruppo di sicurezza abilitato alla posta elettronica.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

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

-AddTeamsLocationException

Il parametro AddTeamsLocationException specifica gli account, i gruppi di distribuzione o i gruppi di sicurezza abilitati alla posta elettronica da aggiungere all'elenco dei messaggi di chat e canale di Teams esclusi se è stato usato il valore All per il parametro TeamsLocation. Le voci vengono identificate in base all'indirizzo di posta elettronica o al nome dell'account, del gruppo di distribuzione o del gruppo di sicurezza abilitato alla posta elettronica.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

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

-AddThirdPartyAppDlpLocation

Nota: questo parametro richiede l'appartenenza ai ruoli Amministratore conformità o Amministratore dati conformità in Azure Active Directory.

Il parametro AddThirdPartyAppDlpLocation specifica le app cloud non Microsoft da aggiungere all'elenco delle app incluse se è stato usato il valore All per il parametro ThirdPartyAppDlpLocation.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Per altre informazioni sulla prevenzione della perdita dei dati per le app cloud non Microsoft, vedere Usare i criteri di prevenzione della perdita dei dati per le app cloud non Microsoft.

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

-AddThirdPartyAppDlpLocationException

Nota: questo parametro richiede l'appartenenza ai ruoli Amministratore conformità o Amministratore dati conformità in Azure Active Directory.

Il parametro AddThirdPartyAppDlpLocationException specifica le app cloud non Microsoft da aggiungere all'elenco di app escluse se è stato usato il valore All per il parametro ThirdPartyAppDlpLocation.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Per altre informazioni sulla prevenzione della perdita dei dati per le app cloud non Microsoft, vedere Usare i criteri di prevenzione della perdita dei dati per le app cloud non Microsoft.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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".

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

-Confirm

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

  • I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
  • La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ExceptIfOneDriveSharedBy

Il parametro ExceptIfOneDriveSharedBy specifica gli utenti da escludere dai criteri di prevenzione della perdita dei dati (i siti degli account utente OneDrive for Business sono inclusi nei criteri). Si identificano gli utenti in base all'UPN (laura@contoso.onmicrosoft.com).

Per usare questo parametro, una delle istruzioni seguenti deve essere true:

  • Il criterio include già OneDrive for Business siti (nell'output di Get-DlpCOmpliancePolicy, il valore della proprietà OneDriveLocation è All, ovvero il valore predefinito).
  • Usare -AddOneDriveLocation All nello stesso comando con questo parametro.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Non è possibile usare questo parametro con i parametri OneDriveSharedBy o OneDriveSharedByMemberOf.

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

-ExceptIfOneDriveSharedByMemberOf

Il parametro ExceptIfOneDriveSharedByMemberOf specifica i gruppi di distribuzione o i gruppi di sicurezza abilitati alla posta elettronica da escludere dai criteri DLP (i siti OneDrive for Business dei membri del gruppo sono esclusi dai criteri). Si identificano i gruppi in base all'indirizzo di posta elettronica.

Per usare questo parametro, una delle istruzioni seguenti deve essere true:

  • Il criterio include già OneDrive for Business siti (nell'output di Get-DlpCOmpliancePolicy, il valore della proprietà OneDriveLocation è All, ovvero il valore predefinito).
  • Usare -AddOneDriveLocation All nello stesso comando con questo parametro.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Non è possibile usare questo parametro con i parametri OneDriveSharedBy o OneDriveSharedByMemberOf.

Non è possibile usare questo parametro per specificare Gruppi di Microsoft 365.

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

-ExchangeSenderMemberOf

Il parametro ExchangeSenderMemberOf specifica i gruppi di distribuzione o i gruppi di sicurezza da includere nei criteri (la posta elettronica dei membri del gruppo è inclusa nei criteri). Si identificano i gruppi in base all'indirizzo di posta elettronica.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Per usare questo parametro, una delle istruzioni seguenti deve essere true:

  • Il criterio include già i messaggi di posta elettronica (nell'output di Get-DlpCOmpliancePolicy, il valore della proprietà ExchangeLocation è All).
  • Usare -AddExchangeLocation All nello stesso comando con questo parametro.

Non è possibile usare questo parametro con il parametro ExchangeSenderMemberOfException.

Non è possibile usare questo parametro per specificare Gruppi di Microsoft 365.

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

-ExchangeSenderMemberOfException

Il parametro ExchangeSenderMemberOfException specifica i gruppi di distribuzione o i gruppi di sicurezza da escludere dai criteri (la posta elettronica dei membri del gruppo è esclusa dai criteri). Si identificano i gruppi in base all'indirizzo di posta elettronica.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Per usare questo parametro, una delle istruzioni seguenti deve essere true:

  • Il criterio include già i messaggi di posta elettronica (nell'output di Get-DlpCOmpliancePolicy, il valore della proprietà ExchangeLocation è All).
  • Usare -AddExchangeLocation All nello stesso comando con questo parametro.

Non è possibile usare questo parametro con il parametro ExchangeSenderMemberOf.

Non è possibile usare questo parametro per specificare Gruppi di Microsoft 365.

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

-Force

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

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

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

-Identity

Il parametro Identity consente di specificare i criteri per la prevenzione della perdita di dati da modificare. È possibile utilizzare qualsiasi valore che identifichi il criterio in modo univoco. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • GUID
  • Id
Type:PolicyIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Security & Compliance

-Mode

Il parametro Mode consente di specificare il livello di azione e notifica dei criteri DLP. I valori validi sono:

  • Abilita: i criteri sono abilitati per le azioni e le notifiche. Questo è il valore predefinito.
  • Enable: il criterio è abilitato per azioni e notifiche. Questo è il valore predefinito.
  • TestWithNotifications: non vengono eseguite azioni, ma vengono inviate notifiche.
  • TestWithoutNotifications: modalità di controllo in cui non vengono eseguite azioni e non vengono inviate notifiche.
Type:PolicyMode
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-OneDriveSharedBy

Il parametro OneDriveSharedBy consente di specificare gli utenti da includere nei criteri di prevenzione della perdita dei dati (i siti degli account utente OneDrive for Business sono inclusi nei criteri). Si identificano gli utenti in base all'UPN (laura@contoso.onmicrosoft.com).

Per usare questo parametro, una delle istruzioni seguenti deve essere true:

  • Il criterio include già OneDrive for Business siti (nell'output di Get-DlpCOmpliancePolicy, il valore della proprietà OneDriveLocation è All, ovvero il valore predefinito).
  • Usare -AddOneDriveLocation All nello stesso comando con questo parametro.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Non è possibile usare questo parametro con i parametri ExceptIfOneDriveSharedBy o ExceptIfOneDriveSharedByMemberOf.

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

-OneDriveSharedByMemberOf

Il parametro OneDriveSharedByMemberOf specifica i gruppi di distribuzione o i gruppi di sicurezza abilitati alla posta da includere nei criteri DLP (i siti OneDrive for Business dei membri del gruppo sono inclusi nei criteri). Si identificano i gruppi in base all'indirizzo di posta elettronica.

Per usare questo parametro, una delle istruzioni seguenti deve essere true:

  • Il criterio include già OneDrive for Business siti (nell'output di Get-DlpCOmpliancePolicy, il valore della proprietà OneDriveLocation è All, ovvero il valore predefinito).
  • Usare -AddOneDriveLocation All nello stesso comando con questo parametro.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Non è possibile usare questo parametro con i parametri ExceptIfOneDriveSharedBy o ExceptIfOneDriveSharedByMemberOf.

Non è possibile usare questo parametro per specificare Gruppi di Microsoft 365.

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

-PolicyRBACScopes

{{ Fill PolicyRBACScopes Description }}

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

-PolicyTemplateInfo

PolicyTemplateInfo specifica i modelli di criteri DLP predefiniti o personalizzati da usare nei criteri DLP.

Per altre informazioni sui modelli di criteri DLP, vedere What the DLP policy templates include.

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

-Priority

Il parametro Priority consente di specificare un valore di priorità per il criterio che determina l'ordine di elaborazione dei criteri. Un valore intero inferiore indica una priorità più alta, il valore 0 è la priorità più alta e i criteri non possono avere lo stesso valore di priorità.

I valori validi e il valore predefinito per questo parametro dipendono dal numero di criteri esistenti. Ad esempio, se sono presenti 5 criteri esistenti:

  • I valori di priorità validi per i 5 criteri esistenti sono compresi tra 0 e 4.
  • I valori di priorità validi per un nuovo 6° criterio sono compresi tra 0 e 5.
  • Il valore predefinito per un nuovo 6° criterio è 5.

Se si modifica il valore di priorità di un criterio, la posizione dei criteri nell'elenco cambia in base al valore di priorità specificato. In altre parole, se si imposta il valore di priorità di un criterio sullo stesso valore di un criterio esistente, il valore di priorità dei criteri esistenti e di tutti gli altri criteri con priorità inferiore dopo che è stato aumentato di 1.

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

-RemoveEndpointDlpLocation

Nota: questo parametro richiede l'appartenenza ai ruoli Amministratore conformità o Amministratore dati conformità in Azure Active Directory.

Il parametro RemoveEndpointDlpLocation specifica gli account utente da rimuovere dall'elenco degli account inclusi per Endpoint DLP se è stato usato il valore All per il parametro EndpointDLPLocation. Specificare l'account in base al nome o all'indirizzo di posta elettronica.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Per altre informazioni sulla prevenzione della perdita dei dati degli endpoint, vedere Informazioni sulla prevenzione della perdita di dati degli endpoint.

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

-RemoveEndpointDlpLocationException

Nota: questo parametro richiede l'appartenenza ai ruoli Amministratore conformità o Amministratore dati conformità in Azure Active Directory.

Il parametro RemoveEndpointDlpLocation specifica gli account utente da rimuovere dall'elenco degli account esclusi per Endpoint DLP se è stato usato il valore All per il parametro EndpointDLPLocation. Specificare l'account in base al nome o all'indirizzo di posta elettronica.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Per altre informazioni sulla prevenzione della perdita dei dati degli endpoint, vedere Informazioni sulla prevenzione della perdita di dati degli endpoint.

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

-RemoveExchangeLocation

Il parametro RemoveExchangeLocation rimuove i messaggi di posta elettronica dai criteri DLP, se sono già inclusi. Il valore valido per questo parametro è All.

Se il criterio include già messaggi di posta elettronica (nell'output del cmdlet Get-DlpCompliancePolicy, il valore della proprietà ExchangeLocation è All), è possibile usare -RemoveExchangeLocation All per impedire l'applicazione dei criteri ai messaggi di posta elettronica.

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

-RemoveOneDriveLocation

Il parametro RemoveOneDriveLocation rimuove OneDrive for Business siti dai criteri DLP se sono già inclusi. Il valore valido per questo parametro è All.

Se il criterio include già OneDrive for Business siti (nell'output del cmdlet Get-DlpCompliancePolicy, il valore della proprietà OneDriveLocation è All), è possibile usare -RemoveOneDriveLocation All per impedire l'applicazione dei criteri ai siti OneDrive for Business.

Nota: sebbene questo parametro accetti gli URL del sito, non specificare i valori degli URL del sito. Usare invece i parametri OneDriveSharedBy, ExceptIfOneDriveShareBy, OneDriveSharedByMemberOf e ExceptIfOneDriveSharedByMemberOf. Nelle impostazioni dei criteri DLP nel portale di Microsoft 365 Defender non è possibile specificare i siti da includere o escludere in base all'URL. È possibile specificare siti da includere o escludere solo da utenti o gruppi.

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

-RemoveOneDriveLocationException

Non usare questo parametro. Per una spiegazione, vedere il parametro RemoveOneDriveLocation.

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

-RemoveOnPremisesScannerDlpLocation

Il parametro RemoveOnPremisesScannerDlpLocation specifica le condivisioni file locali e le raccolte documenti e le cartelle di SharePoint da rimuovere dall'elenco dei repository inclusi se è stato utilizzato il valore All per il parametro OnPremisesScannerDlpLocation.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Per altre informazioni sullo scanner locale DLP, vedere Informazioni sullo scanner locale per la prevenzione della perdita dei dati.

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

-RemoveOnPremisesScannerDlpLocationException

Il parametro RemoveOnPremisesScannerDlpLocationException specifica le condivisioni file locali e le raccolte documenti e le cartelle di SharePoint da rimuovere dall'elenco dei repository esclusi se è stato utilizzato il valore All per il parametro OnPremisesScannerDlpLocation.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Per altre informazioni sullo scanner locale DLP, vedere Informazioni sullo scanner locale per la prevenzione della perdita dei dati.

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

-RemovePowerBIDlpLocation

Il parametro RemovePowerBIDlpLocation specifica gli ID dell'area di lavoro di Power BI da rimuovere dall'elenco delle aree di lavoro incluse se è stato usato il valore All per il parametro PowerBIDlpLocation. Sono consentite solo le aree di lavoro ospitate nelle capacità Premium Gen2.

È possibile trovare l'ID dell'area di lavoro usando una delle procedure seguenti:

  • Nel portale Amministrazione scegliere Aree di lavoro, quindi selezionare un'area di lavoro e scegliere > Altre opzioni (...) > Dettagli.
  • Esaminare l'URL di un'area di lavoro selezionata.
  • In PowerShell usare il comando Get-PowerBIWorkspace.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

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

-RemovePowerBIDlpLocationException

Il parametro RemovePowerBIDlpLocationException specifica gli ID dell'area di lavoro di Power BI per rimuovere l'elenco delle aree di lavoro escluse se è stato usato il valore All per il parametro PowerBIDlpLocation. Sono consentite solo le aree di lavoro ospitate nelle capacità Premium Gen2.

È possibile trovare l'ID dell'area di lavoro usando una delle procedure seguenti:

  • Nel portale Amministrazione scegliere Aree di lavoro, quindi selezionare un'area di lavoro e scegliere > Altre opzioni (...) > Dettagli.
  • Esaminare l'URL di un'area di lavoro selezionata.
  • In PowerShell usare il comando Get-PowerBIWorkspace.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

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

-RemoveSharePointLocation

Il parametro RemoveSharePointLocation consente di specificare i siti di SharePoint Online da rimuovere dall'elenco dei siti inclusi se è stato utilizzato il valore All per il parametro SharePointLocation. Specificare il sito in base al relativo valore URL.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

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

-RemoveSharePointLocationException

Il parametro RemoveSharePointLocationException specifica i siti di SharePoint Online da rimuovere dall'elenco dei siti esclusi se è stato utilizzato il valore All per il parametro SharePointLocation. Specificare il sito in base al relativo valore URL.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

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

-RemoveTeamsLocation

Il parametro AddTeamsLocation consente di specificare gli account, i gruppi di distribuzione o i gruppi di sicurezza abilitati alla posta elettronica da rimuovere dall'elenco dei messaggi di chat e canale di Teams inclusi se è stato usato il valore All per il parametro TeamsLocation. Specificare le voci in base all'indirizzo di posta elettronica o al nome dell'account, del gruppo di distribuzione o del gruppo di sicurezza abilitato alla posta elettronica.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

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

-RemoveTeamsLocationException

Il parametro RemoveTeamsLocationException specifica gli account, i gruppi di distribuzione o i gruppi di sicurezza abilitati alla posta elettronica da rimuovere dall'elenco dei messaggi di chat e canale di Teams esclusi se è stato usato il valore All per il parametro TeamsLocation. Le voci vengono identificate in base all'indirizzo di posta elettronica o al nome dell'account, del gruppo di distribuzione o del gruppo di sicurezza abilitato alla posta elettronica.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

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

-RemoveThirdPartyAppDlpLocation

Nota: questo parametro richiede l'appartenenza ai ruoli Amministratore conformità o Amministratore dati conformità in Azure Active Directory.

Il parametro RemoveThirdPartyAppDlpLocation specifica le app cloud non Microsoft da rimuovere dall'elenco delle app incluse se è stato usato il valore All per il parametro ThirdPartyAppDlpLocation.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Per altre informazioni sulla prevenzione della perdita dei dati per le app cloud non Microsoft, vedere Usare i criteri di prevenzione della perdita dei dati per le app cloud non Microsoft.

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

-RemoveThirdPartyAppDlpLocationException

Nota: questo parametro richiede l'appartenenza ai ruoli Amministratore conformità o Amministratore dati conformità in Azure Active Directory.

Il parametro RemoveThirdPartyAppDlpLocationException specifica le app cloud non Microsoft rimosse dall'elenco delle app escluse se è stato usato il valore All per il parametro ThirdPartyAppDlpLocation.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Per altre informazioni sulla prevenzione della perdita dei dati per le app cloud non Microsoft, vedere Usare i criteri di prevenzione della perdita dei dati per le app cloud non Microsoft.

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

-RetryDistribution

L'opzione RetryDistribution ridistribuisce i criteri in tutte le posizioni di Exchange, OneDrive for Business 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. Se è stata usata questa opzione, vengono segnalati errori di distribuzione dei criteri.

Nota: poiché il processo di ripetizione della 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 il completamento della distribuzione dei criteri prima di eseguire di nuovo il comando per i criteri successivi.

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

-WhatIf

L'opzione WhatIf non funziona in PowerShell per la conformità alla sicurezza & .

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