Get-ATPProtectionPolicyRule

モジュール:

ExchangePowerShell

適用対象:

Exchange Online

このコマンドレットは、クラウドベースのサービスでのみ使用できます。

Get-ATPProtectionPolicyRule コマンドレットを使用して、事前設定されたセキュリティ ポリシーのMicrosoft Defender for Office 365保護の規則を表示します。 ルールでは、保護の受信者の条件と例外を指定し、関連付けられている事前設定されたセキュリティ ポリシーをオンまたはオフにすることもできます。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

Get-ATPProtectionPolicyRule
   [[-Identity] <RuleIdParameter>]
   [-State <RuleState>]
   [<CommonParameters>]

説明

PowerShell の事前設定されたセキュリティ ポリシーの詳細については、「Exchange Online PowerShell のセキュリティ ポリシーのプリセット」を参照してください。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例

例 1

Get-ATPProtectionPolicyRule | Format-Table Name,State

次の使用例は、事前設定されたセキュリティ ポリシーのDefender for Office 365保護に関する規則の概要リストを返します。

例 2

Get-ATPProtectionPolicyRule -Identity "Strict Preset Security Policy"

この例では、Strict Preset セキュリティ ポリシーという名前の規則に関する詳細情報を返します。

パラメーター

-Identity

Identity パラメーターは、表示するルールを指定します。 ルールを一意に識別する任意の値を使用できます。 次に例を示します。

• 名前
• 識別名 (DN)
• GUID

既定では、使用可能な規則 (存在する場合) は、Standard Preset セキュリティ ポリシーと Strict Preset セキュリティ ポリシーという名前です。

Type:	RuleIdParameter
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online

-State

State パラメーターは、ルールの状態によって結果をフィルター処理します。 有効な値は次のとおりです。

• 有効
• 無効

Type:	RuleState
Accepted values:	Enabled, Disabled
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online