Set-DistributionGroup(RTM)

  • 아티클

 

적용 대상: Exchange Server 2007

마지막으로 수정된 항목: 2007-06-05

Set-DistributionGroup cmdlet를 사용하여 기존 메일 그룹의 설정을 수정할 수 있습니다.

구문

Set-DistributionGroup -Identity <DistributionGroupIdParameter> [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-ExpansionServer <String>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-ReportToManagerEnabled <$true | $false>] [-ReportToOriginatorEnabled <$true | $false>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SendOofMessageToOriginatorEnabled <$true | $false>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-WindowsEmailAddress <SmtpAddress>]

Set-DistributionGroup [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-ExpansionServer <String>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-Instance <DistributionGroup>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-ReportToManagerEnabled <$true | $false>] [-ReportToOriginatorEnabled <$true | $false>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SendOofMessageToOriginatorEnabled <$true | $false>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-WindowsEmailAddress <SmtpAddress>]

자세한 정보

메일 그룹은 전자 메일 메시지에 대해 받는 사람 그룹을 하나의 연락처로 통합하는 데 사용됩니다. 메일 그룹은 Active Directory 디렉터리 서비스의 네트워크 리소스에 권한을 할당하는 데 사용할 수 없습니다. Set-DistributionGroup cmdlet를 사용하여 기존 설정을 덮어쓰거나 새 설정을 추가할 수 있습니다.

Set-DistributionGroup cmdlet를 실행하려면 사용하는 계정이 다음을 위임받아야 합니다.

  • Exchange 받는 사람 관리자 역할

사용 권한, 역할 위임 및 Exchange Server 2007 관리에 필요한 권한에 대한 자세한 내용은 사용 권한 고려 사항을 참조하십시오.

매개 변수

매개 변수 필수 종류 설명

Identity

필수

Microsoft.Exchange.Configuration.Tasks.DistributionGroupIdParameter

Identity 매개 변수는 수정하려는 개체를 지정합니다. Identity 매개 변수는 메일 그룹에 대해 다음 값 중 하나를 사용할 수 있습니다.

  • DN(고유 이름)

  • 정식 이름

  • GUID

  • Name

  • 표시 이름

  • Alias

  • Exchange DN

  • 기본 SMTP(Simple Mail Transfer Protocol) 주소

Instance 매개 변수가 지정된 경우에는 Identity 매개 변수를 사용할 수 없습니다.

AcceptMessagesOnlyFrom

선택

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

AcceptMessagesOnlyFrom 매개 변수는 이 메일 그룹에 전자 메일 메시지를 보낼 수 있는 사서함 사용자와 전자 메일 사용 가능 연락처를 지정합니다. AcceptMessagesOnlyFrom 매개 변수는 유효한 보낸 사람에 대해 다음 값을 사용할 수 있습니다.

  • DN(고유 이름)

  • 정식 이름

  • GUID

  • Name

  • 표시 이름

  • Alias

  • Exchange DN

  • 기본 SMTP 전자 메일 주소

기본적으로 이 매개 변수의 값은 비어 있습니다. 따라서 메일 그룹은 모든 사서함 사용자 및 메일 사용 가능 연락처에서 보낸 메시지를 수락할 수 있습니다.

AcceptMessagesOnlyFromDLMembers

선택

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

AcceptMessagesOnlyFromDLMembers 매개 변수는 이 메일 그룹에 전자 메일 메시지를 보낼 수 있는 메일 그룹을 지정합니다. 허용된 메일 그룹에 대해 다음 값을 사용할 수 있습니다.

  • DN(고유 이름)

  • 정식 이름

  • GUID

  • Name

  • 표시 이름

  • 레거시 Exchange DN

  • 기본 SMTP 전자 메일 주소

기본적으로 이 매개 변수의 값은 비어 있습니다. 따라서 메일 그룹은 모든 메일 그룹에서 보낸 메시지를 수락할 수 있습니다.

Alias

선택

System.String

Alias 매개 변수는 개체의 별칭을 지정하는 데 사용할 수 있습니다. Alias의 값은 공백을 포함할 수 없습니다.

CreateDTMFMap

선택

System.Boolean

이 매개 변수는 메일 그룹에 대해 DTMF(복합 주파수 부호) 맵을 만들도록 지정합니다.

CustomAttribute1

선택

System.String

CustomAttribute1 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute10

선택

System.String

CustomAttribute10 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute11

선택

System.String

CustomAttribute11 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute12

선택

System.String

CustomAttribute12 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute13

선택

System.String

CustomAttribute13 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute14

선택

System.String

CustomAttribute14 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute15

선택

System.String

CustomAttribute15 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute2

선택

System.String

CustomAttribute2 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute3

선택

System.String

CustomAttribute3 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute4

선택

System.String

CustomAttribute4 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute5

선택

System.String

CustomAttribute5 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute6

선택

System.String

CustomAttribute6 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute7

선택

