Set-SafeAttachmentPolicy

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

Set-SafeAttachmentPolicy コマンドレットを使用して、クラウドベースの組織内の安全な添付ファイルポリシーを変更します。

注意: Exchange Online PowerShell V2 モジュールを使用して Exchange Online PowerShell に接続することをお勧めします。 手順については、「Exchange Online PowerShell に接続する」を参照してください。

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

Syntax

Set-SafeAttachmentPolicy
   [-Identity] <SafeAttachmentPolicyIdParameter>
   [-Action <SafeAttachmentAction>]
   [-ActionOnError <Boolean>]
   [-AdminDisplayName <String>]
   [-Confirm]
   [-Enable <Boolean>]
   [-Redirect <Boolean>]
   [-RedirectAddress <SmtpAddress>]
   [-WhatIf]
   [<CommonParameters>]

Description

「安全な添付ファイル」は、悪意のあるアクティビティを検出するために特別なハイパーバイザー環境で電子メールの添付ファイルを開く、Microsoft Defender for Office 365 の機能です。 詳細については、「 Office 365 の Defender の安全な添付ファイル」を参照してください。

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

例 1

Set-SafeAttachmentsPolicy -Identity "Engineering Block Attachments" -Redirect $true -RedirectAddress admin@contoso.com

この例では、エンジニアリングブロックの添付ファイルという既存の安全な添付ファイルポリシーを変更して、検出されたマルウェアの添付ファイルを admin@contoso.com にリダイレクトします。

パラメーター

-ActionOnError

ActionOnError パラメーターは、安全な添付ファイルスキャンのエラー処理オプション (添付ファイルのスキャンがタイムアウトまたはエラーが発生した場合の対処方法) を指定します。 有効な値は次のとおりです。

  • $true: 添付ファイルが正常にスキャンされなかった場合でも、Action パラメーターで指定されたアクションがメッセージに適用されます。 これは既定の値です。
  • $false: 添付ファイルが正常にスキャンされなかった場合、Action パラメーターで指定されたアクションはメッセージに適用されません。
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-AdminDisplayName

AdminDisplayName パラメーターは、ポリシーの説明を指定します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-Confirm

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

  • データを破壊するコマンドレット (たとえば、Remove-* コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、次の構文を使用して確認プロンプトをスキップできます -Confirm:$false
  • 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-Enable

このパラメーターは使用されません。 安全添付ファイルポリシーを有効または無効にするには、New-SafeAttachmentRule または Set-SafeAttachmentRule コマンドレットの Enabled パラメーターを使用します。

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-Identity

Identity パラメーターは、変更する安全な添付ファイルポリシーを指定します。

これらの値は、コマンド Get-ComplianceSearch | Format-Table -Auto Name,JobRunId,Status を実行して確認できます。

  • 名前
  • 識別名 (DN)
  • GUID
Type:SafeAttachmentPolicyIdParameter
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-RedirectAddress

RedirectAddress パラメーターは、Redirect パラメーターが $true 値に設定されている場合に、検出されたマルウェアの添付ファイルが送信される電子メールアドレスを指定します。

Type:SmtpAddress
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-WhatIf

WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-アクション

Action パラメーターは、安全な添付ファイルポリシーのアクションを指定します。 有効な値は次のとおりです。

  • 許可: 添付ファイルは安全な添付ファイルポリシーによってスキャンされません。
  • Block: マルウェアの添付ファイルを含むメール メッセージをブロックします。 これは既定の値です。
  • Replace: メール メッセージを配信しますが、マルウェアの添付ファイルを削除して、警告テキストに置き換えます。
  • DynamicDelivery: 電子メールの添付ファイルごとにプレースホルダーを使用して、電子メールメッセージを配信します。 添付ファイルのコピーがスキャンされ、安全であると判断されるまで、プレースホルダーは残ります。 詳細については、「 動的配信のしくみ」を参照してください。

すべてのアクションの結果は、メッセージ トレースで使用できます。

Type:SafeAttachmentAction
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-リダイレクト

Redirect パラメーターは、検出されたマルウェアの添付ファイルを別のメール アドレスに送信するかどうかを指定します。 有効な値は次のとおりです。

  • $true: マルウェアの添付ファイルは RedirectAddress パラメーターで指定されたメール アドレスに送信されます。
  • $false: マルウェアの添付ファイルは別のメール アドレスに送信されません。 これは既定の値です。
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

入力

出力