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。