New-CMEmailProfile
创建电子邮件配置文件。
语法
New-CMEmailProfile
[-AccountDomainActiveDirectory <String>]
[-AccountDomainCustom <String>]
-AccountName <String>
[-AccountUserNameType <String>]
[-AllowMessageMove]
[-AllowThirdPartyApplication]
[-Description <String>]
[-DoNotUseSsl]
[-EmailAddressType <String>]
[-EnableSmime]
-ExchangeHost <String>
[-IdentityCertificate <IResultObject>]
[-MailSyncDays <MailNumberofDaysToSync>]
-Name <String>
[-SigningCertificate <IResultObject>]
-SupportedPlatform <IResultObject[]>
[-SyncContentType <EasProfileSyncContentType>]
[-SynchronizeRecentlyUsed]
[-SyncSchedule <Schedule>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
New-CMEmailProfile cmdlet 创建 Exchange ActiveSync 电子邮件配置文件。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\>
。 有关详细信息,请参阅 入门。
示例
示例 1:创建电子邮件配置文件
PS XYZ:\> $Platform = Get-CMSupportedPlatform -Fast -Platform "Windows Phone"
PS XYZ:\> New-CMEmailProfile -AccountName "TestAccount1" -ExchangeHost "TestHost1" -Name "EmailProfile01" -SupportedPlatform $Platform[1] -AccountUserNameType sAMAccountName -AccountDomainActiveDirectory domain
第一个命令获取Windows Phone支持的所有平台对象,并将对象存储在 $Platform 变量中。
第二个命令使用来自 $Platform 的第二个受支持的平台对象创建名为 EmailProfile01 的电子邮件。
参数
-AccountDomainActiveDirectory
指定 Active Directory 帐户域的类型。 有效值包含:
- domain
- 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 |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-AccountUserNameType
指定帐户用户名类型。 有效值包含:
- sAMAccountName
- userPrincipalName
类型: | String |
接受的值: | mail, sAMAccountName, userPrincipalName |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-AllowMessageMove
指示允许用户在其设备上配置的不同帐户之间移动电子邮件。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-AllowThirdPartyApplication
指示允许用户从某些非默认的第三方电子邮件应用程序发送电子邮件。
类型: | SwitchParameter |
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 |
-DoNotUseSsl
指示在发送电子邮件、接收电子邮件和与 Exchange Server 通信时不使用安全套接字层 (SSL) 通信。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-EmailAddressType
指定电子邮件地址类型。 有效值包含:
- userPrincipalName
类型: | String |
接受的值: | mail, userPrincipalName |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-EnableSmime
指示使用 S/MIME 加密发送传出电子邮件。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ExchangeHost
指定托管 Exchange ActiveSync 服务的 Exchange 服务器的主机名。
类型: | String |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-ForceWildcardHandling
此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-IdentityCertificate
指定标识证书对象。 若要获取标识证书对象,请使用 Get-CMConfigurationPolicy cmdlet。
类型: | IResultObject |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | 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 |
-SigningCertificate
指定用于 S/MIME 签名的签名证书对象。 若要获取签名证书对象,请使用 Get-CMConfigurationPolicy cmdlet。
类型: | IResultObject |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-SupportedPlatform
指定要安装电子邮件配置文件的操作系统。 若要获取受支持的平台对象,请使用 Get-CMSupportedPlatform cmdlet。
类型: | IResultObject[] |
别名: | SupportedPlatforms |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-SyncContentType
指定要同步到设备的内容类型。 有效值包含:
- None
- 电子邮件
- 联系人
- 日历
- 任务
- 注释
- 全部
类型: | EasProfileSyncContentType |
别名: | SyncContentTypes |
接受的值: | None, Email, Contacts, Calendar, Tasks, Notes, All |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-SynchronizeRecentlyUsed
指示最近在设备上使用的电子邮件地址列表已同步。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-SyncSchedule
指定设备同步 Exchange Server 中的数据的计划。
- 手动
- FifteenMins
- ThirtyMins
- SixtyMins
- AsArrive
类型: | Schedule |
接受的值: | Manual, FifteenMins, ThirtyMins, SixtyMins, AsArrive |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
类型: | SwitchParameter |
别名: | wi |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
输入
None
输出
IResultObject