次の方法で共有

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:\>)。 詳細については、「作業の 開始」を参照してください。

例

例 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
Type:String
Accepted values:domain, ntdomain
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AccountDomainCustom

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

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

-AccountName

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

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

-AccountUserNameType

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

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

-AllowMessageMove

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

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

-AllowThirdPartyApplication

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

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

-Confirm

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

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

-Description

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

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

-DisableWildcardHandling

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

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

-EmailAddressType

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

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

-EnableSmime

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

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

-ForceWildcardHandling

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

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

-Id

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

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

-IdentityCertificate

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

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

-InputObject

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

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

-Name

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

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

-NewName

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

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

-PassThru

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

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

-SigningCertificate

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

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

-SupportedPlatform

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

Type:IResultObject[]
Aliases:SupportedPlatforms
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SyncContentType

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

  • None
  • メール
  • 連絡先
  • 予定表
  • タスク
  • 注意事項
  • すべて
Type:EasProfileSyncContentType
Aliases:SyncContentTypes
Accepted values:None, Email, Contacts, Calendar, Tasks, Notes, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SynchronizeRecentlyUsed

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

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

-SyncSchedule

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

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

-UseSsl

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

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

-WhatIf

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

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object