New-SystemMessage

  • リファレンス
モジュール:
ExchangePowerShell
適用対象:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。

New-SystemMessage コマンドレットを使用して、カスタム システム メッセージを作成します。 システム メッセージは、配信状態通知 (DSN、配信不能レポート、NDR、バウンス メッセージとも呼ばれる) およびクォータ メッセージです。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

New-SystemMessage
   -DsnCode <EnhancedStatusCode>
   -Internal <Boolean>
   -Language <CultureInfo>
   -Text <String>
   [-Confirm]
   [-DomainController <Fqdn>]
   [-WhatIf]
   [<CommonParameters>]
New-SystemMessage
   -Language <CultureInfo>
   -QuotaMessageType <QuotaMessageType>
   -Text <String>
   [-Confirm]
   [-DomainController <Fqdn>]
   [-WhatIf]
   [<CommonParameters>]

説明

NDR は、メール メッセージに指定された受信者にメールが届かなかった場合、送信者に対して表示されます。 クォータ メッセージは、メールボックスまたはパブリック フォルダーが特定の警告、送信禁止、受信禁止に関するクォータに達した場合、そのユーザーに対して表示されます。 カスタム NDR とクォータ メッセージは、Exchange に含まれる既定のメッセージに置き換えられます。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例

例 1

New-SystemMessage -DsnCode 5.3.5 -Language en -Internal $false -Text "The recipient email system can't process this email message. Please contact your system administrator for more information."

この例では、外部送信者向けに拡張状態コード 5.3.5 の英語のカスタム NDR を作成します。

例 2

New-SystemMessage -QuotaMessageType WarningMailbox -Language en -Text "Your mailbox has exceeded the warning limit specified by your email administrator. Please reduce the size of your mailbox."

この例では、警告表示クォータを超過しているメールボックスについて英語のカスタム クォータ メッセージを作成します。

パラメーター

-Confirm

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

  • 破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
  • 他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。

DomainController パラメーターは、エッジ トランスポート サーバーではサポートされません。 エッジ トランスポート サーバーは、Active Directory ライトウェイト ディレクトリ サービス (AD LDS) のローカル インスタンスを使用してデータの読み書きを行います。

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DsnCode

DsnCode パラメーターは、カスタム システム メッセージの拡張状態コードを指定します。

有効な値は 4.x.y または 5.x.y です。x と y は 1 から 3 桁の数字です。 Exchange に含まれる既定のコードを指定することも、カスタム コードを指定することもできます。

Exchange で使用される既定の拡張状態コードの一覧を生成するには、次のコマンドを実行します。 Get-SystemMessage -Original | Select-Object -Property Identity,DsnCode,Language,Text | ConvertTo-Html | Set-Content -Path "C:\My Documents\Default DSNs.html"

このパラメーターは Language および Internal パラメーターと併用する必要があります。

このパラメーターは QuotaMessageType パラメーターと併用できません。

Type:EnhancedStatusCode
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Internal

Internal パラメーターは、システム メッセージを内部または外部ユーザーに表示するかどうかを指定します。 有効な値は次のとおりです。

  • $true: NDR は内部センダに表示されます。
  • $false: NDR は外部送信者に表示されます。

このパラメーターは DsnCode および Language パラメーターと併用する必要があります。

このパラメーターは QuotaMessageType パラメーターと併用できません。

Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Language

Language パラメーターは、メッセージの言語 (英語の場合は en、日本語の場合は ja など) を指定します。 サポートされている言語コードの一覧については、「 NDR でサポートされている言語」を参照してください。

このパラメーターは DsnCode または QuotaMessageType パラメーターと併用する必要があります。

Type:CultureInfo
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-QuotaMessageType

QuotaMessageType パラメーターは、カスタム システム メッセージのクォータを指定します。 有効な値は次のとおりです。

