New-TenantAllowBlockListItems
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
New-TenantAllowBlockListItems コマンドレットを使用して、Microsoft 365 Defender ポータルのテナント許可/ブロック 一覧にエントリを追加します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
New-TenantAllowBlockListItems
-Entries <String[]>
-ListType <ListType>
[-ExpirationDate <DateTime>]
[-Allow]
[-Block]
[-ListSubType <ListSubType>]
[-LogExtraDetails]
[-Notes <String>]
[-OutputJson]
[-SubmissionID <String>]
[<CommonParameters>] New-TenantAllowBlockListItems
-Entries <String[]>
-ListType <ListType>
[-NoExpiration]
[-Allow]
[-Block]
[-ListSubType <ListSubType>]
[-LogExtraDetails]
[-Notes <String>]
[-OutputJson]
[-SubmissionID <String>]
[<CommonParameters>] 説明
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
New-TenantAllowBlockListItems -ListType Url -Block -Entries ~contoso.com~次の使用例は、contoso.com とすべてのサブドメイン (contoso.com、 www.contoso.com、xyz.abc.contoso.com、 www.contoso.com/b など) の URL ブロック エントリを追加します。 ExpirationDate パラメーターまたは NoExpiration パラメーターを使用していないため、エントリの有効期限は 30 日後です。
例 2
New-TenantAllowBlockListItems -ListType FileHash -Block -Entries "768a813668695ef2483b2bde7cf5d1b2db0423a0d3e63e498f3ab6f2eb13ea3","2c0a35409ff0873cfa28b70b8224e9aca2362241c1f0ed6f622fef8d4722fd9a" -NoExpiration次の使用例は、期限切れになることのない指定されたファイルのファイル ブロック エントリを追加します。
例 3
New-TenantAllowBlockListItems -Allow -ListType Url -ListSubType AdvancedDelivery -Entries *.fabrikam.com -NoExpiration次の使用例は、指定したサード パーティ製フィッシング シミュレーション URL の URL 許可エントリを、有効期限なしで追加します。 詳細については、「サード パーティのフィッシング シミュレーションをユーザーに配信し、フィルター処理されていないメッセージを SecOps メールボックスに配信するように構成する」を参照してください。
パラメーター
-Allow
許可スイッチは、許可エントリを作成することを指定します。 このスイッチで値を指定する必要はありません。
このスイッチはブロック スイッチでは使用できません。
注: 許可エントリを作成する前 に、「テナントの許可/ブロックリストのエントリを許可する」を参照してください。
また、有効期限のないサード パーティ製フィッシング シミュレーション URL に対して許可エントリを使用することもできます。 詳細については、「サード パーティのフィッシング シミュレーションをユーザーに配信し、フィルター処理されていないメッセージを SecOps メールボックスに配信するように構成する」を参照してください。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Security & Compliance, Exchange Online Protection |
-Block
[許可] スイッチは、ブロック エントリを作成することを指定します。 このスイッチで値を指定する必要はありません。
許可スイッチでは、このスイッチを使用できません。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Security & Compliance, Exchange Online Protection |
-Entries
Entries パラメーターは、ListType パラメーター値に基づいてテナント許可/ブロック リストに追加する値を指定します。
- FileHash: ファイルの SHA256 ハッシュ値を使用します。 Windows では、コマンド プロンプトで 次のコマンドを実行すると、SHA256 ハッシュ値を確認できます。
certutil.exe -hashfile "<Path>\<Filename>" SHA256値の例は です768a813668695ef2483b2bde7cf5d1b2db0423a0d3e63e498f3ab6f2eb13ea3。 - 送信者: ドメインまたはメール アドレスの値。 たとえば、
contoso.comおよびmichelle@contoso.comが禁止となります。 - URL: IPv4 または IPv6 アドレスまたはホスト名を使用します。 ホスト名ではワイルドカード (* と ~) がサポートされています。 プロトコル、TCP/UDP ポート、またはユーザー資格情報はサポートされていません。 詳細については、「 テナント許可/ブロック リストの URL 構文」を参照してください。
複数の値を入力するには、次の構文を使用します。 "Value1","Value2",..."ValueN"
送信者、ファイル、URL の場合、各種類の許可エントリの最大数は 500 で、各種類のブロック エントリの最大数は 500 です (種類ごとに合計 1,000 エントリ)。
ファイル エントリの最大文字数は 64 文字で、URL エントリの最大文字数は 250 文字です。
値の種類 (ファイル、送信者、または URL) を混在させたり、同じコマンドでアクションを許可したりブロックしたりすることはできません。
ほとんどの場合、エントリの作成後に URL、ファイル、または送信者の値を変更することはできません。 唯一の例外は、フィッシング シミュレーションの URL エントリを許可することです (ListType = URL、ListSubType = AdvancedDelivery)。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Security & Compliance, Exchange Online Protection |
-ExpirationDate
ExpirationDate パラメーターは、協定世界時 (UTC) の有効期限で結果をフィルター処理します。
このパラメーターの日付/時刻値を指定するには、次のいずれかのオプションを使用します。
- UTC で日付/時刻の値を指定します(例:
"2021-05-06 14:30:00z")。 - ローカル タイム ゾーンの日付/時刻を UTC に変換する数式として、日付/時刻の値を指定します(例:
(Get-Date "5/6/2020 9:30 AM").ToUniversalTime())。 詳細については、「Get-Date」を参照してください。
NoExpiration スイッチでは、このパラメーターを使用できません。
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Security & Compliance, Exchange Online Protection |
-ListSubType
ListSubType パラメーターは、このエントリのサブタイプを指定します。 有効な値は次のとおりです。
- AdvancedDelivery: フィッシング シミュレーション URL にこの値を使用します。 詳細については、「サード パーティのフィッシング シミュレーションをユーザーに配信し、フィルター処理されていないメッセージを SecOps メールボックスに配信するように構成する」を参照してください。
- テナント: これが既定値です。
| Type: | ListSubType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Security & Compliance, Exchange Online Protection |
-ListType
ListType パラメーターは、追加するエントリの種類を指定します。 有効な値は次のとおりです。
- FileHash
- Sender
- Url
| Type: | ListType |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Security & Compliance, Exchange Online Protection |
-LogExtraDetails
{{ Fill LogExtraDetails Description }}
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-NoExpiration
NoExpiration スイッチは、エントリの有効期限が切れないことを指定します。 このスイッチで値を指定する必要はありません。
このスイッチは、次のシナリオで使用できます。
- [ブロック] スイッチを使用します。
- 許可スイッチでは、ListType パラメーターの値が URL で、ListSubType パラメーターの値が AdvancedDelivery になります。
ExpirationDate パラメーターでは、このスイッチを使用できません。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Security & Compliance, Exchange Online Protection |
-Notes
Notes パラメーターには、オブジェクトに関する追加情報を指定します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Security & Compliance, Exchange Online Protection |
-OutputJson
OutputJson スイッチは、1 つの JSON 値内のすべてのエントリを返すかどうかを指定します。 このスイッチで値を指定する必要はありません。
このスイッチを使用して、構文エラーが含まれる最初のエントリでコマンドが停止しないようにします。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Security & Compliance, Exchange Online Protection |
-SubmissionID
このパラメーターは、Microsoft の内部使用のために予約されています。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Security & Compliance, Exchange Online Protection |
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示