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