New-SafeLinksPolicy

참조

모듈:: ExchangePowerShell

적용 대상:: Exchange Online

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

New-SafeLinksPolicy cmdlet을 사용하여 클라우드 기반 조직의 안전 링크 정책을 만들 수 있습니다.

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

Syntax

New-SafeLinksPolicy
   [-Name] <String>
   [-AdminDisplayName <String>]
   [-AllowClickThrough <Boolean>]
   [-Confirm]
   [-CustomNotificationText <String>]
   [-DeliverMessageAfterScan <Boolean>]
   [-DisableUrlRewrite <Boolean>]
   [-DoNotRewriteUrls <MultiValuedProperty>]
   [-EnableForInternalSenders <Boolean>]
   [-EnableOrganizationBranding <Boolean>]
   [-EnableSafeLinksForEmail <Boolean>]
   [-EnableSafeLinksForOffice <Boolean>]
   [-EnableSafeLinksForTeams <Boolean>]
   [-MakeBuiltInProtection]
   [-RecommendedPolicyType <RecommendedPolicyType>]
   [-ScanUrls <Boolean>]
   [-TrackClicks <Boolean>]
   [-UseTranslatedNotificationText <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

Description

안전한 링크는 링크를 확인하여 악의적인 웹 사이트로 이어지는지 확인하는 Office 365용 Microsoft Defender 기능입니다. 사용자가 링크를 클릭하면 URL이 일시적으로 다시 작성되고 알려진 악성 웹 사이트 목록에 대해 확인됩니다. 안전 링크에는 클릭해서 악의적인 웹 사이트로 이동된 사용자를 확인하는 데 도움이 되는 URL 추적 보고 기능이 포함되어 있습니다.

이 cmdlet을 사용하여 만든 새 정책은 사용자에게 적용되지 않으며 관리 센터에 표시되지 않습니다. 정책을 규칙과 연결하려면 New-SafeLinksRule 또는 Set-SafeLinksRule cmdlet에서 SafeLinksPolicy 매개 변수를 사용해야 합니다.

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

예제

예 1

New-SafeLinksPolicy -Name "Marketing Block URL" -EnableSafeLinksForEmail $true -AllowClickThrough $false

이 예에서는 다음 옵션을 사용하여 Marketing Block URL이라는 새 안전 링크 정책을 만듭니다.

정책은 사용하도록 설정되어 있습니다.
사용자는 원래 URL을 클릭하도록 허용되지 않습니다.
URL에 대한 사용자 클릭이 추적됩니다. TrackClicks 매개 변수의 기본값이므로 지정할 필요가 없습니다.

매개 변수

-AdminDisplayName

AdminDisplayName 매개 변수는 정책에 대한 설명을 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-AllowClickThrough

AllowClickThrough 매개 변수는 사용자가 경고 페이지에서 원래 URL을 클릭할 수 있는지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

$true: 사용자가 원래 URL을 클릭할 수 있습니다.
$false: 사용자가 원래 URL을 클릭할 수 없습니다.

PowerShell에서 기본값은 $false. Microsoft 365 Defender 포털에서 만든 새 안전 링크 정책에서 기본값은 $true.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-Confirm

Confirm 스위치는 확인 메시지를 표시할지 여부를 지정합니다. 진행하기 전에 cmdlet이 확인을 요구하는지에 따라 이 스위치가 cmdlet에 미치는 영향이 달라집니다.

파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 기본 제공 일시 중지가 있습니다. 이러한 cmdlet의 경우 정확한 구문 -Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다.
대부분의 다른 cmdlet(예: New-* 및 Set-* cmdlet)에는 기본 제공 일시 중지가 없습니다. 이러한 cmdlet의 경우 값 없이 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-CustomNotificationText

사용자 지정 알림 텍스트는 사용자에게 표시할 사용자 지정 알림 텍스트를 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-DeliverMessageAfterScan

DeliverMessageAfterScan 매개 변수는 안전한 링크 검사가 완료된 후에만 전자 메일 메시지를 전달할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

$true: 메시지를 전달하기 전에 안전한 링크 검사가 완료될 때까지 기다립니다. 악의적인 링크가 포함된 메시지는 배달되지 않습니다. 이 값은 기본값입니다.
$false: 안전한 링크 검사를 완료할 수 없는 경우 메시지를 배달합니다.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-DisableUrlRewrite

DisableUrlRewrite 매개 변수는 전자 메일 메시지에서 URL을 다시 작성(래핑)할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

$true: 메시지의 URL은 다시 작성되지 않지만 배달 전에 안전한 링크에서 메시지를 검색합니다. 링크에 대한 클릭 확인 시간은 지원되는 Outlook 클라이언트(현재 Windows용 Outlook 및 Mac용 Outlook)에서 안전한 링크 API를 사용하여 수행됩니다.
$false: 메시지의 URL을 다시 작성합니다. API 검사는 사용자가 유효한 안전 링크 정책에 있는 경우 지원되는 클라이언트의 래핑되지 않은 URL에서 계속 발생합니다. 이 값은 기본값입니다.

PowerShell에서 기본값은 $false. Microsoft 365 Defender 포털에서 만든 새 안전 링크 정책에서 기본값은 $true.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-DoNotRewriteUrls

DoNotRewriteUrls 매개 변수는 안전 링크 검사로 다시 작성되지 않은 URL을 지정합니다. 항목 목록을 사용하면 정책에 포함된 사용자가 안전한 링크에 의해 차단되는 지정된 URL에 액세스할 수 있습니다.

여러 값을 입력하고 기존 항목을 덮어쓰려면 다음 구문을 Value1,Value2,...ValueN사용합니다. 값에 공백이 포함되거나 따옴표가 필요한 경우 다음 구문을 "Value1","Value2",..."ValueN"사용합니다.

기존 항목에 영향을 주지 않고 하나 이상의 값을 추가하거나 제거하려면 다음 구문을 @{Add="Value1","Value2"...; Remove="Value3","Value4"...}사용합니다.

항목 구문에 대한 자세한 내용은 "다음 URL을 다시 작성하지 마세요" 목록의 항목 구문을 참조하세요.

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-EnableForInternalSenders

EnableForInternalSenders 매개 변수는 안전한 링크 정책이 동일한 Exchange Online organization 내의 내부 보낸 사람과 내부 받는 사람 간에 전송되는 메시지에 적용되는지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

$true: 정책은 내부 및 외부 보낸 사람에게 적용됩니다. 이 값은 기본값입니다.
$false: 정책은 외부 보낸 사람에게만 적용됩니다.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-EnableOrganizationBranding

EnableOrganizationBranding 매개 변수는 organization 로고가 안전한 링크 경고 및 알림 페이지에 표시되는지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

$true: 조직 브랜딩이 안전한 링크 경고 및 알림 페이지에 표시됩니다. 이 값을 구성하기 전에 회사 로고를 업로드하려면 organization Microsoft 365 테마 사용자 지정의 지침을 따라야 합니다.
$false: 안전한 링크 경고 및 알림 페이지에 조직 브랜딩이 표시되지 않습니다. 이 값은 기본값입니다.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-EnableSafeLinksForEmail

EnableSafeLinksForEmail 매개 변수는 전자 메일 메시지에 대해 안전한 링크 보호를 사용할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

$true: 안전한 링크는 전자 메일에 사용할 수 있습니다. 이 값은 기본값입니다. 사용자가 전자 메일의 링크를 클릭하면 안전한 링크에서 링크를 확인합니다. 링크가 악의적인 것으로 확인되면 기본 웹 브라우저에 경고 페이지가 나타납니다.
$false: 안전한 링크는 전자 메일에 사용할 수 없습니다.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-EnableSafeLinksForOffice

EnableSafeLinksForOffice 매개 변수는 지원되는 Office 데스크톱, 모바일 또는 웹앱에 대해 안전한 링크 보호를 사용할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

$true: Office 앱에서 안전한 링크 검사를 사용할 수 있습니다. 이 값은 기본값입니다. 사용자가 지원되는 Office 앱에서 파일을 열고 파일의 링크를 클릭하면 안전한 링크에서 링크를 확인합니다. 링크가 악의적인 것으로 확인되면 기본 웹 브라우저에 경고 페이지가 나타납니다.
$false: 안전한 링크는 Office 앱에 사용할 수 없습니다.

이 보호는 전자 메일 메시지의 링크가 아니라 Office 문서의 링크에 적용됩니다.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-EnableSafeLinksForTeams

EnableSafeLinksForTeams 매개 변수는 Microsoft Teams에 대해 안전한 링크를 사용할 수 있는지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

$true: Teams에서 안전한 링크를 사용할 수 있습니다. 이 값은 기본값입니다. 사용자가 Teams 대화, 그룹 채팅 또는 채널에서 링크를 클릭하면 안전한 링크에서 링크를 확인합니다. 링크가 악의적인 것으로 확인되면 기본 웹 브라우저에 경고 페이지가 나타납니다.
$false: 안전한 링크는 Teams에 사용할 수 없습니다.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-MakeBuiltInProtection

MakeBuiltInProtection 스위치는 기본 제공 보호 정책 만들기에 사전 설정 보안 정책의 일부로 사용됩니다. 이 스위치를 직접 사용하지 마세요.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-Name

Name 매개 변수는 안전 링크 정책의 고유한 이름을 지정합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-RecommendedPolicyType

RecommendedPolicyType 매개 변수는 사전 설정 보안 정책의 일부로 표준 및 엄격한 정책 만들기에 사용됩니다. 이 매개 변수를 직접 사용하지 마세요.

Type:	RecommendedPolicyType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ScanUrls

ScanUrls 매개 변수는 전자 메일 메시지에서 클릭된 링크의 실시간 검사를 사용하거나 사용하지 않도록 설정할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

$true: 파일을 가리키는 링크를 포함하여 클릭된 링크의 실시간 검사가 사용하도록 설정됩니다. 이 값은 기본값입니다.
$false: 파일을 가리키는 링크를 포함하여 클릭된 링크의 실시간 검사를 사용할 수 없습니다.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-TrackClicks

TrackClicks 매개 변수는 링크의 안전한 링크 보호와 관련된 사용자 클릭을 추적할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

$true: 사용자가 메시지를 클릭하면 추적됩니다. 이 값은 기본값입니다.
$false: 사용자가 메시지를 클릭해도 추적되지 않습니다.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-UseTranslatedNotificationText

UseTranslatedNotificationText는 Microsoft Translator를 사용하여 CustomNotificationText 매개 변수로 지정한 사용자 지정 알림 텍스트를 자동으로 지역화할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

$true: 사용자 지정 알림 텍스트를 사용자의 언어로 번역합니다.
$false: 사용자 지정 알림 텍스트를 사용자의 언어로 변환하지 마세요. 이 값은 기본값입니다.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-WhatIf

Whatif 스위치는 해당 명령의 동작을 시뮬레이션합니다. 이 스위치를 사용하면 변경 내용을 실제로 적용하지 않고 발생할 변경 내용을 확인할 수 있습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online