Get-SafeLinksRule
此指令程式只能在雲端式服務中使用。
使用 Get-SafeLinksRule 指令小說來查看雲端組織中的安全連結規則。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
Get-SafeLinksRule
[[-Identity] <RuleIdParameter>]
[-State <RuleState>]
[<CommonParameters>]
Description
安全連結是 Microsoft Defender for Office 365 中的一項功能,用來檢查電子郵件中的連結,以判斷是否導向惡意網站。 當使用者按一下郵件中的連結時,系統會暫時重寫 URL 並核對已知的惡意網站清單。 安全連結含有 URL 追蹤報告功能,能協助判斷點擊惡意網站連結的使用者。
您必須已獲指派權限,才能執行此指令程式。 雖然這篇文章列出了 cmdlet 的所有參數,但如果某些參數未包含在你分配的權限中,你可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Get-SafeLinksRule | Format-Table -Auto Name,State,Priority,SafeLinksPolicy,Comments
此範例回傳您組織中所有安全連結規則的摘要清單。
範例 2
Get-SafeLinksRule -Identity "Research Department URL Rule"
此範例回傳了關於名為「研究部門網址規則」的安全連結規則的詳細資訊。
參數
-Identity
適用:Exchange Online
Identity 參數指定你想查看的安全連結規則。
您可以使用唯一識別規則的任何值。 例如:
- 名稱
- 辨別名稱 (DN)
- GUID
注意:Identity 參數的值$null或不存在的值,會回傳 所有 物件,就像你執行 Get- 指令時沒有 Identity 參數一樣。 請確認 Identity 參數的值清單是否準確,且不包含不存在的 $null 值。
參數屬性
| 類型: | RuleIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-State
適用:Exchange Online
State 參數會依規則狀態來篩選結果。 有效值為 Enabled 和 Disabled。
參數屬性
| 類型: | RuleState |
| 預設值: | 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。