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：依識別碼更新設定檔

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

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

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

mail
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

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

mail
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

指定身分識別憑證物件。若要取得身分識別憑證物件，請使用 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同步處理資料的排程。

手動
十五分鐘
30Mins
六月明
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) 通訊。

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

Set-CMEmailProfile

Syntax

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

Syntax

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

輸入

輸出

相關連結

意見反應

其他資源