System.String

CustomAttribute7 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute8

선택

System.String

CustomAttribute8 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

CustomAttribute9

선택

System.String

CustomAttribute9 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

DisplayName

선택

System.String

DisplayName 매개 변수는 Exchange 관리 콘솔 및 Exchange GAL(전체 주소 목록)에 메일 그룹의 이름을 지정하는 데 사용할 수 있습니다.

DomainController

선택

Microsoft.Exchange.Data.Fqdn

이 구성 변경을 Active Directory에 기록하는 도메인 컨트롤러의 FQDN(정규화된 도메인 이름)을 지정하려면 DomainController 매개 변수를 포함시킵니다.

EmailAddresses

선택

Microsoft.Exchange.Data.ProxyAddressCollection

EmailAddresses 매개 변수는 메일 그룹의 전자 메일 별칭을 지정하는 데 사용할 수 있습니다. 모든 올바른 Microsoft Exchange Server 2007 전자 메일 주소 형식을 사용할 수 있습니다. EmailAddresses 매개 변수에 대해 여러 값을 쉼표로 구분된 목록으로 지정할 수 있습니다.

EmailAddressPolicyEnabled

선택

System.Boolean

EmailAddressPolicyEnabled 매개 변수는 이 메일 그룹에 대한 전자 메일 주소 정책 적용을 제어하는 데 사용할 수 있습니다. 유효한 값은 $true 또는 $false입니다. 기본값은 $true입니다. 기본적으로 해당되는 모든 전자 메일 주소 정책이 이 메일 그룹에 적용됩니다.

ExpansionServer

선택

System.String

ExpansionServer 매개 변수는 메일 그룹을 확장하는 데 사용되는 Exchange 서버를 지정합니다. 레거시 Exchange DN 값으로 확장 서버를 입력합니다. 기본 작업은 가장 가까운 Exchange Server 2003 컴퓨터나 허브 전송 서버 역할이 설치된 가장 가까운 Exchange 2007 서버를 사용하는 것입니다.

GrantSendOnBehalfTo

선택

Microsoft.Exchange.Configuration.Tasks.MailboxOrMailUserIdParameter[]

GrantSendOnBehalfTo 매개 변수는 이 메일 그룹을 대신하여 메시지를 보낼 수 있는 사서함 사용자를 지정합니다. GrantSendOnBehalfTo 매개 변수에는 다음 값 중 하나를 사용할 수 있습니다.

  • DN(고유 이름)

  • GUID

  • Name

  • 표시 이름

  • 정식 이름

  • 레거시 Exchange DN

  • Alias

  • 기본 SMTP 전자 메일 주소

기본적으로 GrantSendOnBehalfTo의 값은 비어 있습니다. 즉, 다른 사서함 사용자가 이 메일 그룹 대신 보낼 수 있는 권한을 갖지 않습니다.

HiddenFromAddressListsEnabled

선택

System.Boolean

HiddenFromAddressListsEnabled 매개 변수는 Exchange 주소 목록에서 메일 그룹을 숨기는 데 사용할 수 있습니다. 유효한 값은 $true 또는 $false입니다. 기본값은 $false입니다.

Instance

선택

Microsoft.Exchange.Data.Directory.Management.DistributionGroup

Instance 매개 변수를 사용하면 처리할 명령에 전체 개체를 전달할 수 있습니다. 이 매개 변수는 주로 전체 개체를 명령에 전달해야 하는 스크립트에서 사용됩니다.

Identity 매개 변수가 지정된 경우에는 Instance 매개 변수를 사용할 수 없습니다.

MaxReceiveSize

선택

Microsoft.Exchange.Data.Unlimited

MaxReceiveSize 매개 변수는 이 메일 그룹에 보낼 수 있도록 허용된 최대 전자 메일 메시지 크기를 설정하는 데 사용할 수 있습니다. 값을 입력할 때 다음 단위 중 하나로 값을 한정합니다.

  • B(바이트)

  • KB(킬로바이트)

  • MB(메가바이트)

  • GB(기가바이트)

  • TB(테라바이트)

정규화되지 않은 값은 바이트로 처리합니다. 사용할 수 있는 값은 0에서 2147482624바이트 사이의 값입니다.

기본적으로 MaxReceiveSize 매개 변수는 unlimited로 설정됩니다.

MaxSendSize

선택

Microsoft.Exchange.Data.Unlimited

MaxSendSize 매개 변수는 이 메일 그룹에서 보낼 수 있도록 허용된 최대 전자 메일 메시지 크기를 지정하는 데 사용할 수 있습니다. 값을 입력할 때 다음 단위 중 하나로 값을 한정합니다.

  • B(바이트)

  • KB(킬로바이트)

  • MB(메가바이트)

  • GB(기가바이트)

  • TB(테라바이트)

정규화되지 않은 값은 바이트로 처리합니다. 사용할 수 있는 값은 0에서 2147482624바이트 사이의 값입니다.

