Set-CMEmailProfile
전자 메일 프로필을 설정합니다.
구문
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
| 형식: | String |
| 허용되는 값: | domain, ntdomain |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-AccountDomainCustom
사용자 지정 계정 도메인을 지정합니다. 이 매개 변수는 AccountUserNameType 매개 변수에 대해 sAMAccountName 값이 지정된 경우에만 사용할 수 있습니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-AccountName
전자 메일 계정의 표시 이름을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-AccountUserNameType
계정 사용자 이름 유형을 지정합니다. 유효한 값은 다음과 같습니다.
- 메일
- sAMAccountName
- userPrincipalName
| 형식: | String |
| 허용되는 값: | mail, sAMAccountName, userPrincipalName |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-AllowMessageMove
사용자가 디바이스에서 구성한 여러 계정 간에 전자 메일 메시지를 이동할 수 있는지 여부를 나타냅니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-AllowThirdPartyApplication
사용자가 기본이 아닌 특정 타사 전자 메일 애플리케이션에서 전자 메일을 보낼 수 있는지 여부를 나타냅니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
| 형식: | SwitchParameter |
| 별칭: | cf |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Description
Exchange ActiveSync 전자 메일 프로필에 대한 설명을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DisableWildcardHandling
이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-EmailAddressType
전자 메일 주소 유형을 지정합니다. 유효한 값은 다음과 같습니다.
- 메일
- userPrincipalName
| 형식: | String |
| 허용되는 값: | mail, userPrincipalName |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-EnableSmime
보내는 전자 메일이 S/MIME 암호화를 사용하여 전송되는지 여부를 나타냅니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ForceWildcardHandling
이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Id
Exchange ActiveSync 전자 메일 프로필의 CI_ID 지정합니다.
| 형식: | Int32 |
| 별칭: | CI_ID, CIId |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-IdentityCertificate
ID 인증서 개체를 지정합니다. ID 인증서 개체를 가져오려면 Get-CMConfigurationPolicy cmdlet을 사용합니다.
| 형식: | IResultObject |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-InputObject
Exchange ActiveSync 전자 메일 프로필 개체를 지정합니다. 이메일 프로필 개체를 가져오려면 Get-CMEmailProfile 함수를 사용합니다.
| 형식: | IResultObject |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-MailSyncDays
동기화할 전자 메일의 일 수를 지정합니다. 유효한 값은 다음과 같습니다.
- 무제한
- OneDay
- ThreeDays
- OneWeek
- TwoWeeks
- OneMonth
| 형식: | MailNumberofDaysToSync |
| 허용되는 값: | Unlimited, OneDay, ThreeDays, OneWeek, TwoWeeks, OneMonth |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Name
Exchange ActiveSync 전자 메일 프로필의 이름을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-NewName
Exchange ActiveSync 전자 메일 프로필의 새 이름을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-PassThru
작업 중인 항목을 나타내는 개체를 반환하려면 이 매개 변수를 추가합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않을 수 있습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-SigningCertificate
S/MIME 서명에 사용되는 서명 인증서 개체를 지정합니다. 서명 인증서 개체를 가져오려면 Get-CMConfigurationPolicy cmdlet을 사용합니다.
| 형식: | IResultObject |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-SupportedPlatform
전자 메일 프로필을 설치할 운영 체제를 지정합니다. 지원되는 플랫폼 개체를 가져오려면 Get-CMSupportedPlatform cmdlet을 사용합니다.
| 형식: | IResultObject[] |
| 별칭: | SupportedPlatforms |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-SyncContentType
디바이스와 동기화할 콘텐츠 형식을 지정합니다. 유효한 값은 다음과 같습니다.
- 없음
- 전자 메일
- 연락처
- 일정
- 작업
- 참고
- 전체
| 형식: | EasProfileSyncContentType |
| 별칭: | SyncContentTypes |
| 허용되는 값: | None, Email, Contacts, Calendar, Tasks, Notes, All |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-SynchronizeRecentlyUsed
디바이스에서 최근에 사용된 전자 메일 주소 목록이 동기화되었는지 여부를 나타냅니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-SyncSchedule
디바이스가 Exchange Server의 데이터를 동기화할 일정을 지정합니다.
- 수동
- 15분
- 30분
- SixtyMins
- AsArrive
| 형식: | Schedule |
| 허용되는 값: | Manual, FifteenMins, ThirtyMins, SixtyMins, AsArrive |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-UseSsl
전자 메일을 보내고, 이메일을 받고, Exchange Server와 통신할 때 SSL(Secure Sockets Layer) 통신이 사용되는지 여부를 나타냅니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.
| 형식: | SwitchParameter |
| 별칭: | wi |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
입력
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
출력
System.Object