Set-TenantAllowBlockListItems

모듈:: ExchangePowerShell

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

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

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

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

구문

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

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

Description

대부분의 경우 항목을 만든 후에는 보낸 사람, URL, 파일 또는 IP 주소 값을 수정할 수 없습니다. 유일한 예외는 피싱 시뮬레이션에 대한 URL 허용 항목입니다(ListType = URL, ListSubType = AdvancedDelivery). 피싱 시뮬레이션에 대한 URL을 허용하는 방법에 대한 자세한 내용은 비 Microsoft 피싱 시뮬레이션에 대한 고급 배달 정책 구성 및 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

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

매개 변수

-Allow

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

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Block

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

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Entries

Entries 매개 변수는 ListType 매개 변수 값에 따라 수정하려는 항목을 지정합니다. 유효한 값은 다음과 같습니다.

FileHash: 정확한 SHA256 파일 해시 값입니다.
보낸 사람 도메인 및 전자 메일 주소: 정확한 도메인 또는 전자 메일 주소 값입니다.
URL: 정확한 URL 값입니다.
IP: IPv6 주소만 해당합니다. 콜론 16진수 또는 0 압축 형식 또는 CIDR IPv6의 단일 IPv6 주소 범위는 1에서 128 사이입니다.

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

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

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

형식:	String[]
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ExpirationDate

ExpirationDate 매개 변수는 UTC(협정 세계시)의 만료 날짜를 기준으로 결과를 필터링합니다.

이 매개 변수에 대한 날짜/시간값을 지정하려면 다음 옵션 중 하나를 사용하십시오.

UTC에서 날짜/시간 값을 지정합니다(예 "2021-05-06 14:30:00z": ).
날짜/시간 값을 현지 표준 시간대의 날짜/시간을 UTC로 변환하는 수식으로 지정합니다(예 (Get-Date "5/6/2020 9:30 AM").ToUniversalTime(): ). 자세한 내용은 Get-Date를 참조하세요.

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

형식:	DateTime
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Ids

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

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

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

형식:	String[]
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ListSubType

ListSubType 매개 변수는 수정하려는 항목을 추가로 지정합니다. 유효한 값은 다음과 같습니다.

AdvancedDelivery: 피싱 시뮬레이션 URL에 이 값을 사용합니다. 자세한 내용은 비 Microsoft 피싱 시뮬레이션에 대한 고급 배달 정책 구성 및 SecOps 사서함으로의 전자 메일 배달을 참조하세요.
테넌트: 기본값입니다.

형식:	ListSubType
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ListType

ListType 매개 변수는 수정할 항목의 형식을 지정합니다. 유효한 값은 다음과 같습니다.

FileHash
보낸 사람
URL
IP

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

형식:	ListType
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-NoExpiration

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

이 스위치는 다음 유형의 항목과 함께 사용할 수 있습니다.

항목을 차단합니다.
URL은 ListSubType 매개 변수 값이 AdvancedDelivery인 항목을 허용합니다.
IP 주소는 항목을 허용합니다.

ExpirationDate 매개 변수에는 이 스위치를 사용할 수 없습니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Notes

Notes 매개 변수는 개체에 대한 추가 정보를 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-OutputJson

OutputJson 스위치는 모든 항목을 단일 JSON 값으로 반환할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

구문 오류가 포함된 첫 번째 항목에서 명령이 중지되지 않도록 하려면 이 스위치를 사용합니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-RemoveAfter

RemoveAfter 매개 변수는 허용 항목 에 대해>마지막으로 사용한 날짜 후 45일 후에 Remove를 사용하도록 설정합니다. LastUsedDate 속성은 메일 흐름 또는 클릭 시간 동안 필터링 시스템에서 허용 항목의 잘못된 엔터티가 발견되면 채워집니다. 허용 항목은 필터링 시스템에서 엔터티가 클린 것을 확인한 후 45일 동안 유지됩니다.

이 매개 변수의 유효한 값은 45뿐입니다.

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

LastUsedDate 속성에 종속되지 않는 정적 만료 날짜/시간 값으로 허용 항목을 변경하려면 ExpirationDate 매개 변수를 사용하여 Set-TenantAllowBlockListItems 명령을 실행합니다.

형식:	Int32
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False