기본적으로 MaxSendSize 매개 변수는 unlimited로 설정됩니다.

Name

선택

System.String

Name 매개 변수는 메일 그룹의 이름을 지정합니다. Name 매개 변수는 Active Directory 사용자 및 컴퓨터와 Exchange 관리 콘솔의 그룹 이름 필드에 메일 그룹을 지정합니다.

PrimarySmtpAddress

선택

Microsoft.Exchange.Data.SmtpAddress

PrimarySmtpAddress 매개 변수는 메일 그룹의 기본 반환 SMTP 전자 메일 주소를 지정합니다. 이 매개 변수는 메일 그룹에 여러 SMTP 전자 메일 주소가 있는 경우만 의미가 있습니다.

RejectMessagesFrom

선택

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

RejectMessagesFrom 매개 변수는 이 메일 그룹에 전자 메일 메시지를 보낼 수 없는 사서함 사용자와 전자 메일 사용 가능 연락처를 지정합니다. 금지된 보낸 사람에 대해 다음 값을 사용할 수 있습니다.

  • DN(고유 이름)

  • 정식 이름

  • GUID

  • Name

  • 표시 이름

  • 레거시 Exchange DN

  • 기본 SMTP 전자 메일 주소

기본적으로 이 매개 변수의 값은 비어 있습니다. 따라서 메일 그룹은 모든 사서함 사용자 및 메일 사용 가능 연락처에서 보낸 메시지를 수락할 수 있습니다.

RejectMessagesFromDLMembers

선택

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

RejectMessagesFromDLMembers 매개 변수는 메일 그룹에 전자 메일 메시지를 보낼 수 없는 메일 그룹을 지정합니다. 금지된 메일 그룹에 대해 다음 값을 사용할 수 있습니다.

  • DN(고유 이름)

  • 정식 이름

  • GUID

  • Name

  • 표시 이름

  • 레거시 Exchange DN

  • 기본 SMTP 전자 메일 주소

기본적으로 이 매개 변수의 값은 비어 있습니다. 따라서 메일 그룹은 모든 메일 그룹에서 보낸 메시지를 수락할 수 있습니다.

ReportToManagerEnabled

선택

System.Boolean

ReportToManagerEnabled 매개 변수는 메일 그룹 관리자에게 배달 보고서를 보내도록 허용합니다. 유효한 값은 $true 또는 $false입니다. 기본값은 $false입니다.

ReportToOriginatorEnabled

선택

System.Boolean

ReportToOriginatorEnabled 매개 변수는 이 메일 그룹에 전자 메일 메시지를 보낸 사람에게 배달 보고서를 보내도록 허용합니다. 유효한 값은 $true 또는 $false입니다. 기본값은 $true입니다.

RequireSenderAuthenticationEnabled

선택

System.Boolean

RequireSenderAuthenticationEnabled 매개 변수를 사용하는 경우 인증된 보낸 사람이 보낸 전자 메일 메시지를 배달해야 합니다. 값이 $true이면 인증된 사용자가 보낸 메시지만 수락합니다. 유효한 값은 $true 또는 $false입니다. 기본값은 $true입니다.

SamAccountName

선택

System.String

SamAccountName 매개 변수는 이전 운영 체제를 실행하는 개체의 클라이언트 이름을 지정합니다. SamAccountName 매개 변수는 Active Directory 및 Exchange 관리 콘솔에서 그룹 이름(Windows 2000 이전) 필드에 표시됩니다.

SendOofMessageToOriginatorEnabled

선택

System.Boolean

SendOofMessageToOriginatorEnabled 매개 변수는 이 메일 그룹에 전자 메일 메시지를 보낸 사람에게 부재 중 메시지를 배달하도록 허용합니다. 유효한 값은 $true 또는 $false입니다. 기본값은 $false입니다.

SimpleDisplayName

선택

System.String

SimpleDisplayName 매개 변수는 제한된 문자 집합만 허용되는 경우 개체에 대한 대체 설명을 표시하는 데 사용됩니다. 제한된 문자 집합은 26자에서 126자까지의 ASCII 문자로 구성됩니다.

UMDtmfMap

선택

Microsoft.Exchange.Data.MultiValuedProperty

이 매개 변수는 UM 사용 가능 메일 그룹에 대해 사용자 정의 DTMF 맵을 만들지 여부를 지정합니다.

WindowsEmailAddress

선택

Microsoft.Exchange.Data.SmtpAddress

WindowsEmailAddress 매개 변수는 Active Directory 개체의 전자 메일 필드 값을 지정합니다.

입력 형식

반환 형식

오류

오류 설명

 

 

예외

예외 설명

 

 

예제

다음 코드 예에서는 Set-DistributionGroup 명령을 사용하여 Accounting이라는 기존 메일 그룹의 표시 이름을 Accounting Group으로 변경하는 방법을 보여줍니다.

Set-DistributionGroup -Identity "Accounting" -DisplayName "Accounting Group"