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

説明

Set-CMEmailProfile コマンドレットは、Exchange ActiveSync メール プロファイルの設定を更新します。

注:

PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。

例

例 1: プロファイルを名前で更新する

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

このコマンドは、Exchange ActiveSync 電子メール プロファイルの名前を EmailProfile1 から newEmailProfile1 に更新します。

例 2: ID でプロファイルを更新する

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

このコマンドは、Exchange ActiveSync 電子メール プロファイルの名前を 16795654 の ID で newEmailProfile2 に更新します。

例 3: 入力オブジェクトとしてプロファイルを更新する

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

最初のコマンドは、EmailProfile3 という名前の Exchange ActiveSync 電子メール プロファイル オブジェクトを取得し、そのオブジェクトを $EmailProfile 変数に格納します。

2 番目のコマンドは、$EmailProfileに格納されている電子メール プロファイルの名前を newEmailProfile3 に変更します。

例 4: パイプラインを使用してプロファイルを更新する

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

このコマンドは、EmailProfile4 という名前の Exchange ActiveSync 電子メール プロファイル オブジェクトを取得し、パイプライン演算子を使用してオブジェクトを Set-CMEmailProfile に渡します。これにより、電子メール プロファイル オブジェクトの名前が newEmailProfile4 に変更されます。

パラメーター

-AccountDomainActiveDirectory

Active Directory アカウント ドメインの種類を指定します。 有効な値は次のとおりです。

• domain
• ntdomain

型:	String
指定可能な値:	domain, ntdomain
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AccountDomainCustom

カスタム アカウント ドメインを指定します。 このパラメーターは、 AccountUserNameType パラメーターに sAMAccountName 値が指定されている場合にのみ使用できます。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AccountName

メール アカウントの表示名を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AccountUserNameType

アカウント ユーザー名の種類を指定します。 有効な値は次のとおりです。

• mail
• sAMAccountName
• userPrincipalName

型:	String
指定可能な値:	mail, sAMAccountName, userPrincipalName
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AllowMessageMove

ユーザーが自分のデバイスで構成した別のアカウント間で電子メール メッセージを移動できるかどうかを示します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AllowThirdPartyApplication

既定以外の特定のサード パーティのメール アプリケーションからユーザーがメールを送信できるかどうかを示します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Description

Exchange ActiveSync 電子メール プロファイルの説明を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EmailAddressType

メール アドレスの種類を指定します。 有効な値は次のとおりです。

• mail
• userPrincipalName

型:	String
指定可能な値:	mail, userPrincipalName
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EnableSmime

送信メールが S/MIME 暗号化を使用して送信されるかどうかを示します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Id

Exchange ActiveSync 電子メール プロファイルのCI_IDを指定します。

型:	Int32
Aliases:	CI_ID, CIId
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-IdentityCertificate

ID 証明書オブジェクトを指定します。 ID 証明書オブジェクトを取得するには、Get-CMConfigurationPolicy コマンドレットを使用します。

型:	IResultObject
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-InputObject

Exchange ActiveSync 電子メール プロファイル オブジェクトを指定します。 電子メール プロファイル オブジェクトを取得するには、Get-CMEmailProfile 関数を使用します。

型:	IResultObject
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-MailSyncDays

同期するメールの日数を指定します。 有効な値は次のとおりです。

• 無制限
• OneDay
• ThreeDays
• OneWeek
• TwoWeeks
• OneMonth

型:	MailNumberofDaysToSync
指定可能な値:	Unlimited, OneDay, ThreeDays, OneWeek, TwoWeeks, OneMonth
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Name

Exchange ActiveSync 電子メール プロファイルの名前を指定します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-NewName

Exchange ActiveSync 電子メール プロファイルの新しい名前を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PassThru

このパラメーターを追加して、作業中のアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SigningCertificate

S/MIME 署名に使用される署名証明書オブジェクトを指定します。 署名証明書オブジェクトを取得するには、Get-CMConfigurationPolicy コマンドレットを使用します。

型:	IResultObject
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SupportedPlatform

電子メール プロファイルをインストールするオペレーティング システムを指定します。 サポートされているプラットフォーム オブジェクトを取得するには、Get-CMSupportedPlatform コマンドレットを使用します。

型:	IResultObject[]
Aliases:	SupportedPlatforms
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SyncContentType

デバイスに同期するコンテンツ タイプを指定します。 有効な値は次のとおりです。

• なし
• 電子メール
• 連絡先
• 予定表
• タスク
• メモ
• すべて

型:	EasProfileSyncContentType
Aliases:	SyncContentTypes
指定可能な値:	None, Email, Contacts, Calendar, Tasks, Notes, All
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SynchronizeRecentlyUsed

デバイスで最近使用されたメール アドレスの一覧が同期されているかどうかを示します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SyncSchedule

デバイスが Exchange Server からデータを同期するスケジュールを指定します。

• Manual
• FifteenMins
• ThreeMins
• SixtyMins
• AsArrive

型:	Schedule
指定可能な値:	Manual, FifteenMins, ThirtyMins, SixtyMins, AsArrive
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UseSsl

メールの送信、電子メールの受信、Exchange Server との通信に Secure Sockets Layer (SSL) 通信を使用するかどうかを示します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object

関連リンク

• Get-CMConfigurationPolicy
• Get-CMEmailProfile
• Get-CMSupportedPlatform
• New-CMEmailProfile