Condividi tramite

Set-AtpPolicyForO365

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>]
   [-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. 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.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a: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-*) 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.
Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a: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 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.
Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a: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

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a:Exchange Online

-Identity

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

Tipo:AtpPolicyForO365IdParameter
Posizione:1
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False
Si applica a: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.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a:Exchange Online