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