Set-CMEmailProfile

모듈:

ConfigurationManager

전자 메일 프로필을 설정합니다.

Syntax

Set-CMEmailProfile
   [-AccountDomainActiveDirectory <String>]
   [-AccountDomainCustom <String>]
   [-AccountName <String>]
   [-AccountUserNameType <String>]
   [-AllowMessageMove <Boolean>]
   [-AllowThirdPartyApplication <Boolean>]
   [-Description <String>]
   [-EmailAddressType <String>]
   [-EnableSmime <Boolean>]
   [-IdentityCertificate <IResultObject>]
   -InputObject <IResultObject>
   [-MailSyncDays <MailNumberofDaysToSync>]
   [-NewName <String>]
   [-PassThru]
   [-SigningCertificate <IResultObject>]
   [-SupportedPlatform <IResultObject[]>]
   [-SyncContentType <EasProfileSyncContentType>]
   [-SynchronizeRecentlyUsed <Boolean>]
   [-SyncSchedule <Schedule>]
   [-UseSsl <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMEmailProfile
   [-AccountDomainActiveDirectory <String>]
   [-AccountDomainCustom <String>]
   [-AccountName <String>]
   [-AccountUserNameType <String>]
   [-AllowMessageMove <Boolean>]
   [-AllowThirdPartyApplication <Boolean>]
   [-Description <String>]
   [-EmailAddressType <String>]
   [-EnableSmime <Boolean>]
   -Id <Int32>
   [-IdentityCertificate <IResultObject>]
   [-MailSyncDays <MailNumberofDaysToSync>]
   [-NewName <String>]
   [-PassThru]
   [-SigningCertificate <IResultObject>]
   [-SupportedPlatform <IResultObject[]>]
   [-SyncContentType <EasProfileSyncContentType>]
   [-SynchronizeRecentlyUsed <Boolean>]
   [-SyncSchedule <Schedule>]
   [-UseSsl <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMEmailProfile
   [-AccountDomainActiveDirectory <String>]
   [-AccountDomainCustom <String>]
   [-AccountName <String>]
   [-AccountUserNameType <String>]
   [-AllowMessageMove <Boolean>]
   [-AllowThirdPartyApplication <Boolean>]
   [-Description <String>]
   [-EmailAddressType <String>]
   [-EnableSmime <Boolean>]
   [-IdentityCertificate <IResultObject>]
   [-MailSyncDays <MailNumberofDaysToSync>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-SigningCertificate <IResultObject>]
   [-SupportedPlatform <IResultObject[]>]
   [-SyncContentType <EasProfileSyncContentType>]
   [-SynchronizeRecentlyUsed <Boolean>]
   [-SyncSchedule <Schedule>]
   [-UseSsl <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Set-CMEmailProfile cmdlet은 Exchange ActiveSync 메일 프로필의 설정을 업데이트합니다.

참고

Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.

예제

예제 1: 이름으로 프로필 업데이트

PS XYZ:\> Set-CMEmailProfile -Name "EmailProfile1" -NewName "newEmailProfile1"

이 명령은 Exchange ActiveSync 이메일 프로필의 이름을 EmailProfile1에서 newEmailProfile1로 업데이트합니다.

예제 2: ID로 프로필 업데이트

PS XYZ:\> Set-CMEmailProfile -Id 16795654 -NewName "newEmailProfile2"

이 명령은 Exchange ActiveSync 이메일 프로필의 이름을 16795654 ID로 newEmailProfile2로 업데이트합니다.

예제 3: 프로필을 입력 개체로 업데이트

PS XYZ:\> $EmailProfile = Get-CMEmailProfile -Name "EmailProfile3"
PS XYZ:\> Set-CMEmailProfile -InputObject $EmailProfile -NewName "newEmailProfile3"

첫 번째 명령은 emailProfile3이라는 Exchange ActiveSync 메일 프로필 개체를 가져오고 개체를 $EmailProfile 변수에 저장합니다.

두 번째 명령은 $EmailProfile 저장된 이메일 프로필의 이름을 newEmailProfile3으로 변경합니다.

예제 4: 파이프라인을 사용하여 프로필 업데이트

PS XYZ:\> Get-CMEmailProfile -Name "EmailProfile4" | Set-CMEmailProfile -NewName "newEmailProfile4"

이 명령은 emailProfile4라는 Exchange ActiveSync 이메일 프로필 개체를 가져오고 파이프라인 연산자를 사용하여 개체를 Set-CMEmailProfile에 전달합니다. 그러면 메일 프로필 개체의 이름이 newEmailProfile4로 변경됩니다.

매개 변수

-AccountDomainActiveDirectory

Active Directory 계정 도메인의 유형을 지정합니다. 유효한 값은 다음과 같습니다.

• 도메인
• ntdomain

Type:	String
Accepted values:	domain, ntdomain
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AccountDomainCustom

사용자 지정 계정 도메인을 지정합니다. 이 매개 변수는 AccountUserNameType 매개 변수에 대해 sAMAccountName 값이 지정된 경우에만 사용할 수 있습니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AccountName

전자 메일 계정의 표시 이름을 지정합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AccountUserNameType

계정 사용자 이름 유형을 지정합니다. 유효한 값은 다음과 같습니다.

• 메일
• sAMAccountName
• userPrincipalName

Type:	String
Accepted values:	mail, sAMAccountName, userPrincipalName
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowMessageMove

사용자가 디바이스에서 구성한 여러 계정 간에 전자 메일 메시지를 이동할 수 있는지 여부를 나타냅니다.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowThirdPartyApplication

사용자가 기본이 아닌 특정 타사 전자 메일 애플리케이션에서 전자 메일을 보낼 수 있는지 여부를 나타냅니다.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Exchange ActiveSync 메일 프로필에 대한 설명을 지정합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EmailAddressType

전자 메일 주소 유형을 지정합니다. 유효한 값은 다음과 같습니다.

• 메일
• userPrincipalName

Type:	String
Accepted values:	mail, userPrincipalName
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableSmime

보내는 전자 메일이 S/MIME 암호화를 사용하여 전송되는지 여부를 나타냅니다.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

Exchange ActiveSync 메일 프로필의 CI_ID 지정합니다.

Type:	Int32
Aliases:	CI_ID, CIId
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-IdentityCertificate

ID 인증서 개체를 지정합니다. ID 인증서 개체를 가져오려면 Get-CMConfigurationPolicy cmdlet을 사용합니다.

Type:	IResultObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Exchange ActiveSync 메일 프로필 개체를 지정합니다. 이메일 프로필 개체를 가져오려면 Get-CMEmailProfile 함수를 사용합니다.

Type:	IResultObject
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-MailSyncDays

동기화할 전자 메일의 일 수를 지정합니다. 유효한 값은 다음과 같습니다.

• 무제한
• OneDay
• ThreeDays
• OneWeek
• TwoWeeks
• OneMonth

Type:	MailNumberofDaysToSync
Accepted values:	Unlimited, OneDay, ThreeDays, OneWeek, TwoWeeks, OneMonth
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Exchange ActiveSync 전자 메일 프로필의 이름을 지정합니다.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NewName

Exchange ActiveSync 메일 프로필의 새 이름을 지정합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

작업 중인 항목을 나타내는 개체를 반환하려면 이 매개 변수를 추가합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않을 수 있습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SigningCertificate

S/MIME 서명에 사용되는 서명 인증서 개체를 지정합니다. 서명 인증서 개체를 가져오려면 Get-CMConfigurationPolicy cmdlet을 사용합니다.

Type:	IResultObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SupportedPlatform

전자 메일 프로필을 설치할 운영 체제를 지정합니다. 지원되는 플랫폼 개체를 가져오려면 Get-CMSupportedPlatform cmdlet을 사용합니다.

Type:	IResultObject[]
Aliases:	SupportedPlatforms
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SyncContentType

디바이스와 동기화할 콘텐츠 형식을 지정합니다. 유효한 값은 다음과 같습니다.

• 없음
• 전자 메일
• 연락처
• 일정
• 작업
• 참고
• 전체

Type:	EasProfileSyncContentType
Aliases:	SyncContentTypes
Accepted values:	None, Email, Contacts, Calendar, Tasks, Notes, All
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SynchronizeRecentlyUsed

디바이스에서 최근에 사용된 전자 메일 주소 목록이 동기화되었는지 여부를 나타냅니다.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SyncSchedule

디바이스가 Exchange Server 데이터를 동기화할 일정을 지정합니다.

• 수동
• 15분
• 30분
• SixtyMins
• AsArrive

Type:	Schedule
Accepted values:	Manual, FifteenMins, ThirtyMins, SixtyMins, AsArrive
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseSsl

이메일을 보내고, 이메일을 받고, Exchange Server 통신할 때 SSL(Secure Sockets Layer) 통신이 사용되는지 여부를 나타냅니다.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

System.Object

관련 링크

• Get-CMConfigurationPolicy
• Get-CMEmailProfile
• Get-CMSupportedPlatform
• New-CMEmailProfile