共用方式為


Set-AtpPolicyForO365

此指令程式只能在雲端式服務中使用。

使用 Set-AtpPolicyForO365 Cmdlet 來修改 適用於 Office 365 的 Microsoft Defender 中下列功能的設定:

  • 用於支援 Office 365 的安全連結保護。
  • 安全檔:使用適用於端點的 Microsoft Defender 掃描在適用於企業的 Microsoft 365 應用程式中受保護檢視中開啟的檔和檔案。
  • 適用於 SharePoint、OneDrive 和 Microsoft Teams 的安全附件。

如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法

語法

Default (預設值)

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

Description

Office 365 應用程式的安全連結保護會檢查 Office 文件中的連結,而不是電子郵件訊息中的連結。 如需詳細資訊,請參閱 Office 365 應用程式的安全連結設定

「安全文件」會掃描在「受保護檢視」中開啟的文件和檔案。 如需詳細資訊,請參閱 Microsoft 365 E5 中的安全檔

適用於 SharePoint、OneDrive 和 Microsoft Teams 的安全附件可防止使用者開啟和下載識別為惡意的檔案。 如需詳細資訊,請參閱 SharePoint、OneDrive 和 Microsoft Teams 的安全附件

您必須已獲指派權限,才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數,但如果某些參數未包含在指派給您的許可權中,您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet

範例

範例 1

Set-AtpPolicyForO365 -EnableATPForSPOTeamsODB $true

此範例會啟用 SharePoint、OneDrive 和 Microsoft Teams 的安全檔和安全附件。

參數

-AllowSafeDocsOpen

適用:Exchange Online

AllowSafeDocsOpen 參數會指定使用者是否可以按一下並略過受保護的檢視容器,即使安全檔將檔案識別為惡意檔案也一樣。 有效值為:

  • $true:允許使用者結束受保護的檢視容器,即使文件被識別為惡意檔案也是如此。
  • $false:如果發生惡意偵測,使用者不得結束受保護的檢視。

只有在 EnableSafeDocs 參數值為 $true 時,此參數才有意義。

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Confirm

適用:Exchange Online

Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。

  • 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停,它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet,您可以使用以下確切語法來略過確認提示:-Confirm:$false
  • 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 在使用這些 Cmdlet 時,指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:參閱

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-EnableATPForSPOTeamsODB

適用:Exchange Online

EnableATPForSPOTeamsODB 參數會啟用或停用 SharePoint、OneDrive 和 Microsoft Teams 的安全附件。 有效值為:

  • $true:已啟用 SharePoint、OneDrive 和 Microsoft Teams 的安全附件。 SharePoint 系統管理員可以使用 Set-SPOTenant Cmdlet 上的 DisallowInfectedFileDownload 參數來控制是否允許使用者下載發現為惡意的檔案。
  • $false:SharePoint、OneDrive 和 Microsoft Teams 的安全附件已停用。 此值是預設值。

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-EnableSafeDocs

適用:Exchange Online

EnableSafeDocs 參數會在具有 Microsoft 365 A5 或 Microsoft 365 E5 安全性授權的組織中啟用或停用安全檔。 有效值為:

  • $true:啟用安全文件,並將使用者檔案上傳到適用於端點的 Microsoft Defender進行掃描和驗證。
  • $false:安全文件已停用。 此值是預設值。

如需安全檔的詳細資訊,請參閱 Microsoft 365 A5 或 E5 安全性中的安全檔

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Identity

適用:Exchange Online

身分參數指定您要修改的政策。 只有一個名為 [預設] 的原則。

參數屬性

類型:AtpPolicyForO365IdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:1
必要:False
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-WhatIf

適用:Exchange Online

WhatIf 參數會模擬命令的動作。 使用此參數時,您不需要實際套用變更即可檢視可能會發生的變更。 您不需要使用此參數指定值。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:威斯康星州

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援常見參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters