New-CMEmailProfile

電子メール プロファイルを作成します。

構文

New-CMEmailProfile
   [-AccountDomainActiveDirectory <String>]
   [-AccountDomainCustom <String>]
   -AccountName <String>
   [-AccountUserNameType <String>]
   [-AllowMessageMove]
   [-AllowThirdPartyApplication]
   [-Description <String>]
   [-DoNotUseSsl]
   [-EmailAddressType <String>]
   [-EnableSmime]
   -ExchangeHost <String>
   [-IdentityCertificate <IResultObject>]
   [-MailSyncDays <MailNumberofDaysToSync>]
   -Name <String>
   [-SigningCertificate <IResultObject>]
   -SupportedPlatform <IResultObject[]>
   [-SyncContentType <EasProfileSyncContentType>]
   [-SynchronizeRecentlyUsed]
   [-SyncSchedule <Schedule>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-CMEmailProfile コマンドレットは、Exchange ActiveSync 電子メール プロファイルを作成します。

注:

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

例 1: 電子メール プロファイルを作成する

PS XYZ:\> $Platform = Get-CMSupportedPlatform -Fast -Platform "Windows Phone"
PS XYZ:\> New-CMEmailProfile -AccountName "TestAccount1" -ExchangeHost "TestHost1" -Name "EmailProfile01" -SupportedPlatform $Platform[1] -AccountUserNameType sAMAccountName -AccountDomainActiveDirectory domain

最初のコマンドは、Windows Phoneでサポートされているすべてのプラットフォーム オブジェクトを取得し、オブジェクトを $Platform 変数に格納します。

2 番目のコマンドは、$Platformからサポートされている 2 番目のプラットフォーム オブジェクトを使用して EmailProfile01 という名前の電子メールを作成します。

パラメーター

-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
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-AccountUserNameType

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

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

-AllowMessageMove

ユーザーが自分のデバイスで構成した別のアカウント間で電子メール メッセージを移動することを許可されていることを示します。

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

-AllowThirdPartyApplication

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

型:SwitchParameter
配置: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

-DoNotUseSsl

メールの送信、メールの受信、Exchange Server との通信時に、Secure Sockets Layer (SSL) 通信が使用されないことを示します。

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

-EmailAddressType

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

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

-EnableSmime

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

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

-ExchangeHost

Exchange ActiveSync サービスをホストする Exchange サーバーのホスト名を指定します。

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

-ForceWildcardHandling

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

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

-IdentityCertificate

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

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

-SigningCertificate

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

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

-SupportedPlatform

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

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

-SyncContentType

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

  • なし
  • 電子メール
  • 連絡先
  • 予定表
  • タスク
  • メモ
  • すべて
型:EasProfileSyncContentType
Aliases:SyncContentTypes
指定可能な値:None, Email, Contacts, Calendar, Tasks, Notes, All
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SynchronizeRecentlyUsed

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

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

-SyncSchedule

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

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

-WhatIf

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

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

入力

None

出力

IResultObject