Set-SafeLinksPolicy

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

使用 Set-SafeLinksPolicy Cmdlet 來修改雲端架構組織中的安全連結原則。

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

Syntax

Set-SafeLinksPolicy
   [-Identity] <SafeLinksPolicyIdParameter>
   [-AdminDisplayName <String>]
   [-AllowClickThrough <Boolean>]
   [-Confirm]
   [-CustomNotificationText <String>]
   [-DeliverMessageAfterScan <Boolean>]
   [-DisableUrlRewrite <Boolean>]
   [-DoNotRewriteUrls <MultiValuedProperty>]
   [-EnableForInternalSenders <Boolean>]
   [-EnableOrganizationBranding <Boolean>]
   [-EnableSafeLinksForEmail <Boolean>]
   [-EnableSafeLinksForOffice <Boolean>]
   [-EnableSafeLinksForTeams <Boolean>]
   [-ScanUrls <Boolean>]
   [-TrackClicks <Boolean>]
   [-UseTranslatedNotificationText <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

Description

安全連結是適用於 Office 365 的 Microsoft Defender中的一項功能,可檢查連結是否導致惡意網站。 當使用者按一下連結時,會暫時重寫 URL,並針對已知的惡意網站清單進行檢查。 安全連結含有 URL 追蹤報告功能,能協助判斷點擊惡意網站連結的使用者。

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

範例

範例 1

Set-SafeLinksPolicy -Identity "Engineering Block URL" -AllowClickThrough $false

此範例會修改名為工程區塊 URL 的現有安全連結原則,不允許按一下警告頁面上的原始 URL。

參數

-AdminDisplayName

AdminDisplayName 參數會指定原則的描述。 如果值包含空格,請使用引號 (") 括住值。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-AllowClickThrough

AllowClickThrough 參數會指定是否允許使用者按一下警告頁面上的原始 URL。 有效值為:

$true:允許使用者按一下原始 URL。 $false:不允許使用者按一下原始 URL。

在 PowerShell 中,預設值為 $false。 在Microsoft 365 Defender入口網站中建立的新安全連結原則中,預設值為 $true。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Confirm

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

  • 例如,具破壞性的 Cmdlet (例如 Remove-* Cmdlet) 內建暫停,可強制您在繼續之前確認命令。 對於這些 Cmdlet,您可以使用以下確切語法來略過確認提示:-Confirm:$false
  • 其他大部分的 Cmdlet (例如,New-* 和 Set-* Cmdlet) 沒有內建暫停。 在使用這些 Cmdlet 時,指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-CustomNotificationText

自訂通知文字會指定要向使用者顯示的自訂通知文字。 如果值包含空格,請使用引號 (") 括住值。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-DeliverMessageAfterScan

DeliverMessageAfterScan 參數會指定是否只在安全連結掃描完成之後才傳遞電子郵件訊息。 有效值為:

  • $true:在傳遞訊息之前,請等到安全連結掃描完成。 這是預設值。 未傳遞包含惡意連結的訊息。
  • $false:如果安全連結掃描無法完成,還是要傳遞訊息。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-DisableUrlRewrite

DisableUrlRewrite 參數會指定是否要重寫 (將) URL 包裝在電子郵件訊息中。 有效值為:

  • $true:不會重寫訊息中的 URL,但在傳遞之前,安全連結仍會掃描訊息。 連結的點選檢查時間是使用支援的 Outlook 用戶端中的安全連結 API 來完成, (目前為 Windows 版 Outlook 和 Mac 版 Outlook) 。
  • $false:會重寫訊息中的 URL。 如果使用者處於有效的安全連結原則,API 檢查仍會在支援用戶端中未包裝的 URL 上進行。

在 PowerShell 中,預設值為 $false。 在Microsoft 365 Defender入口網站中建立的新安全連結原則中,預設值為 $true。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-DoNotRewriteUrls

DoNotRewriteUrls 參數會指定安全連結掃描未重寫的 URL。 專案清單可讓包含在原則中的使用者存取會遭到安全連結封鎖的指定 URL。

您可以輸入多個以逗號分隔的值。 如果值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"

如需專案語法的詳細資訊,請參閱 「不要重寫下列 URL」清單的專案語法

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-EnableForInternalSenders

EnableForInternalSenders 參數會指定是否將安全連結原則套用至相同Exchange Online組織內內部寄件者與內部收件者之間傳送的郵件。 有效值為:

  • $true:原則會套用至內部和外部寄件者。 這是預設值。
  • $false:原則只會套用至外部寄件者。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-EnableOrganizationBranding

EnableOrganizationBranding 參數會指定組織的標誌是否顯示在安全連結警告和通知頁面上。 有效值為:

  • $true:組織商標會顯示在 [安全連結] 警告和通知頁面上。 設定此值之前,您必須遵循 自訂貴組織的 Microsoft 365 主題 中的指示,上傳您的公司標誌。
  • $false:組織商標不會顯示在 [安全連結] 警告和通知頁面上。 這是預設值。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-EnableSafeLinksForEmail

EnableSafeLinksForEmail 參數會指定是否要啟用電子郵件訊息的安全連結保護。 有效值為:

  • $true:已啟用電子郵件的安全連結。 這是預設值。 當使用者按一下電子郵件中的連結時,安全連結會檢查該連結。 如果發現連結為惡意,預設網頁瀏覽器中會出現警告頁面。
  • $false:電子郵件未啟用安全連結。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-EnableSafeLinksForOffice

EnableSafeLinksForOffice 參數會指定是否要為支援的 Office 桌面、行動裝置或 Web 應用程式啟用安全連結保護。 有效值為:

  • $true:已在 Office 應用程式中啟用安全連結掃描。 這是預設值。 當使用者在支援的 Office 應用程式中開啟檔案,並按一下檔案中的連結時,安全連結會檢查連結。 如果發現連結為惡意,預設網頁瀏覽器中會出現警告頁面。
  • $false:Office 應用程式未啟用安全連結。

請注意,此保護適用于 Office 檔中的連結,而非電子郵件訊息中的連結。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-EnableSafeLinksForTeams

EnableSafeLinksForTeams 參數會指定是否為 Microsoft Teams 啟用安全連結。 有效值為:

  • $true:Teams 已啟用安全連結。 這是預設值。 當使用者按一下 Teams 交談、群組聊天或頻道中的連結時,安全連結會檢查連結。 如果發現連結為惡意,預設網頁瀏覽器中會出現警告頁面。
  • $false:Teams 未啟用安全連結。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Identity

Identity 參數會指定您要修改的安全連結原則。 您可以使用唯一識別原則的任何值。 例如:

  • 名稱
  • 辨別名稱 (DN)
  • GUID
Type:SafeLinksPolicyIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-ScanUrls

ScanUrls 參數會指定是否要啟用或停用電子郵件訊息中按下連結的即時掃描。 有效值為:

  • $true:已啟用點選連結的即時掃描,包括指向檔案的連結。 這是預設值。
  • $false:已停用點選連結的即時掃描,包括指向檔案的連結。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-TrackClicks

TrackClicks 參數會指定是否要追蹤與連結安全連結保護相關的使用者點選。 有效值為:

  • $true:追蹤使用者點選。 這是預設值。
  • $false:不會追蹤使用者點選。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-UseTranslatedNotificationText

UseTranslatedNotificationText 會指定是否要使用 Microsoft Translator 來自動當地語系化您使用 CustomNotificationText 參數指定的自訂通知文字。 有效值為:

  • $true:將自訂通知文字翻譯成使用者的語言。
  • $false:不要將自訂通知文字翻譯成使用者的語言。 這是預設值。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online