Set-AtpPolicyForO365
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 $trueIn 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 |