Set-TenantAllowBlockListItems

참조

모듈:: ExchangePowerShell

적용 대상:: Exchange Online, Security & Compliance, Exchange Online Protection

이 cmdlet은 클라우드 기반 서비스에서만 사용할 수 있습니다.

Set-TenantAllowBlockListItems cmdlet을 사용하여 Microsoft 365 Defender 포털의 테넌트 허용/차단 목록에서 항목을 수정합니다.

아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.

Syntax

Set-TenantAllowBlockListItems
   -Ids <String[]>
   -ListType <ListType>
   [-Allow]
   [-Block]
   [-ExpirationDate <DateTime>]
   [-ListSubType <ListSubType>]
   [-NoExpiration]
   [-Notes <String>]
   [-OutputJson]
   [<CommonParameters>]

Set-TenantAllowBlockListItems
   -Entries <String[]>
   -ListType <ListType>
   [-Allow]
   [-Block]
   [-ExpirationDate <DateTime>]
   [-ListSubType <ListSubType>]
   [-NoExpiration]
   [-Notes <String>]
   [-OutputJson]
   [<CommonParameters>]

Description

대부분의 경우 기존 항목의 URL, 파일 또는 보낸 사람 값을 수정할 수 없습니다. 유일한 예외는 피싱 시뮬레이션에 대한 URL 항목 허용(작업 = 허용, ListType = URL 및 ListSubType = AdvancedDelivery)입니다. 피싱 시뮬레이션에 대한 URL을 허용하는 방법에 대한 자세한 내용은 타사 피싱 시뮬레이션을 사용자에게 전달하고 필터링되지 않은 메시지를 SecOps 사서함에 배달하도록 구성을 참조하세요.

이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.

예제

예 1

Set-TenantAllowBlockListItems -ListType Url -Ids "RgAAAAAI8gSyI_NmQqzeh-HXJBywBwCqfQNJY8hBTbdlKFkv6BcUAAAl_QCZAACqfQNJY8hBTbdlKFkv6BcUAAAl_oSRAAAA" -ExpirationDate (Get-Date "5/30/2021 9:30 AM").ToUniversalTime()

다음은 지정된 항목의 만료 날짜를 변경하는 예제입니다.

예 2

Set-TenantAllowBlockListItems -ListType Url -ListSubType AdvancedDelivery -Entries *.fabrikam.com -ExpirationDate 9/11/2021

다음은 지정된 타사 피싱 시뮬레이션 URL에 대한 URL 허용 항목의 만료 날짜를 변경하는 예제입니다.

매개 변수

-Allow

허용 스위치는 허용 항목을 수정하도록 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

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 파일 해시 값입니다.
보낸 사람 도메인 및 전자 메일 주소: 정확한 도메인 또는 전자 메일 주소 값입니다.
URL: 정확한 URL 값입니다.

이 값은 Get-TenantAllowBlockListItems cmdlet의 출력에 있는 항목의 Value 속성에 표시됩니다.

값 형식(파일, 보낸 사람 또는 URL)을 혼합하거나 동일한 명령에서 작업을 허용 및 차단할 수 없습니다.

Ids 매개 변수에는 이 매개 변수를 사용할 수 없습니다.

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

-Ids

Ids 매개 변수는 수정하려는 항목을 지정합니다. 이 값은 Get-TenantAllowBlockListItems cmdlet의 출력에 있는 Identity 속성에 표시됩니다.

이 매개 변수의 예제 값은 입니다 RgAAAAAI8gSyI_NmQqzeh-HXJBywBwCqfQNJY8hBTbdlKFkv6BcUAAAl_QCZAACqfQNJY8hBTbdlKFkv6BcUAAAl_oSPAAAA0.

Entries 매개 변수에는 이 매개 변수를 사용할 수 없습니다.

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

-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
보낸 사람
Url

이 매개 변수와 함께 Entries 또는 Ids 매개 변수를 사용하여 항목 자체를 식별합니다.

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

-NoExpiration

NoExpiration 스위치는 항목이 만료되지 않도록 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

이 스위치는 차단 항목 또는 ListSubType 매개 변수 값이 AdvancedDelivery인 URL 허용 항목과 함께 사용할 수 있습니다.

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 스위치는 모든 항목을 단일 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