Get-SafeLinksRule
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
Get-SafeLinksRule コマンドレットを使用して、クラウドベース組織の安全なリンク ルールを表示します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
Get-SafeLinksRule
[[-Identity] <RuleIdParameter>]
[-State <RuleState>]
[<CommonParameters>]
説明
安全なリンクは、電子メール メッセージ内のリンクをチェックして、悪意のある Web サイトにつながるかどうかを確認する Microsoft Defender for Office 365 の機能です。 ユーザーがメッセージ内のリンクをクリックすると、一時的に URL が書き換えられて、悪意のある既知の Web サイトの一覧と照合されます。 「安全なリンク」には、悪意のある Web サイトへのリンクをクリックしたユーザーを判別するために役立つ URL トレース レポート機能が含まれています。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事にはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 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"
この例では、Research Department URL Rule という名前の安全なリンク ルールに関する詳細情報を返します。
パラメーター
-Identity
適用対象: Exchange Online
Identity パラメーターは、表示する安全なリンク ルールを指定します。
ルールを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- 識別名 (DN)
- GUID
注意: Identityパラメータの値$nullまたは存在しない値は、IdentityパラメータなしでGet-コマンドを実行したかのように、 すべての オブジェクトを返します。 Identity パラメーターの値のリストが正確であり、存在しない$null値が含まれていないことを確認します。
パラメーターのプロパティ
| 型: | RuleIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-State
適用対象: Exchange Online
State パラメーターは、ルールの状態によって結果をフィルター処理します。 正しい値は、Enabled と Disabled です。
パラメーターのプロパティ
| 型: | RuleState |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。