Set-AtpPolicyForO365
이 cmdlet은 클라우드 기반 서비스에서만 사용할 수 있습니다.
Set-AtpPolicyForO365 cmdlet을 사용하여 Office 365용 Microsoft Defender 다음 기능에 대한 설정을 수정합니다.
- 지원되는 Office 365 앱에 대한 안전한 링크 보호.
- 안전한 문서: 엔드포인트용 Microsoft Defender 사용하여 엔터프라이즈용 Microsoft 365 앱의 보호된 보기에서 열린 문서 및 파일을 검색합니다.
- SharePoint, OneDrive 및 Microsoft Teams용 안전한 첨부 파일입니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
구문
Default (기본값)
Set-AtpPolicyForO365
[[-Identity] <AtpPolicyForO365IdParameter>]
[-AllowSafeDocsOpen <Boolean>]
[-Confirm]
[-EnableATPForSPOTeamsODB <Boolean>]
[-EnableSafeDocs <Boolean>]
[-WhatIf]
[<CommonParameters>]
Description
Office 365 앱에 대한 안전한 링크 보호는 전자 메일 메시지의 링크가 아닌 Office 문서의 링크를 확인합니다. 자세한 내용은 Office 365 앱에 대한 안전한 링크 설정을 참조하세요.
안전한 문서는 보호된 보기에서 열린 문서 및 파일을 검색합니다. 자세한 내용은 Microsoft 365 E5 안전한 문서를 참조하세요.
SharePoint, OneDrive 및 Microsoft Teams용 안전한 첨부 파일은 사용자가 악성으로 식별된 파일을 열고 다운로드하는 것을 방지합니다. 자세한 내용은 SharePoint, OneDrive 및 Microsoft Teams용 안전한 첨부 파일을 참조하세요.
이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 문서에서는 cmdlet에 대한 모든 매개 변수를 나열하지만 할당된 권한에 포함되지 않은 경우 일부 매개 변수에 액세스할 수 없을 수 있습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.
예제
예 1
Set-AtpPolicyForO365 -EnableATPForSPOTeamsODB $true
이 예제에서는 SharePoint, OneDrive 및 Microsoft Teams에 안전한 문서 및 안전한 첨부 파일을 사용하도록 설정합니다.
매개 변수
-AllowSafeDocsOpen
적용 가능: Exchange Online
AllowSafeDocsOpen 매개 변수는 안전한 문서가 파일을 악성으로 식별하는 경우에도 사용자가 보호된 보기 컨테이너를 클릭하고 무시할 수 있는지 여부를 지정합니다. 유효한 값은 다음과 같습니다.
- $true: 문서가 악의적인 것으로 식별되더라도 사용자는 보호된 보기 컨테이너를 종료할 수 있습니다.
- $false: 악의적인 검색이 있는 경우 사용자는 보호된 보기를 종료할 수 없습니다.
이 매개 변수는 EnableSafeDocs 매개 변수 값이 $true 경우에만 의미가 있습니다.
매개 변수 속성
| 형식: | Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Confirm
적용 가능: Exchange Online
Confirm 스위치는 확인 메시지를 표시할지 여부를 지정합니다. 진행하기 전에 cmdlet이 확인을 요구하는지에 따라 이 스위치가 cmdlet에 미치는 영향이 달라집니다.
- 파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 일시 중지 기능이 기본 제공되어 있습니다. 이러한 cmdlet의 경우 정확한 구문
-Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다. - 대부분 다른 cmdlets에는 (예:, New-* and Set-* cmdlets) 중단 기능이 기본 제공되지 않습니다. 이러한 cmdlet의 경우 값 없이 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | cf(cf) |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-EnableATPForSPOTeamsODB
적용 가능: Exchange Online
EnableATPForSPOTeamsODB 매개 변수는 SharePoint, OneDrive 및 Microsoft Teams에 대한 안전한 첨부 파일을 사용하거나 사용하지 않도록 설정합니다. 유효한 값은 다음과 같습니다.
- $true: SharePoint, OneDrive 및 Microsoft Teams용 안전한 첨부 파일을 사용할 수 있습니다. SharePoint 관리자는 Set-SPOTenant cmdlet의 DisallowInfectedFileDownload 매개 변수를 사용하여 사용자가 악성으로 확인된 파일을 다운로드할 수 있는지 여부를 제어할 수 있습니다.
- $false: SharePoint, OneDrive 및 Microsoft Teams용 안전한 첨부 파일은 사용할 수 없습니다. 이 값은 기본값입니다.
매개 변수 속성
| 형식: | Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-EnableSafeDocs
적용 가능: Exchange Online
EnableSafeDocs 매개 변수는 Microsoft 365 A5 또는 Microsoft 365 E5 Security 라이선스가 있는 조직에서 안전한 문서를 사용하거나 사용하지 않도록 설정합니다. 유효한 값은 다음과 같습니다.
- $true: 안전한 문서가 사용하도록 설정되고 사용자 파일을 업로드하여 검사 및 확인을 위해 엔드포인트용 Microsoft Defender.
- $false: 안전한 문서를 사용할 수 없습니다. 이 값은 기본값입니다.
안전한 문서에 대한 자세한 내용은 Microsoft 365 A5 또는 E5 보안의 안전한 문서를 참조하세요.
매개 변수 속성
| 형식: | Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Identity
적용 가능: Exchange Online
Identity 매개 변수는 수정하려는 정책을 지정합니다. Default라는 정책이 하나만 있습니다.
매개 변수 속성
| 형식: | AtpPolicyForO365IdParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 1 |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-WhatIf
적용 가능: Exchange Online
Whatif 스위치는 해당 명령의 동작을 시뮬레이션합니다. 이 스위치를 사용하면 변경 내용을 실제로 적용하지 않고 발생할 변경 내용을 확인할 수 있습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | 위스콘신 |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.