Поделиться через


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>]

Описание

Командлет Set-CMEmailProfile обновляет параметры профиля электронной почты Exchange ActiveSync.

Примечание.

Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

Пример 1. Обновление профиля по имени

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

Эта команда обновляет имя профиля электронной почты Exchange ActiveSync с EmailProfile1 на newEmailProfile1.

Пример 2. Обновление профиля по идентификатору

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

Эта команда обновляет имя профиля электронной почты Exchange ActiveSync с идентификатором 16795654 newEmailProfile2.

Пример 3. Обновление профиля в качестве входного объекта

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

Первая команда получает объект профиля электронной почты Exchange ActiveSync с именем EmailProfile3 и сохраняет объект в переменной $EmailProfile.

Вторая команда изменяет имя профиля электронной почты, хранящегося в $EmailProfile, на newEmailProfile3.

Пример 4. Обновление профиля с помощью конвейера

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

Эта команда получает объект профиля электронной почты Exchange ActiveSync с именем EmailProfile4 и использует оператор конвейера для передачи объекта в Set-CMEmailProfile, который изменяет имя объекта профиля электронной почты на newEmailProfile4.

Параметры

-AccountDomainActiveDirectory

Указывает тип домена учетной записи Active Directory. Допустимые значения:

  • domain
  • ntdomain
Тип:String
Допустимые значения:domain, ntdomain
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AccountDomainCustom

Указывает домен пользовательской учетной записи. Этот параметр можно использовать, только если для параметра AccountUserName указано значение sAMAccountName.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AccountName

Указывает отображаемое имя для учетной записи электронной почты.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AccountUserNameType

Указывает тип имени пользователя учетной записи. Допустимые значения:

  • mail;
  • 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

Перед запуском командлет запросит подтверждение.

Тип:SwitchParameter
Aliases: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

Указывает тип адреса электронной почты. Допустимые значения:

  • mail;
  • 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

Указывает CI_ID для профиля электронной почты Exchange ActiveSync.

Тип:Int32
Aliases:CI_ID, CIId
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-IdentityCertificate

Указывает объект сертификата удостоверения. Чтобы получить объект сертификата удостоверения, используйте командлет Get-CMConfigurationPolicy.

Тип: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
  • Две недели
  • 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

Добавьте этот параметр, чтобы вернуть объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не может создавать выходные данные.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SigningCertificate

Указывает объект сертификата подписи, используемый для подписывания S/MIME. Чтобы получить объект сертификата подписи, используйте командлет Get-CMConfigurationPolicy.

Тип:IResultObject
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SupportedPlatform

Указывает операционные системы, в которых будет установлен профиль электронной почты. Чтобы получить поддерживаемый объект платформы, используйте командлет Get-CMSupportedPlatform.

Тип:IResultObject[]
Aliases:SupportedPlatforms
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SyncContentType

Указывает тип контента для синхронизации с устройствами. Допустимые значения:

  • Нет
  • Электронная почта
  • Контакты
  • Календарь
  • Задачи
  • Примечания
  • Все
Тип:EasProfileSyncContentType
Aliases: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.

  • Вручную
  • Пятнадцатьмин
  • Тридцатимин
  • ШестьдесятMins
  • AsArrive
Тип:Schedule
Допустимые значения:Manual, FifteenMins, ThirtyMins, SixtyMins, AsArrive
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-UseSsl

Указывает, используется ли обмен данными ssl при отправке сообщений электронной почты, получении сообщений электронной почты и взаимодействии с Exchange Server.

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Выходные данные

System.Object