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更新します。

注意

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

例

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

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

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

例 2: ID によるプロファイルの更新

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

このコマンドは、メール プロファイルの名前Exchange ActiveSync id を使用して newEmailProfile2 16795654更新します。

例 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

Type:	String
Accepted values:	domain, ntdomain
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AccountDomainCustom

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AccountName

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AccountUserNameType

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

• mail
• sAMAccountName
• userPrincipalName

Type:	String
Accepted values:	mail, sAMAccountName, userPrincipalName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowMessageMove

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowThirdPartyApplication

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-EmailAddressType

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

• mail
• userPrincipalName

Type:	String
Accepted values:	mail, userPrincipalName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableSmime

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

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

Type:	Int32
Aliases:	CI_ID, CIId
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-IdentityCertificate

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

Type:	IResultObject
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

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

Type:	IResultObject
Position:	Named
Default value:	None
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
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-NewName

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SigningCertificate

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

Type:	IResultObject
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SupportedPlatform

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

Type:	IResultObject[]
Aliases:	SupportedPlatforms
Position:	Named
Default value:	None
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
Accept pipeline input:	False
Accept wildcard characters:	False

-SynchronizeRecentlyUsed

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

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SyncSchedule

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

• Manual
• FifteenMins
• ThirtyMins
• SixtyMins
• AsArrive

Type:	Schedule
Accepted values:	Manual, FifteenMins, ThirtyMins, SixtyMins, AsArrive
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UseSsl

電子メールの送信、Secure Sockets Layer受信、および電子メールとの通信を行う際に、SSL (SSL) 通信を使用するかどうかをExchange Server。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object

関連リンク

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