Set-AtpPolicyForO365

モジュール:
Exchange PowerShell

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

Set-AtpPolicyForO365 コマンドレットを使用して、Microsoft Defender for Office 365 の次の機能の設定を変更します。

  • サポートされている Office 365 アプリの安全なリンク保護。
  • 安全なドキュメント: Microsoft Defender for Endpoint を使用して、Microsoft 365 Apps for enterprise の保護ビューで開かれているドキュメントとファイルをスキャンします。
  • SharePoint、OneDrive、Microsoft Teams の安全な添付ファイル。

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

構文

Default (既定) 

Set-AtpPolicyForO365
    [[-Identity] <AtpPolicyForO365IdParameter>]
    [-AllowSafeDocsOpen <Boolean>]
    [-Confirm]
    [-EnableATPForSPOTeamsODB <Boolean>]
    [-EnableSafeDocs <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

説明

Office 365 アプリの安全なリンク保護は、電子メール メッセージのリンクではなく、Office ドキュメント内のリンクをチェックします。 詳細については、「Office 365 アプリ向けの安全なリンク設定」を参照してください。

安全なドキュメントは、保護ビューで開かれているドキュメントとファイルをスキャンします。 詳細については、「Microsoft 365 E5 の安全なドキュメント」を参照してください。

SharePoint、OneDrive、Microsoft Teams の安全な添付ファイルにより、悪意のあるファイルとして識別されたファイルをユーザーが開いたりダウンロードしたりできなくなります。 詳細については、「SharePoint、OneDrive、Microsoft Teams の安全な添付ファイル」を参照してください。

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

例

例 1

Set-AtpPolicyForO365 -EnableATPForSPOTeamsODB $true

この例では、SharePoint、OneDrive、Microsoft Teams の安全なドキュメントと安全な添付ファイルを有効にします。

パラメーター

-AllowSafeDocsOpen

適用対象: Exchange Online

AllowSafeDocsOpen パラメーターは、Safe Documents によってファイルが悪意のあるものとして識別された場合でも、ユーザーが保護ビューのコンテナーをクリックスルーしてバイパスできるかどうかを指定します。 有効な値は次のとおりです。

  • $true: ドキュメントが悪意のあるものとして識別された場合でも、ユーザーは保護ビュー コンテナーを終了できます。
  • $false: 悪意のある検出が発生した場合、ユーザーは保護ビューを終了できません。

このパラメーターは、EnableSafeDocs パラメーター値が $true の場合にのみ意味があります。

パラメーターのプロパティ

型:Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Confirm

適用対象: Exchange Online

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

  • データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
  • 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値を指定せずに Confirm スイッチを指定すると、一時停止が発生し、続行する前にコマンドの確認を強制されます。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:Cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-EnableATPForSPOTeamsODB

適用対象: Exchange Online

EnableATPForSPOTeamsODB パラメーターは、SharePoint、OneDrive、Microsoft Teams の安全な添付ファイルを有効または無効にします。 有効な値は次のとおりです。

  • $true: SharePoint、OneDrive、Microsoft Teams の安全な添付ファイルが有効になっています。 SharePoint 管理者は、 Set-SPOTenant コマンドレットの DisallowInfectedFileDownload パラメーターを使用して、悪意があることが判明したファイルのダウンロードをユーザーに許可するかどうかを制御できます。
  • $false: SharePoint、OneDrive、Microsoft Teams の安全な添付ファイルは無効になっています。 この値が既定値です。

パラメーターのプロパティ

型:Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-EnableSafeDocs

適用対象: Exchange Online

EnableSafeDocs パラメーターは、Microsoft 365 A5 または Microsoft 365 E5 Security ライセンスを持つ組織で安全なドキュメントを有効または無効にします。 有効な値は次のとおりです。

  • $true: 安全なドキュメントが有効になっており、スキャンと検証のためにユーザー ファイルを Microsoft Defender for Endpoint にアップロードします。
  • $false: セーフ ドキュメントは無効になっています。 この値が既定値です。

安全なドキュメントの詳細については、「Microsoft 365 A5 または E5 セキュリティの安全なドキュメント」を参照してください

パラメーターのプロパティ

型:Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Identity

適用対象: Exchange Online

Identity パラメーターには、変更するポリシーを指定します。 Default という名前のポリシーが 1 つだけ存在します。

パラメーターのプロパティ

型:AtpPolicyForO365IdParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:1
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-WhatIf

適用対象: Exchange Online

[WhatIf] スイッチは、何も変更を加えずにコマンドが実行する内容を表示します。 このスイッチで値を指定する必要はありません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:wi

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。