複数の条件を指定するには、and 比較演算子を使用します。1 つの整数で表されないプロパティ値は、二重引用符 (") で囲む必要があります。

  • ProhibitSendReceiveMailbox: メールボックスが ProhibitSendReceiveQuota の制限を超えています。
  • ProhibitSendReceiveMailBox:メールボックスが ProhibitSendReceiveQuota の制限を超える。
  • WarningMailbox: メールボックスが、ProhibitSendQuota または ProhibitSendReceiveQuota の制限が構成されている場合に、その IssueWarningQuota 制限を超えています。
  • WarningMailbox: ProhibitSendQuota または ProhibitSendReceiveQuota の制限が構成されている場合にメールボックスが IssueWarningQuota 制限を超える。

WarningMailboxUnlimitedSize: ProhibitSendQuota または ProhibitSendReceiveQuota の制限が構成されていない場合にメールボックスが IssueWarningQuota 制限を超える。

  • パブリック フォルダーのサイズ クォータ:
  • WarningPublicFolder: パブリック フォルダーが、ProhibitPostQuota 制限が構成されている場合、その IssueWarningQuota 制限を超えています。
  • WarningPublicFolder: ProhibitPostQuota 制限が構成されている場合にパブリック フォルダーが IssueWarningQuota 制限を超える。

WarningPublicFolderUnlimitedSize: ProhibitPostQuota 制限が構成されていない場合にパブリック フォルダーが IssueWarningQuota 制限を超える。

  • メールボックス フォルダーの最大メッセージ数:
  • WarningMailboxMessagesPerFolderCount: メールボックスが MailboxMessagesPerFolderCountReceiveQuota の制限が構成されている場合、メールボックスがその MailboxMessagesPerFolderCountWarningQuota 制限を超えています。
  • WarningMailboxMessagesPerFolderCount: MailboxMessagesPerFolderCountReceiveQuota 制限が構成されている場合にメールボックスが MailboxMessagesPerFolderCountWarningQuota 制限を超える。

WarningMailboxMessagesPerFolderUnlimitedCount: MailboxMessagesPerFolderCountReceiveQuota 制限が構成されていない場合にメールボックスが MailboxMessagesPerFolderCountWarningQuota 制限を超える。

  • メールボックス フォルダーのサブフォルダー数の最大値:
  • WarningFolderHierarchyChildrenCount: メールボックスが FolderHierarchyChildrenCountWarningQuota の制限を超えているのは、FolderHierarchyChildrenCountReceiveQuota の制限が構成されている場合です。
  • WarningFolderHierarchyChildrenCount: FolderHierarchyChildrenCountReceiveQuota 制限が構成されている場合にメールボックスが FolderHierarchyChildrenCountWarningQuota 制限を超える。
  • ProhibitReceiveFoldersCount: メールボックスが FoldersCountReceiveQuota の制限を超えています。
  • WarningFoldersCount: FoldersCountReceiveQuota の制限が構成されている場合、メールボックスがその FoldersCountWarningQuota 制限を超えています。
  • WarningFoldersCountUnlimited FoldersCountReceiveQuota の制限が構成されていない場合、メールボックスがその FoldersCountWarningQuota 制限を超えています。

WarningFoldersCountUnlimited: FoldersCountReceiveQuota 制限が構成されていない場合にメールボックスが FoldersCountWarningQuota 制限を超える。

  • メールボックス フォルダーのレベル数 (深さ) の最大値:
  • WarningFolderHierarchyDepth: FolderHierarchyDepthWarningQuota 制限が構成されている場合、メールボックスがその FolderHierarchyDepthWarningQuota 制限を超えています。
  • WarningFolderHierarchyDepth: FolderHierarchyDepthReceiveQuota 制限が構成されている場合にメールボックスが FolderHierarchyDepthWarningQuota 制限を超える。

このパラメーターは Language パラメーターと併用する必要があります。

このパラメーターは DsnCode または Internal パラメーターと併用できません。

Type:QuotaMessageType
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Text

Text パラメーターは、カスタム システム メッセージのテキストを指定します。 テキストでは、システム メッセージが送信された理由、およびユーザーが実行する必要のある任意のアクションについて説明します。

このパラメーターは DsnCode または QuotaMessageType パラメーターと併用する必要があります。

このパラメーターには、テキストと HTML タグを含めることができます。 最大長は 512 文字です (すべてのテキストと HTML タグが含まれます)。

次の HTML タグを利用できます。

  • <B> と </B> (太字)
  • <EM> と </EM> (斜体)
  • <BR> (改行)
  • <P> および </P> (段落)
  • <A HREF="url"> と </A> (ハイパーリンク)。 注:このタグを使用する場合は、単一引用符 (二重引用符ではない) で完全なテキスト文字列を囲む必要があります。 そうしないと、タグ内の二重引用符が原因でエラーが発生します。

これらの特殊文字には、次のエスケープ コードを使用します。

  • &lt; for <
  • &gt; for >
  • &quot; for "
  • &amp; for &

HTML タグや特殊文字を使用するこのパラメーターの値の例を以下に示します。

'You tried to send a message to a <B>disabled</B> mailbox. Please visit <A HREF="https://it.contoso.com">Internal Support</A> or contact &quot;InfoSec&quot; for more information.'

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

入力

Input types

このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。

出力

Output types

このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。