Set-AtpPolicyForO365

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
Exchange Online

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Usare il cmdlet Set-AtpPolicyForO365 per modificare le impostazioni per le funzionalità seguenti in Microsoft Defender per Office 365:

  • Protezione collegamenti sicuri per le app Office 365 supportate.
  • Documenti sicuri: usa Microsoft Defender per endpoint per analizzare i documenti e i file aperti in Visualizzazione protetta nelle app di Microsoft 365 per le aziende.
  • Allegati sicuri per SharePoint, OneDrive e Microsoft Teams.

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

Sintassi

Set-AtpPolicyForO365
   [[-Identity] <AtpPolicyForO365IdParameter>]
   [-AllowSafeDocsOpen <Boolean>]
   [-BlockUrls <MultiValuedProperty>]
   [-Confirm]
   [-EnableATPForSPOTeamsODB <Boolean>]
   [-EnableSafeDocs <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

La protezione dei collegamenti sicuri per le app Office 365 controlla i collegamenti nei documenti di Office, non i collegamenti nei messaggi di posta elettronica. Per altre informazioni, vedere [Impostazioni dei collegamenti sicuri per le app Office 365](https://learn.microsoft.com/microsoft-365/security/office-365-security/safe-links-about#safe-links-settings-for-office-365-apps.

Documenti sicuri analizza i documenti e i file aperti in Visualizzazione protetta. Per altre informazioni, vedere Documenti sicuri in Microsoft 365 E5.

Allegati sicuri per SharePoint, OneDrive e Microsoft Teams impedisce agli utenti di aprire e scaricare file identificati come dannosi. Per altre informazioni, vedere Allegati sicuri per SharePoint, OneDrive e Microsoft Teams.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

Set-AtpPolicyForO365 -EnableATPForSPOTeamsODB $true

In questo esempio vengono abilitati documenti sicuri e allegati sicuri per SharePoint, OneDrive e Microsoft Teams.

Parametri

-AllowSafeDocsOpen

Il parametro AllowSafeDocsOpen consente di specificare se gli utenti possono fare clic e ignorare il contenitore Visualizzazione protetta anche quando Documenti sicuri identifica un file come dannoso. I valori validi sono:

  • $true: gli utenti possono uscire dal contenitore Visualizzazione protetta anche se il documento è stato identificato come dannoso.
  • $false: gli utenti non possono uscire dalla visualizzazione protetta in caso di rilevamento dannoso.

Questo parametro è significativo solo quando viene $true il valore del parametro EnableSafeDocs.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-BlockUrls

Questo parametro è obsoleto e non viene più utilizzato.

La funzionalità di questo parametro è stata sostituita da voci di blocco per gli URL nell'elenco tenant consentiti/bloccati usando i cmdlet *-TenantAllowBlockListItems.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Confirm

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

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

-EnableATPForSPOTeamsODB

Il parametro EnableATPForSPOTeamsODB abilita o disabilita gli allegati sicuri per SharePoint, OneDrive e Microsoft Teams. I valori validi sono:

  • $true: allegati sicuri per SharePoint, OneDrive e Microsoft Teams è abilitato. Gli amministratori di SharePoint Online possono usare il parametro DisallowInfectedFileDownload nel cmdlet Set-SPOTenant per controllare se agli utenti è consentito scaricare file che risultano dannosi.
  • $false: allegati sicuri per SharePoint, OneDrive e Microsoft Teams è disabilitato. Questo è il valore predefinito.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-EnableSafeDocs

Il parametro EnableSafeDocs abilita o disabilita documenti sicuri nelle organizzazioni con licenze Microsoft 365 A5 o Microsoft 365 E5 Security. I valori validi sono:

  • $true: Documenti sicuri è abilitato e caricherà i file utente in Microsoft Defender per endpoint per l'analisi e la verifica.
  • $false: Documenti sicuri è disabilitato. Questo è il valore predefinito.

Per altre informazioni sui documenti sicuri, vedere Documenti sicuri in sicurezza Microsoft 365 A5 o E5

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Identity

Il parametro Identity consente di specificare i criteri da modificare. Esiste solo un criterio denominato Default.

Type:AtpPolicyForO365IdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-WhatIf

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online