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.
- Sicurezza documenti: usa Microsoft Defender per endpoint per analizzare documenti e file aperti in Visualizzazione protetta in Microsoft 365 Apps for enterprise.
- Allegati sicuri per SharePoint, OneDrive e Microsoft Teams.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Default (Impostazione predefinita)
Set-AtpPolicyForO365
[[-Identity] <AtpPolicyForO365IdParameter>]
[-AllowSafeDocsOpen <Boolean>]
[-Confirm]
[-EnableATPForSPOTeamsODB <Boolean>]
[-EnableSafeDocs <Boolean>]
[-WhatIf]
[<CommonParameters>]
Descrizione
La protezione dei collegamenti sicuri per le app di 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 di Office 365.
Documenti sicuri analizza i documenti e i file aperti in Visualizzazione protetta. Per altre informazioni, vedere Sicurezza documenti 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. Anche se questo articolo elenca tutti i parametri per il cmdlet, si potrebbe non avere accesso ad alcuni parametri se non sono 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 e allegati sicuri per SharePoint, OneDrive e Microsoft Teams.
Parametri
-AllowSafeDocsOpen
Applicabile: Exchange Online
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 viene identificato come dannoso.
- $false: Gli utenti non sono autorizzati a uscire dalla Visualizzazione protetta in caso di rilevamento di malware.
Questo parametro è significativo solo quando il valore del parametro EnableSafeDocs è $true.
Proprietà dei parametri
| Tipo: | Boolean |
| 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 |
-Confirm
Applicabile: Exchange Online
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 |
-EnableATPForSPOTeamsODB
Applicabile: Exchange Online
Il parametro EnableATPForSPOTeamsODB abilita o disabilita gli allegati sicuri per SharePoint, OneDrive e Microsoft Teams. I valori validi sono:
- $true: gli allegati sicuri per SharePoint, OneDrive e Microsoft Teams sono abilitati. Gli amministratori di SharePoint possono usare il parametro DisallowInfectedFileDownload nel cmdlet Set-SPOTenant per controllare se gli utenti sono autorizzati a scaricare file ritenuti dannosi.
- $false: gli allegati sicuri per SharePoint, OneDrive e Microsoft Teams sono disabilitati. Questo è il valore predefinito.
Proprietà dei parametri
| Tipo: | Boolean |
| 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 |
-EnableSafeDocs
Applicabile: Exchange Online
Il parametro EnableSafeDocs abilita o disabilita i documenti sicuri nelle organizzazioni con licenze di Microsoft 365 A5 o Microsoft 365 E5 Security. I valori validi sono:
- $true: Sicurezza documenti è abilitata e carica i file utente in Microsoft Defender per endpoint per l'analisi e la verifica.
- $false: Sicurezza documenti è disabilitata. Questo è il valore predefinito.
Per altre informazioni sulla sicurezza dei documenti, vedere Sicurezza dei documenti in Microsoft 365 A5 o E5 Security
Proprietà dei parametri
| Tipo: | Boolean |
| 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 |
-Identity
Applicabile: Exchange Online
Il parametro Identity consente di specificare il criterio che si desidera modificare. Esiste solo un criterio denominato Default.
Proprietà dei parametri
| Tipo: | AtpPolicyForO365IdParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 1 |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Applicabile: Exchange Online
L'opzione WhatIf mostra le operazioni eseguite dal comando senza apportare modifiche. Con questa opzione non è necessario specificare alcun valore.
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.