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
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 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.
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. Anche se questo articolo elenca tutti i parametri per il cmdlet, è possibile che non si abbia accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate all'utente. 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
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 è 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.
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. 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-*) 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, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente 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: allegati sicuri per SharePoint, OneDrive e Microsoft Teams è abilitato. Gli amministratori di SharePoint 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 valore è 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 documenti sicuri nelle organizzazioni con licenze Microsoft 365 A5 o Microsoft 365 E5 Security. I valori validi sono:
- $true: Documenti sicuri è abilitato e carica i file utente in Microsoft Defender per endpoint per l'analisi e la verifica.
- $false: Documenti sicuri è disabilitato. Questo valore è il valore predefinito.
Per altre informazioni sui documenti sicuri, vedere Documenti sicuri in sicurezza Microsoft 365 A5 o E5
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 i criteri da 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 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.
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.