New-EmailAddressPolicy(RTM)
적용 대상: Exchange Server 2007
마지막으로 수정된 항목: 2007-06-05
New-EmailAddressPolicy cmdlet를 사용하여 새 전자 메일 주소 정책을 만들 수 있습니다.
구문
New-EmailAddressPolicy -Name <String> -EnabledPrimarySMTPAddressTemplate <String> -IncludedRecipients <Nullable> [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <String>] [-ConditionalCustomAttribute10 <String>] [-ConditionalCustomAttribute11 <String>] [-ConditionalCustomAttribute12 <String>] [-ConditionalCustomAttribute13 <String>] [-ConditionalCustomAttribute14 <String>] [-ConditionalCustomAttribute15 <String>] [-ConditionalCustomAttribute2 <String>] [-ConditionalCustomAttribute3 <String>] [-ConditionalCustomAttribute4 <String>] [-ConditionalCustomAttribute5 <String>] [-ConditionalCustomAttribute6 <String>] [-ConditionalCustomAttribute7 <String>] [-ConditionalCustomAttribute8 <String>] [-ConditionalCustomAttribute9 <String>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>]
New-EmailAddressPolicy -Name <String> -EnabledPrimarySMTPAddressTemplate <String> -RecipientFilter <String> [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>]
New-EmailAddressPolicy -Name <String> -EnabledEmailAddressTemplates <ProxyAddressTemplateCollection> -RecipientFilter <String> [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>]
New-EmailAddressPolicy -Name <String> -EnabledEmailAddressTemplates <ProxyAddressTemplateCollection> -IncludedRecipients <Nullable> [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <String>] [-ConditionalCustomAttribute10 <String>] [-ConditionalCustomAttribute11 <String>] [-ConditionalCustomAttribute12 <String>] [-ConditionalCustomAttribute13 <String>] [-ConditionalCustomAttribute14 <String>] [-ConditionalCustomAttribute15 <String>] [-ConditionalCustomAttribute2 <String>] [-ConditionalCustomAttribute3 <String>] [-ConditionalCustomAttribute4 <String>] [-ConditionalCustomAttribute5 <String>] [-ConditionalCustomAttribute6 <String>] [-ConditionalCustomAttribute7 <String>] [-ConditionalCustomAttribute8 <String>] [-ConditionalCustomAttribute9 <String>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>]
자세한 정보
New-EmailAddressPolicy cmdlet는 새 전자 메일 주소 정책을 만들고 이를 적용합니다. 새 전자 메일 주소 정책은 Active Directory 디렉터리 서비스의 Microsoft Exchange 조직 구성 컨테이너 아래에서 만들어집니다.
New-EmailAddressPolicy cmdlet를 실행하려면 사용하는 계정이 다음을 위임받아야 합니다.
- Exchange 조직 관리자 역할
사용 권한, 역할 위임 및 Exchange Server 2007 관리에 필요한 권한에 대한 자세한 내용은 사용 권한 고려 사항을 참조하십시오.
매개 변수
| 매개 변수 | 필수 | 종류 | 설명 |
|---|---|---|---|
EnabledEmailAddressTemplates |
필수 |
Microsoft.Exchange.Data.ProxyAddressTemplateCollection |
EnabledEmailAddressTemplates 매개 변수는 전자 메일 주소 정책에 포함되어 있으며 사용 가능한 프록시 주소를 지정합니다. 여러 개의 값은 쉼표로 분리합니다. 각 프록시 주소의 도메인 부분은 기존에 허용된 도메인과 일치해야 합니다. |
EnabledPrimarySMTPAddressTemplate |
필수 |
System.String |
EnabledPrimarySMTPAddressTemplate 매개 변수는 사용 가능하며 전자 메일 주소 정책에 포함되어 있는 프록시 주소를 지정합니다. 각 프록시 주소의 도메인 부분은 기존에 허용된 도메인과 일치해야 합니다. |
IncludedRecipients |
필수 |
System.Nullable |
IncludedRecipients 매개 변수는 전자 메일 주소 정책을 설정하기 위해 사용되는 받는 사람을 필터링합니다. AllRecipients 값은 단독으로만 사용할 수 있습니다. IncludedRecipients 매개 변수의 여러 값이 쉼표로 구분된 경우에는 OR 부울 연산자가 적용됩니다. |
Name |
필수 |
System.String |
Name 매개 변수는 전자 메일 주소 정책의 이름을 지정합니다. |
RecipientFilter |
필수 |
System.String |
RecipientFilter 매개 변수는 전자 메일 주소 정책에 포함할 받는 사람에 대한 필터를 지정합니다. 다음 필터 매개 변수 중 하나라도 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다.
필터링할 수 있는 속성에 대한 자세한 내용은 -RecipientFilter 매개 변수의 필터링할 수 있는 속성을 참조하십시오. |
ConditionalCompany |
선택 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalCompany 매개 변수는 회사별로 필터링합니다. 이 매개 변수는 여러 개의 값을 쉼표로 분리된 목록으로 받습니다. |
ConditionalCustomAttribute1 |
선택 |
System.String |
ConditionalCustomAttribute1 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. |
ConditionalCustomAttribute10 |
선택 |
System.String |
ConditionalCustomAttribute10 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. |
ConditionalCustomAttribute11 |
선택 |
System.String |
ConditionalCustomAttribute11 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. |
ConditionalCustomAttribute12 |
선택 |
System.String |
ConditionalCustomAttribute12 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. |
ConditionalCustomAttribute13 |
선택 |
System.String |
ConditionalCustomAttribute13 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. |
ConditionalCustomAttribute14 |
선택 |
System.String |
ConditionalCustomAttribute14 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. |
ConditionalCustomAttribute15 |
선택 |
System.String |
ConditionalCustomAttribute15 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. |
ConditionalCustomAttribute2 |
선택 |
System.String |
ConditionalCustomAttribute2 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. |
ConditionalCustomAttribute3 |
선택 |
System.String |
ConditionalCustomAttribute3 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. |
ConditionalCustomAttribute4 |
선택 |
System.String |
ConditionalCustomAttribute4 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. |
ConditionalCustomAttribute5 |
선택 |
System.String |
ConditionalCustomAttribute5 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. |
ConditionalCustomAttribute6 |
선택 |
System.String |
ConditionalCustomAttribute6 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. |
ConditionalCustomAttribute7 |
선택 |
System.String |
ConditionalCustomAttribute7 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. |
ConditionalCustomAttribute8 |
선택 |
System.String |
ConditionalCustomAttribute8 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. |
ConditionalCustomAttribute9 |
선택 |
System.String |
ConditionalCustomAttribute9 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. |
ConditionalDepartment |
선택 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalDepartment 매개 변수는 부서별로 필터링합니다. 이 매개 변수는 여러 개의 값을 쉼표로 분리된 목록으로 받습니다. |
ConditionalStateOrProvince |
선택 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalStateOrProvince 매개 변수는 시/도별로 필터링합니다. 이 매개 변수는 여러 개의 값을 쉼표로 분리된 목록으로 받습니다. |
DisabledEmailAddressTemplates |
선택 |
Microsoft.Exchange.Data.ProxyAddressTemplateCollection |
DisabledEmailAddressTemplates 매개 변수는 전자 메일 주소 정책에 포함되어 있으며 사용 가능하지 않은 프록시 주소를 정의합니다. 이 매개 변수는 여러 개의 값을 쉼표로 분리된 목록으로 받습니다. |
DomainController |
선택 |
Microsoft.Exchange.Data.Fqdn |
이 구성 변경을 Active Directory에 기록하는 도메인 컨트롤러의 FQDN(정규화된 도메인 이름)을 지정하려면 명령에 DomainController 매개 변수를 포함시킵니다. |
Priority |
선택 |
Microsoft.Exchange.Data.Directory.SystemConfiguration.EmailAddressPolicyPriority |
Priority 매개 변수는 현재 우선 순위를 이 매개 변수의 인수로서 지정된 우선 순위보다 높게 설정합니다. |
TemplateInstance |
선택 |
System.Management.Automation.PSObject |
TemplateInstance 매개 변수에 기존 개체를 제공하면, 이 명령은 해당 개체의 구성을 사용하여 로컬 또는 대상 서버에서 해당 개체의 동일한 복제본을 만듭니다. |
입력 형식
반환 형식
오류
| 오류 | 설명 |
|---|---|
예외
| 예외 | 설명 |
|---|---|
예제
다음 코드는 New-EmailAddressPolicy 명령의 예입니다.
New-EmailAddressPolicy -Name "MyPolicy" -IncludedRecipients MailboxUsers -EnabledPrimarySMTPAddressTemplate SMTP:@contoso.com