New-EmailAddressPolicy
cmdlet은 온-프레미스 Exchange 및 클라우드 기반 서비스에서 제공됩니다. 일부 매개 변수와 설정은 특정 환경에서만 사용할 수 있습니다.
New-EmailAddressPolicy cmdlet을 사용하여 이메일 주소 정책을 만듭니다. Exchange Online 이메일 주소 정책은 Microsoft 365 그룹만 사용할 수 있습니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
Syntax
New-EmailAddressPolicy
[-Name] <String>
-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>
-IncludedRecipients <WellKnownRecipientType>
[-ConditionalCompany <MultiValuedProperty>]
[-ConditionalCustomAttribute1 <MultiValuedProperty>]
[-ConditionalCustomAttribute10 <MultiValuedProperty>]
[-ConditionalCustomAttribute11 <MultiValuedProperty>]
[-ConditionalCustomAttribute12 <MultiValuedProperty>]
[-ConditionalCustomAttribute13 <MultiValuedProperty>]
[-ConditionalCustomAttribute14 <MultiValuedProperty>]
[-ConditionalCustomAttribute15 <MultiValuedProperty>]
[-ConditionalCustomAttribute2 <MultiValuedProperty>]
[-ConditionalCustomAttribute3 <MultiValuedProperty>]
[-ConditionalCustomAttribute4 <MultiValuedProperty>]
[-ConditionalCustomAttribute5 <MultiValuedProperty>]
[-ConditionalCustomAttribute6 <MultiValuedProperty>]
[-ConditionalCustomAttribute7 <MultiValuedProperty>]
[-ConditionalCustomAttribute8 <MultiValuedProperty>]
[-ConditionalCustomAttribute9 <MultiValuedProperty>]
[-ConditionalDepartment <MultiValuedProperty>]
[-ConditionalStateOrProvince <MultiValuedProperty>]
[-Confirm]
[-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>] New-EmailAddressPolicy
[-Name] <String>
-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>
-RecipientFilter <String>
[-Confirm]
[-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>] New-EmailAddressPolicy
[-Name] <String>
-EnabledPrimarySMTPAddressTemplate <String>
-IncludedRecipients <WellKnownRecipientType>
[-ConditionalCompany <MultiValuedProperty>]
[-ConditionalCustomAttribute1 <MultiValuedProperty>]
[-ConditionalCustomAttribute10 <MultiValuedProperty>]
[-ConditionalCustomAttribute11 <MultiValuedProperty>]
[-ConditionalCustomAttribute12 <MultiValuedProperty>]
[-ConditionalCustomAttribute13 <MultiValuedProperty>]
[-ConditionalCustomAttribute14 <MultiValuedProperty>]
[-ConditionalCustomAttribute15 <MultiValuedProperty>]
[-ConditionalCustomAttribute2 <MultiValuedProperty>]
[-ConditionalCustomAttribute3 <MultiValuedProperty>]
[-ConditionalCustomAttribute4 <MultiValuedProperty>]
[-ConditionalCustomAttribute5 <MultiValuedProperty>]
[-ConditionalCustomAttribute6 <MultiValuedProperty>]
[-ConditionalCustomAttribute7 <MultiValuedProperty>]
[-ConditionalCustomAttribute8 <MultiValuedProperty>]
[-ConditionalCustomAttribute9 <MultiValuedProperty>]
[-ConditionalDepartment <MultiValuedProperty>]
[-ConditionalStateOrProvince <MultiValuedProperty>]
[-Confirm]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>] New-EmailAddressPolicy
[-Name] <String>
-EnabledPrimarySMTPAddressTemplate <String>
-RecipientFilter <String>
[-Confirm]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>] New-EmailAddressPolicy
[-Name] <String>
-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>
[-IncludeUnifiedGroupRecipients]
[-ManagedByFilter <String>]
[-Confirm]
[-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>] New-EmailAddressPolicy
[-Name] <String>
-EnabledPrimarySMTPAddressTemplate <String>
[-IncludeUnifiedGroupRecipients]
[-ManagedByFilter <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>] Description
New-EmailAddressPolicy cmdlet을 사용하여 온-프레미스 Exchange 조직에서 전자 메일 주소 정책을 만든 후에는 Update-EmailAddressPolicy cmdlet을 사용하여 받는 사람에게 새 정책을 적용해야 합니다.
IncludedRecipients 매개 변수와 함께 사용되는 Conditional 매개 변수에는 다음과 같은 제한이 적용됩니다.
- "Department equals Sales"와 같이 모든 속성 값에 EQV 연산자가 사용됩니다. 와일드카드 및 부분 일치는 지원되지 않습니다.
- "Department equals Sales OR Marketing"과 같이 동일한 속성을 갖는 여러 값에 항상 OR 연산자가 사용됩니다.
- "Department equals Sales AND Company equals Contoso"과 같이 여러 특성에는 항상 AND 연산자가 사용됩니다.
사용 가능한 모든 받는 사람 속성을 사용하고 이러한 제한 사항이 적용되지 않는 유연한 필터를 만들려면 RecipientFilter 매개 변수를 사용하여 OPATH 필터를 만들 수 있습니다.
이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.
예제
예 1
New-EmailAddressPolicy -Name "Southeast Offices" -IncludedRecipients MailboxUsers -ConditionalStateorProvince "GA","AL","LA" -EnabledEmailAddressTemplates "SMTP:%s%2g@southeast.contoso.com","smtp:%s%2g@southeast.contoso.net"이 예제에서는 미리 검색된 받는 사람 필터를 사용하는 온-프레미스 Exchange 조직에서 이메일 주소 정책을 만듭니다.
- 이름: 남동부 사무소
- 미리 검색된 받는 사람 필터: 주 또는 주 값이 GA, AL 또는 LA(조지아, 앨라배마 또는 루이지애나)인 사서함이 있는 모든 사용자입니다.
- 기본 SMTP 전자 메일 주소:
<last name>.<first two letters of the first name>@contoso.com - 추가 프록시 전자 메일 주소:
<last name>.<first two letters of the first name>@contoso.net - Priority:N+1. 여기서 N은 이미 존재하는 수동으로 만든 전자 메일 주소 정책의 수입니다(Priority 매개 변수를 사용하지 않았고 기본값은 N+1임).
예 2
New-EmailAddressPolicy -Name "Northwest Executives" -RecipientFilter "(RecipientType -eq 'UserMailbox') -and (Title -like '*Director*' -or Title -like '*Manager*') -and (StateOrProvince -eq 'WA' -or StateOrProvince -eq 'OR' -or StateOrProvince -eq 'ID')" -EnabledEmailAddressTemplates "SMTP:%2g%s@contoso.com" -Priority 2이 예제에서는 사용자 지정 받는 사람 필터를 사용하는 온-프레미스 Exchange 조직에서 이메일 주소 정책을 만듭니다.
- 이름: 노스웨스트 임원
- 사용자 지정 받는 사람 필터: Title 값에 디렉터 또는 관리자가 포함된 사서함이 있고 주 또는 지방 값이 WA 또는 OR 또는 ID(워싱턴, 오리건 또는 아이다호)인 사서함이 있는 모든 사용자입니다.
- 기본 SMTP 전자 메일 주소:
<first two letters of the first name><last name>@contoso.com - 추가 프록시 전자 메일 주소: 없음
- 우선 순위: 2
매개 변수
-ConditionalCompany
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
ConditionalCompany 매개 변수는 받는 사람의 회사 속성 값을 기반으로 하는 미리 검사된 필터를 지정합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.
이 매개 변수에 여러 값을 사용하면 OR 부울 연산자가 적용됩니다. 조건부 매개 변수의 작동 방식에 대한 자세한 내용은 이 항목의 자세한 설명 섹션을 참조하세요.
이 매개 변수를 사전 검사된 필터의 일부로 IncludedRecipients 매개 변수와 함께 사용합니다. RecipientFilter 매개 변수와 함께 조건부 매개 변수를 사용할 수 없습니다(사용자 지정 OPATH 필터를 만드는 데 사용됨).
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute1
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
ConditionalCustomAttribute1 매개 변수는 받는 사람의 CustomAttribute1 속성 값을 기반으로 하는 미리 검사된 필터를 지정합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.
이 매개 변수에 여러 값을 사용하면 OR 부울 연산자가 적용됩니다. 조건부 매개 변수의 작동 방식에 대한 자세한 내용은 이 항목의 자세한 설명 섹션을 참조하세요.
이 매개 변수를 사전 검사된 필터의 일부로 IncludedRecipients 매개 변수와 함께 사용합니다. RecipientFilter 매개 변수와 함께 조건부 매개 변수를 사용할 수 없습니다(사용자 지정 OPATH 필터를 만드는 데 사용됨).
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute10
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
ConditionalCustomAttribute10 매개 변수는 받는 사람의 CustomAttribute10 속성 값을 기반으로 하는 미리 검사된 필터를 지정합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.
이 매개 변수에 여러 값을 사용하면 OR 부울 연산자가 적용됩니다. 조건부 매개 변수의 작동 방식에 대한 자세한 내용은 이 항목의 자세한 설명 섹션을 참조하세요.
이 매개 변수를 사전 검사된 필터의 일부로 IncludedRecipients 매개 변수와 함께 사용합니다. RecipientFilter 매개 변수와 함께 조건부 매개 변수를 사용할 수 없습니다(사용자 지정 OPATH 필터를 만드는 데 사용됨).
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute11
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
ConditionalCustomAttribute11 매개 변수는 받는 사람의 CustomAttribute11 속성 값을 기반으로 하는 미리 검사된 필터를 지정합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.
이 매개 변수에 여러 값을 사용하면 OR 부울 연산자가 적용됩니다. 조건부 매개 변수의 작동 방식에 대한 자세한 내용은 이 항목의 자세한 설명 섹션을 참조하세요.
이 매개 변수를 사전 검사된 필터의 일부로 IncludedRecipients 매개 변수와 함께 사용합니다. RecipientFilter 매개 변수와 함께 조건부 매개 변수를 사용할 수 없습니다(사용자 지정 OPATH 필터를 만드는 데 사용됨).
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute12
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
ConditionalCustomAttribute12 매개 변수는 받는 사람의 CustomAttribute12 속성 값을 기반으로 하는 미리 검사된 필터를 지정합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.
이 매개 변수에 여러 값을 사용하면 OR 부울 연산자가 적용됩니다. 조건부 매개 변수의 작동 방식에 대한 자세한 내용은 이 항목의 자세한 설명 섹션을 참조하세요.
이 매개 변수를 사전 검사된 필터의 일부로 IncludedRecipients 매개 변수와 함께 사용합니다. RecipientFilter 매개 변수와 함께 조건부 매개 변수를 사용할 수 없습니다(사용자 지정 OPATH 필터를 만드는 데 사용됨).
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute13
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
ConditionalCustomAttribute13 매개 변수는 받는 사람의 CustomAttribute13 속성 값을 기반으로 하는 미리 검사된 필터를 지정합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.
이 매개 변수에 여러 값을 사용하면 OR 부울 연산자가 적용됩니다. 조건부 매개 변수의 작동 방식에 대한 자세한 내용은 이 항목의 자세한 설명 섹션을 참조하세요.
이 매개 변수를 사전 검사된 필터의 일부로 IncludedRecipients 매개 변수와 함께 사용합니다. RecipientFilter 매개 변수와 함께 조건부 매개 변수를 사용할 수 없습니다(사용자 지정 OPATH 필터를 만드는 데 사용됨).
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute14
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
ConditionalCustomAttribute14 매개 변수는 받는 사람의 CustomAttribute14 속성 값을 기반으로 하는 미리 검사된 필터를 지정합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.
이 매개 변수에 여러 값을 사용하면 OR 부울 연산자가 적용됩니다. 조건부 매개 변수의 작동 방식에 대한 자세한 내용은 이 항목의 자세한 설명 섹션을 참조하세요.
이 매개 변수를 사전 검사된 필터의 일부로 IncludedRecipients 매개 변수와 함께 사용합니다. RecipientFilter 매개 변수와 함께 조건부 매개 변수를 사용할 수 없습니다(사용자 지정 OPATH 필터를 만드는 데 사용됨).
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute15
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
ConditionalCustomAttribute15 매개 변수는 받는 사람의 CustomAttribute15 속성 값을 기반으로 하는 미리 생성된 필터를 지정합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.
이 매개 변수에 여러 값을 사용하면 OR 부울 연산자가 적용됩니다. 조건부 매개 변수의 작동 방식에 대한 자세한 내용은 이 항목의 자세한 설명 섹션을 참조하세요.
이 매개 변수를 사전 검사된 필터의 일부로 IncludedRecipients 매개 변수와 함께 사용합니다. RecipientFilter 매개 변수와 함께 조건부 매개 변수를 사용할 수 없습니다(사용자 지정 OPATH 필터를 만드는 데 사용됨).
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute2
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
ConditionalCustomAttribute2 매개 변수는 받는 사람의 CustomAttribute2 속성 값을 기반으로 하는 미리 검색된 필터를 지정합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.
이 매개 변수에 여러 값을 사용하면 OR 부울 연산자가 적용됩니다. 조건부 매개 변수의 작동 방식에 대한 자세한 내용은 이 항목의 자세한 설명 섹션을 참조하세요.
이 매개 변수를 사전 검사된 필터의 일부로 IncludedRecipients 매개 변수와 함께 사용합니다. RecipientFilter 매개 변수와 함께 조건부 매개 변수를 사용할 수 없습니다(사용자 지정 OPATH 필터를 만드는 데 사용됨).
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute3
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
ConditionalCustomAttribute3 매개 변수는 받는 사람의 CustomAttribute3 속성 값을 기반으로 하는 미리 검색된 필터를 지정합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.
이 매개 변수에 여러 값을 사용하면 OR 부울 연산자가 적용됩니다. 조건부 매개 변수의 작동 방식에 대한 자세한 내용은 이 항목의 자세한 설명 섹션을 참조하세요.
이 매개 변수를 사전 검사된 필터의 일부로 IncludedRecipients 매개 변수와 함께 사용합니다. RecipientFilter 매개 변수와 함께 조건부 매개 변수를 사용할 수 없습니다(사용자 지정 OPATH 필터를 만드는 데 사용됨).
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute4
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
ConditionalCustomAttribute4 매개 변수는 받는 사람의 CustomAttribute4 속성 값을 기반으로 하는 미리 검사된 필터를 지정합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.
이 매개 변수에 여러 값을 사용하면 OR 부울 연산자가 적용됩니다. 조건부 매개 변수의 작동 방식에 대한 자세한 내용은 이 항목의 자세한 설명 섹션을 참조하세요.
이 매개 변수를 사전 검사된 필터의 일부로 IncludedRecipients 매개 변수와 함께 사용합니다. RecipientFilter 매개 변수와 함께 조건부 매개 변수를 사용할 수 없습니다(사용자 지정 OPATH 필터를 만드는 데 사용됨).
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute5
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
ConditionalCustomAttribute5 매개 변수는 받는 사람의 CustomAttribute5 속성 값을 기반으로 하는 미리 검색된 필터를 지정합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.
이 매개 변수에 여러 값을 사용하면 OR 부울 연산자가 적용됩니다. 조건부 매개 변수의 작동 방식에 대한 자세한 내용은 이 항목의 자세한 설명 섹션을 참조하세요.
이 매개 변수를 사전 검사된 필터의 일부로 IncludedRecipients 매개 변수와 함께 사용합니다. RecipientFilter 매개 변수와 함께 조건부 매개 변수를 사용할 수 없습니다(사용자 지정 OPATH 필터를 만드는 데 사용됨).
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute6
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
ConditionalCustomAttribute6 매개 변수는 받는 사람의 CustomAttribute6 속성 값을 기반으로 하는 미리 검색된 필터를 지정합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.
이 매개 변수에 여러 값을 사용하면 OR 부울 연산자가 적용됩니다. 조건부 매개 변수의 작동 방식에 대한 자세한 내용은 이 항목의 자세한 설명 섹션을 참조하세요.
이 매개 변수를 사전 검사된 필터의 일부로 IncludedRecipients 매개 변수와 함께 사용합니다. RecipientFilter 매개 변수와 함께 조건부 매개 변수를 사용할 수 없습니다(사용자 지정 OPATH 필터를 만드는 데 사용됨).
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute7
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
ConditionalCustomAttribute7 매개 변수는 받는 사람의 CustomAttribute7 속성 값을 기반으로 하는 미리 검색된 필터를 지정합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.
이 매개 변수에 여러 값을 사용하면 OR 부울 연산자가 적용됩니다. 조건부 매개 변수의 작동 방식에 대한 자세한 내용은 이 항목의 자세한 설명 섹션을 참조하세요.
이 매개 변수를 사전 검사된 필터의 일부로 IncludedRecipients 매개 변수와 함께 사용합니다. RecipientFilter 매개 변수와 함께 조건부 매개 변수를 사용할 수 없습니다(사용자 지정 OPATH 필터를 만드는 데 사용됨).
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute8
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
ConditionalCustomAttribute8 매개 변수는 받는 사람의 CustomAttribute8 속성 값을 기반으로 하는 미리 검색된 필터를 지정합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.
이 매개 변수에 여러 값을 사용하면 OR 부울 연산자가 적용됩니다. 조건부 매개 변수의 작동 방식에 대한 자세한 내용은 이 항목의 자세한 설명 섹션을 참조하세요.
이 매개 변수를 사전 검사된 필터의 일부로 IncludedRecipients 매개 변수와 함께 사용합니다. RecipientFilter 매개 변수와 함께 조건부 매개 변수를 사용할 수 없습니다(사용자 지정 OPATH 필터를 만드는 데 사용됨).
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute9
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
ConditionalCustomAttribute9 매개 변수는 받는 사람의 CustomAttribute9 속성 값을 기반으로 하는 미리 검색된 필터를 지정합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.
이 매개 변수에 여러 값을 사용하면 OR 부울 연산자가 적용됩니다. 조건부 매개 변수의 작동 방식에 대한 자세한 내용은 이 항목의 자세한 설명 섹션을 참조하세요.
이 매개 변수를 사전 검사된 필터의 일부로 IncludedRecipients 매개 변수와 함께 사용합니다. RecipientFilter 매개 변수와 함께 조건부 매개 변수를 사용할 수 없습니다(사용자 지정 OPATH 필터를 만드는 데 사용됨).
| Type: | MultiValuedProperty |
| 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 |
-ConditionalDepartment
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
ConditionalDepartment 매개 변수는 받는 사람의 Department 속성 값을 기반으로 하는 미리 검사된 필터를 지정합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.
이 매개 변수에 여러 값을 사용하면 OR 부울 연산자가 적용됩니다. 조건부 매개 변수의 작동 방식에 대한 자세한 내용은 이 항목의 자세한 설명 섹션을 참조하세요.
이 매개 변수를 사전 검사된 필터의 일부로 IncludedRecipients 매개 변수와 함께 사용합니다. RecipientFilter 매개 변수와 함께 조건부 매개 변수를 사용할 수 없습니다(사용자 지정 OPATH 필터를 만드는 데 사용됨).
| Type: | MultiValuedProperty |
| 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 |
-ConditionalStateOrProvince
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
ConditionalStateOrProvince 매개 변수는 받는 사람의 StateOrProvince 속성 값을 기반으로 하는 미리 검사된 필터를 지정합니다. 쉼표로 구분하여 여러 값을 지정할 수 있습니다.
이 매개 변수에 여러 값을 사용하면 OR 부울 연산자가 적용됩니다. 조건부 매개 변수의 작동 방식에 대한 자세한 내용은 이 항목의 자세한 설명 섹션을 참조하세요.
이 매개 변수를 사전 검사된 필터의 일부로 IncludedRecipients 매개 변수와 함께 사용합니다. RecipientFilter 매개 변수와 함께 조건부 매개 변수를 사용할 수 없습니다(사용자 지정 OPATH 필터를 만드는 데 사용됨).
| Type: | MultiValuedProperty |
| 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 |
-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 |
-DisabledEmailAddressTemplates
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
DisabledEmailAddressTemplates 매개 변수는 전자 메일 주소 정책에 포함되지만 받는 사람의 전자 메일 주소를 구성하는 데 사용되지 않는 프록시 전자 메일 주소 템플릿을 지정합니다.
이 매개 변수에 대한 유효한 구문은 입니다 Type:AddressFormat.
- 형식: Exchange Server Email 주소 정책의 "주소 유형" 섹션에 설명된 대로 유효한 전자 메일 주소 유형입니다. 예를 들어 smtp 또는 X400입니다. SMTP를 사용하여 비활성화된 기본 SMTP 전자 메일 주소를 지정할 수 없습니다.
- AddressFormat: SMTP 전자 메일 주소의 경우 허용된 도메인(신뢰할 수 있는 또는 내부 릴레이)으로 구성된 도메인 또는 하위 도메인과 Exchange Server 주소 정책 Email "주소 형식" 섹션에 설명된 유효한 변수 및 ASCII 텍스트 문자입니다. 예: alias@contoso.com 값이 필요하고 firstname.lastname@contoso.com 값
%m@contoso.com%g.%s@contoso.com이 필요합니다.
비활성화된 여러 전자 메일 주소 템플릿을 쉼표로 구분하여 지정할 수 있습니다. "[Type1:]EmailAddress1","[Type2:]EmailAddress2",..."[TypeN:]EmailAddressN"
| Type: | ProxyAddressTemplateCollection |
| 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 |
-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 |
-EnabledEmailAddressTemplates
차단된 파일 형식을 구성하려면 FileTypes 매개 변수를 사용합니다.
이 매개 변수에 대한 유효한 구문은 입니다 Type:AddressFormat.
- 형식: Exchange Server Email 주소 정책의 "주소 유형" 섹션에 설명된 대로 유효한 전자 메일 주소 유형입니다. 예를 들어 기본 전자 메일 주소의 경우 SMTP, 프록시 주소의 경우 smtp입니다.
- AddressFormat: SMTP 전자 메일 주소의 경우 허용된 도메인(신뢰할 수 있는 또는 내부 릴레이)으로 구성된 도메인 또는 하위 도메인과 Exchange Server 주소 정책 Email "주소 형식" 섹션에 설명된 유효한 변수 및 ASCII 텍스트 문자입니다. 예: alias@contoso.com 값이 필요하고 firstname.lastname@contoso.com 값
%m@contoso.com%g.%s@contoso.com이 필요합니다.
이 매개 변수에는 기본 SMTP 이메일 주소를 정의하기 위해 Type 값 SMTP가 있는 템플릿이 하나 이상 필요합니다. 그런 다음 템플릿에 대한 형식 접두사를 포함하지 않으면 smtp(SMTP 프록시 주소) 값이 가정됩니다.
여러 전자 메일 주소 템플릿을 쉼표로 구분하여 지정할 수 있습니다. "SMTP:PrimarySMTPEmailAddress","[Type1:]EmailAddress1","[Type2:]EmailAddress2",..."[TypeN:]EmailAddressN"
EnabledPrimarySMTPAddressTemplate 매개 변수에는 이 매개 변수를 사용할 수 없습니다.
Exchange Online PowerShell에서는 이메일 주소 템플릿에서 변수를 사용할 수 없습니다.
| Type: | ProxyAddressTemplateCollection |
| Position: | Named |
| 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 |
-EnabledPrimarySMTPAddressTemplate
EnabledPrimarySMTPAddressTemplate 매개 변수는 받는 사람에 대한 기본 SMTP 전자 메일 주소를 생성하는 데 사용되는 이메일 주소 정책의 규칙을 지정합니다. 정책이 기본 전자 메일 주소만 적용하고 추가 프록시 주소가 없는 경우 EnabledEmailAddressTemplates 대신 이 매개 변수를 사용할 수 있습니다.
이 매개 변수에 대한 유효한 구문은 신뢰할 수 있는 허용 도메인으로 구성된 도메인 또는 하위 도메인이며, Exchange Server Email 주소 정책의 "주소 형식" 섹션에 설명된 대로 유효한 변수 및 ASCII 텍스트 문자입니다. 예: alias@contoso.com 값이 필요하고 firstname.lastname@contoso.com 값%m@contoso.com%g.%s@contoso.com이 필요합니다.
EnabledEmailAddressTemplates 매개 변수에는 이 매개 변수를 사용할 수 없습니다.
Exchange Online PowerShell에서는 이메일 주소 템플릿에서 변수를 사용할 수 없습니다.
| Type: | String |
| Position: | Named |
| 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 |
-IncludedRecipients
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
IncludedRecipients 매개 변수는 받는 사람 유형을 기반으로 하는 미리 검색된 필터를 지정합니다. 유효한 값은 다음과 같습니다.
- AllRecipients: 이 값은 단독으로만 사용할 수 있습니다.
- MailboxUsers
- MailContacts
- MailGroups
- MailUsers
- MailUsers
쉼표로 구분하여 여러 값을 지정할 수 있습니다. 여러 값을 사용하면 OR 부울 연산자가 적용됩니다.
미리 검색된 필터의 일부로 조건부 매개 변수를 사용하는 경우 이 매개 변수를 사용해야 합니다. 이 매개 변수는 RecipientFilter 매개 변수(사용자 지정 OPATH 필터를 만드는 데 사용됨)와 함께 사용할 수 없습니다.
| Type: | WellKnownRecipientType |
| Position: | Named |
| 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 |
-IncludeUnifiedGroupRecipients
이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.
IncludeUnifiedGroupRecipients 스위치는 이메일 주소 정책이 Microsoft 365 그룹만 적용되도록 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
Exchange Online PowerShell에서는 Exchange Online 전자 메일 주소 정책이 Microsoft 365 그룹에만 적용되므로 항상 이 스위치를 사용해야 합니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ManagedByFilter
이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.
ManagedByFilter 매개 변수는 Microsoft 365 그룹 만드는 사용자의 속성에 따라 Microsoft 365 그룹 적용할 이메일 주소 정책을 지정합니다.
이 매개 변수는 사용 가능한 받는 사람 속성의 값(예 "Department -eq 'Sales'": )을 기반으로 하는 OPATH 필터입니다. 사용 가능한 모든 Windows PowerShell 연산자를 사용할 수 있으며 와일드카드 및 부분 일치가 지원됩니다. 검색 조건은 구문을 "Property -ComparisonOperator 'Value'"사용합니다.
- 전체 OPATH 필터를 큰따옴표 " "로 묶습니다. 필터에 시스템 값(예
$true: ,$false또는$null)이 포함된 경우 대신 작은따옴표 ' 를 사용합니다. 이 매개 변수는 문자열(시스템 블록이 아님)이지만 중괄호 { }를 사용할 수도 있지만 필터에 변수가 없는 경우에만 사용할 수 있습니다. - 속성은 필터링 가능한 속성입니다. 필터링 가능한 받는 사람 속성은 RecipientFilter 매개 변수에 대한 필터링 가능한 속성을 참조하세요.
- ComparisonOperator는 OPATH 비교 연산자입니다(예
-eq: 같음 및-like문자열 비교의 경우). 비교 연산자에 대한 자세한 내용은 about_Comparison_Operators 참조하세요. - 값은 검색할 속성 값입니다. 텍스트 값과 변수를 작은따옴표(
'Value'또는'$Variable')로 묶습니다. 변수 값에 작은따옴표가 포함된 경우 변수를 올바르게 확장하려면 작은따옴표를 식별(이스케이프)해야 합니다. 예를 들어 대신 를'$User'사용합니다'$($User -Replace "'","''")'. 정수 또는 시스템 값을 따옴표로 묶지 마세요(예: , ,$true$false또는$null를 대신 사용500). - 와일드카드를 첫 번째 문자로 사용할 수 없습니다. 예를 들어 는
'Sales*'허용되지만'*Sales'허용되지 않습니다.
자세한 내용은 Microsoft 365 그룹 만들 때 사용할 도메인 선택을 참조하세요.
Exchange의 OPATH 필터에 대한 자세한 내용은 추가 OPATH 구문 정보를 참조하세요.
IncludeUnifiedGroupRecipients 스위치를 사용하는 Exchange Online PowerShell에서만 이 매개 변수를 사용할 수 있습니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Name
Name 매개 변수는 이메일 주소 정책의 고유한 이름을 지정합니다. 최대 길이는 64자입니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.
| 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 매개 변수는 이메일 주소 정책이 평가되는 순서를 지정합니다. 기본적으로 새 전자 메일 주소 정책을 추가할 때마다 정책에는 N+1의 우선 순위가 할당됩니다. 여기서 N은 사용자가 만든 전자 메일 주소 정책의 수입니다.
Priority 매개 변수는 전자 메일 주소 정책이 평가되는 순서를 지정합니다. 기본적으로 새 전자 메일 주소 정책에 추가될 때마다 정책에 N+1의 우선 순위가 지정됩니다. 여기서 N은 사용자가 만든 전자 메일 주소 정책의 개수입니다.
참고: 받는 사람을 식별하는 첫 번째 전자 메일 주소 정책은 받는 사람의 전자 메일 주소를 구성합니다. 첫 번째 정책이 적용되지 않고 받는 사람의 전자 메일 주소를 구성할 수 없어도 다른 모든 정책은 무시됩니다.
| Type: | EmailAddressPolicyPriority |
| 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 |
-RecipientContainer
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
RecipientContainer 매개 변수는 Active Directory에서 받는 사람의 위치를 기반으로 하는 필터를 지정합니다. 이 매개 변수에 대한 유효한 입력은 Get-OrganizationalUnit cmdlet에서 반환하는 OU(조직 구성 단위) 또는 도메인입니다. OU 또는 도메인을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.
- 이름
- 이름
- DN(고유 이름)
- GUID
GUID
| Type: | OrganizationalUnitIdParameter |
| 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 |
-RecipientFilter
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
RecipientFilter 매개 변수는 사용 가능한 모든 받는 사람 속성의 값을 기반으로 하는 사용자 지정 OPATH 필터를 지정합니다. 사용 가능한 모든 Windows PowerShell 연산자를 사용할 수 있으며 와일드카드 및 부분 일치가 지원됩니다. 검색 조건은 구문을 "Property -ComparisonOperator 'Value'"사용합니다.
- 전체 OPATH 필터를 큰따옴표 " "로 묶습니다. 필터에 시스템 값(예
$true: ,$false또는$null)이 포함된 경우 대신 작은따옴표 ' 를 사용합니다. 이 매개 변수는 문자열(시스템 블록이 아님)이지만 중괄호 { }를 사용할 수도 있지만 필터에 변수가 없는 경우에만 사용할 수 있습니다. - 속성은 필터링 가능한 속성입니다. 필터링 가능한 속성은 RecipientFilter 매개 변수에 대한 필터링 가능한 속성을 참조하세요.
- ComparisonOperator는 OPATH 비교 연산자입니다(예
-eq: 같음 및-like문자열 비교의 경우). 비교 연산자에 대한 자세한 내용은 about_Comparison_Operators 참조하세요. - 값은 필터링할 속성 값입니다. 텍스트 값과 변수를 작은따옴표(
'Value'또는'$Variable')로 묶습니다. 변수 값에 작은따옴표가 포함된 경우 변수를 올바르게 확장하려면 작은따옴표를 식별(이스케이프)해야 합니다. 예를 들어 대신 를'$User'사용합니다'$($User -Replace "'","''")'. 정수 또는 시스템 값을 따옴표로 묶지 마세요(예: , ,$true$false또는$null를 대신 사용500). - 클라우드 기반 환경에서는 와일드카드를 첫 번째 문자로 사용할 수 없습니다. 예를 들어 는
'Sales*'허용되지만'*Sales'허용되지 않습니다. - 온-프레미스 Exchange에서 와일드카드는 첫 번째 또는 마지막 문자로만 유효합니다. 예를 들어 또는
'Sales*''*Sales'는 허용되지만'Sa*les'허용되지 않습니다.
Exchange의 OPATH 필터에 대한 자세한 내용은 추가 OPATH 구문 정보를 참조하세요.
이 매개 변수는 IncludedRecipients 매개 변수 또는 조건부 매개 변수(미리 검색된 필터를 만드는 데 사용됨)와 함께 사용할 수 없습니다.
| Type: | String |
| Position: | Named |
| 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 |
-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은 데이터를 반환하지 않습니다.