New-OutlookProtectionRule
참고: 이 cmdlet은 더 이상 클라우드 기반 서비스에서 지원되지 않습니다.
cmdlet은 온-프레미스 Exchange 및 클라우드 기반 서비스에서 제공됩니다. 일부 매개 변수와 설정은 특정 환경에서만 사용할 수 있습니다.
New-OutlookProtectionRule cmdlet을 사용하여 Microsoft Outlook 보호 규칙을 만듭니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
Syntax
New-OutlookProtectionRule
[-Name] <String>
-ApplyRightsProtectionTemplate <RmsTemplateIdParameter>
[-Confirm]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-Force]
[-FromDepartment <String[]>]
[-Priority <Int32>]
[-SentTo <RecipientIdParameter[]>]
[-SentToScope <ToUserScope>]
[-UserCanOverride <Boolean>]
[-WhatIf]
[<CommonParameters>] Description
Outlook 보호 규칙은 사용자가 Outlook을 사용하여 메시지를 보내기 전에 적용된 관리자가 만든 규칙입니다. Outlook은 AD RMS(Active Directory Rights Management Services) 권한 템플릿을 적용하여 메시지 콘텐츠를 검사하고 메시지를 보호합니다.
자세한 내용은 Outlook 보호 규칙을 참조하세요.
조건 없이 만든 Outlook 보호 규칙은 모든 메시지에 적용됩니다.
이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.
예제
예 1
New-OutlookProtectionRule -Name "Project Contoso" -SentTo Joe@contoso.com -ApplyRightsProtectionTemplate "Template-Contoso"이 예제에서는 Template-Contoso 라는 AD RMS 템플릿을 SMTP 주소 Joe@contoso.com로 보낸 메시지에 적용합니다.
매개 변수
-ApplyRightsProtectionTemplate
ApplyRightsProtectionTemplate 매개 변수는 메시지에 적용할 AD RMS 템플릿을 지정합니다. 템플릿 이름을 사용하여 AD RMS 템플릿을 지정할 수 있습니다. AD RMS 서버에서 템플릿을 검색하려면 Get-RMSTemplate cmdlet을 사용합니다.
| Type: | RmsTemplateIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, 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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DomainController
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
DomainController 매개 변수는 Active Directory에서 데이터를 읽거나 쓰기 위해 이 cmdlet이 사용하는 도메인 컨트롤러를 지정합니다. FQDN(정규화된 도메인 이름)으로 도메인 컨트롤러를 식별합니다. 예: dc01.contoso.com
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Enabled
Enabled 매개 변수는 Outlook 보호 규칙을 사용할 수 있는지 여부를 지정합니다. 새 Outlook 보호 규칙은 기본적으로 사용하도록 설정됩니다. 규칙을 만들 때 사용하도록 설정하지 않으려면 Enabled 매개 변수를 $false로 설정합니다.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Force
강제 스위치는 경고 또는 확인 메시지를 숨깁니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
조건 없이 규칙을 만들 때 확인 프롬프트를 숨기려면 이 스위치를 사용합니다(조건이 없는 규칙은 모든 메시지에 적용됨).
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-FromDepartment
FromDepartment 매개 변수는 보낸 사람의 부서를 조건으로 지정합니다. 사용자의 부서 속성을 지정된 값과 비교합니다.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Name
Name 매개 변수는 규칙의 이름을 지정합니다.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Priority
Priority 매개 변수는 Outlook 보호 규칙의 처리 순서를 설정할지 여부를 지정합니다. 우선 순위가 낮은 규칙이 먼저 실행됩니다.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SentTo
SentTo 매개 변수는 하나 이상의 받는 사람을 규칙 조건으로 지정합니다. 내부 받는 사람을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예시:
- 이름
- 별칭
- DN(고유 이름)
- DN(고유 이름)
- 정식 DN
- GUID
외부 받는 사람의 SMTP 전자 메일 주소를 지정할 수도 있습니다.
Update 값에 공백이 포함되거나 따옴표가 필요한 경우 다음 구문을 "Value1","Value2",..."ValueN"사용합니다.
여러 받는 사람을 지정하면 지정된 받는 사람에게 보낸 메시지가 일치하는 것으로 간주됩니다.
이 매개 변수는 와일드카드 문자를 허용하지 않습니다.
| Type: | RecipientIdParameter[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SentToScope
SentToScope 매개 변수는 메시지 범위를 조건으로 지정합니다. 다음 값 중 하나를 사용할 수 있습니다.
- InOrganization: 이 값은 조직 내의 받는 사람에게 보낸 메시지에 대한 값입니다.
- 모두: 이 값은 모든 받는 사람에게 보낸 메시지에 대한 값입니다.
| Type: | ToUserScope |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-UserCanOverride
UserCanOverride 매개 변수는 사용자가 Outlook 보호 규칙에서 수행한 작업을 재정의할 수 있는지 여부를 지정합니다. 기본적으로 사용자는 Outlook 보호 규칙에서 수행한 작업을 재정의할 수 있습니다. UserCanOverride 매개 변수를 $false로 설정하면 사용자가 메시지를 보낼 때 규칙을 재정의할 수 없습니다.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, 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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
입력
Input types
이 cmdlet이 수락하는 입력 형식을 보려면 Cmdlet 입출력 형식을 참조하세요. cmdlet의 입력 형식 필드가 비어 있을 경우 cmdlet은 입력 데이터를 수락하지 않습니다.
출력
Output types
이 cmdlet이 수락하는 반환 형식(출력 형식이라고도 함)을 보려면 Cmdlet 입출력 형식을 참조하세요. 출력 형식 필드가 비어 있는 경우 cmdlet은 데이터를 반환하지 않습니다.