Set-CMEmailProfile

參考

模組:: ConfigurationManager

設定電子郵件設置檔。

語法

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：依標識碼更新配置檔

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

此命令會將標識碼為 16795654的 Exchange ActiveSync 電子郵件設置檔名稱更新為 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
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AccountDomainCustom

指定自訂帳戶網域。只有在為 AccountUserNameType 參數指定 sAMAccountName 值時，才能使用此參數。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AccountName

指定電子郵件帳戶的顯示名稱。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AccountUserNameType

指定帳戶用戶名稱類型。有效值為：

mail
sAMAccountName
userPrincipalName

類型:	String
接受的值:	mail, sAMAccountName, userPrincipalName
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AllowMessageMove

指出是否允許使用者在其裝置上設定的不同帳戶之間移動電子郵件訊息。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AllowThirdPartyApplication

指出是否允許使用者從某些非預設的第三方電子郵件應用程式傳送電子郵件。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

執行 Cmdlet 之前提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Description

指定 Exchange ActiveSync 電子郵件設置檔的描述。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DisableWildcardHandling

此參數會將通配符視為常值字元值。您無法將其與 ForceWildcardHandling 結合。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EmailAddressType

指定電子郵件地址類型。有效值為：

mail
userPrincipalName

類型:	String
接受的值:	mail, userPrincipalName
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnableSmime

指出是否使用 S/MIME 加密傳送外寄電子郵件。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ForceWildcardHandling

此參數會處理通配符，並可能導致非預期的行為 (不建議) 。您無法將其與 DisableWildcardHandling 結合。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Id

指定 Exchange ActiveSync 電子郵件設置檔的CI_ID。

類型:	Int32
別名:	CI_ID, CIId
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-IdentityCertificate

指定身分識別憑證物件。若要取得身分識別憑證物件，請使用 Get-CMConfigurationPolicy Cmdlet。

類型:	IResultObject
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-InputObject

指定 Exchange ActiveSync 電子郵件設置檔物件。若要取得電子郵件設置檔物件，請使用 Get-CMEmailProfile 函式。

類型:	IResultObject
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-MailSyncDays

指定要同步處理的電子郵件天數。有效值為：

無限制
OneDay
ThreeDays
OneWeek
TwoWeeks
OneMonth

類型:	MailNumberofDaysToSync
接受的值:	Unlimited, OneDay, ThreeDays, OneWeek, TwoWeeks, OneMonth
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Name

指定 Exchange ActiveSync 電子郵件設置檔的名稱。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-NewName

指定 Exchange ActiveSync 電子郵件設置檔的新名稱。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PassThru

新增此參數以傳回物件，代表您正在使用的專案。根據預設，此 Cmdlet 可能不會產生任何輸出。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SigningCertificate

指定用於 S/MIME 簽署的簽署憑證物件。若要取得簽署憑證物件，請使用 Get-CMConfigurationPolicy Cmdlet。

類型:	IResultObject
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SupportedPlatform

指定要安裝電子郵件設定檔的作業系統。若要取得支持的平台物件，請使用 Get-CMSupportedPlatform Cmdlet。

類型:	IResultObject[]
別名:	SupportedPlatforms
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SyncContentType

指定要同步處理至裝置的內容類型。有效值為：

無
電子郵件
連絡人
行事曆
工作
附註
全部

類型:	EasProfileSyncContentType
別名:	SyncContentTypes
接受的值:	None, Email, Contacts, Calendar, Tasks, Notes, All
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SynchronizeRecentlyUsed

指出是否同步處理裝置上最近使用的電子郵件地址清單。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SyncSchedule

指定裝置從 Exchange Server 同步處理數據的排程。

手動
十五分鐘
30Mins
六月明
AsArrive

類型:	Schedule
接受的值:	Manual, FifteenMins, ThirtyMins, SixtyMins, AsArrive
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UseSsl

指出在傳送電子郵件、接收電子郵件，以及與 Exchange Server 通訊時，是否使用安全套接字層 (SSL) 通訊。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

System.Object

共用方式為

Set-CMEmailProfile

語法

Description

範例

範例 1：依名稱更新配置檔

範例 2：依標識碼更新配置檔

範例 3：將設定檔更新為輸入物件

範例 4：使用管線更新配置檔

參數

-AccountDomainActiveDirectory

-AccountDomainCustom

-AccountName

-AccountUserNameType

-AllowMessageMove

-AllowThirdPartyApplication

-Confirm

-Description

-DisableWildcardHandling

-EmailAddressType

-EnableSmime

-ForceWildcardHandling

-Id

-IdentityCertificate

-InputObject

-MailSyncDays

-Name

-NewName

-PassThru

-SigningCertificate

-SupportedPlatform

-SyncContentType

-SynchronizeRecentlyUsed

-SyncSchedule

-UseSsl

-WhatIf

輸入

輸出

意見反應

其他資源

共用方式為

Set-CMEmailProfile

語法

Description

範例

範例 1：依名稱更新配置檔

範例 2：依標識碼更新配置檔

範例 3：將設定檔更新為輸入物件

範例 4：使用管線更新配置檔

參數

-AccountDomainActiveDirectory

-AccountDomainCustom

-AccountName

-AccountUserNameType

-AllowMessageMove

-AllowThirdPartyApplication

-Confirm

-Description

-DisableWildcardHandling

-EmailAddressType

-EnableSmime

-ForceWildcardHandling

-Id

-IdentityCertificate

-InputObject

-MailSyncDays

-Name

-NewName

-PassThru

-SigningCertificate

-SupportedPlatform

-SyncContentType

-SynchronizeRecentlyUsed

-SyncSchedule

-UseSsl

-WhatIf

輸入

輸出

相關連結

意見反應

其他資源