New-SystemMessage
このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。
New-SystemMessage コマンドレットを使用して、カスタム システム メッセージを作成します。 システム メッセージは、配信状態通知 (DSN、配信不能レポート、NDR、バウンス メッセージとも呼ばれる) およびクォータ メッセージです。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Dsn
New-SystemMessage
-DsnCode <EnhancedStatusCode>
-Internal <Boolean>
-Language <CultureInfo>
-Text <String>
[-Confirm]
[-DomainController <Fqdn>]
[-WhatIf]
[<CommonParameters>]
Quota
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
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットに与える影響は、コマンドレットが続行する前に確認を必要とするかどうかによって異なります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値を指定せずに Confirm スイッチを指定すると、一時停止が発生し、続行する前にコマンドの確認を強制されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | Cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DomainController
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
DomainController パラメーターは、エッジ トランスポート サーバーではサポートされません。 エッジ トランスポート サーバーは、Active Directory ライトウェイト ディレクトリ サービス (AD LDS) のローカル インスタンスを使用してデータの読み書きを行います。
パラメーターのプロパティ
| 型: | Fqdn |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DsnCode
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
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 パラメーターと併用できません。
パラメーターのプロパティ
| 型: | EnhancedStatusCode |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Dsn
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Internal
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Internal パラメーターは、システム メッセージを内部または外部ユーザーに表示するかどうかを指定します。 有効な値は次のとおりです。
- $true: 内部送信者に対して NDR が表示されます。
- $false: NDR が外部送信者に表示されます。
このパラメーターは DsnCode および Language パラメーターと併用する必要があります。
このパラメーターは QuotaMessageType パラメーターと併用できません。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Dsn
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Language
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Language パラメーターは、メッセージの言語を指定します (たとえば、英語の場合は en、日本語の場合は ja)。 サポートされている言語コードの一覧については、「 NDR でサポートされている言語」を参照してください。
このパラメーターは DsnCode または QuotaMessageType パラメーターと併用する必要があります。
パラメーターのプロパティ
| 型: | CultureInfo |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-QuotaMessageType
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
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: FolderHierarchyChildrenCountReceiveQuota 制限が構成されている場合、メールボックスが FolderHierarchyChildrenCountWarningQuota 制限を超えています。
- WarningFolderHierarchyChildrenCount: FolderHierarchyChildrenCountReceiveQuota 制限が構成されている場合にメールボックスが FolderHierarchyChildrenCountWarningQuota 制限を超える。
- ProhibitReceiveFoldersCount: メールボックスが FoldersCountReceiveQuota 制限を超えています。
- WarningFoldersCount: FoldersCountReceiveQuota 制限が構成されている場合、メールボックスは FoldersCountWarningQuota 制限を超えています。
- WarningFoldersCountUnlimited FoldersCountReceiveQuota 制限が構成されていない場合、メールボックスが FoldersCountWarningQuota 制限を超えています。
WarningFoldersCountUnlimited: FoldersCountReceiveQuota 制限が構成されていない場合にメールボックスが FoldersCountWarningQuota 制限を超える。
- メールボックス フォルダーのレベル数 (深さ) の最大値:
- WarningFolderHierarchyDepth: FolderHierarchyDepthReceiveQuota 制限が構成されている場合、メールボックスは FolderHierarchyDepthWarningQuota 制限を超えています。
- WarningFolderHierarchyDepth: FolderHierarchyDepthReceiveQuota 制限が構成されている場合にメールボックスが FolderHierarchyDepthWarningQuota 制限を超える。
このパラメーターは Language パラメーターと併用する必要があります。
このパラメーターは DsnCode または Internal パラメーターと併用できません。
パラメーターのプロパティ
| 型: | QuotaMessageType |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Quota
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Text
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Text パラメーターは、カスタム システム メッセージのテキストを指定します。 テキストでは、システム メッセージが送信された理由、およびユーザーが実行する必要のある任意のアクションについて説明します。
このパラメーターは DsnCode または QuotaMessageType パラメーターと併用する必要があります。
このパラメーターには、テキストと HTML タグを含めることができます。 最大の長さは 512 文字です (すべてのテキスト タグと HTML タグを含む)。
次の HTML タグを利用できます。
-
<B>および</B>(太字) -
<EM></EM>(斜体) -
<BR>(改行) -
<P>および</P>(段落) -
<A HREF="url">と</A>(ハイパーリンク) を選びます。 注:このタグを使用する場合は、単一引用符 (二重引用符ではない) で完全なテキスト文字列を囲む必要があります。 それ以外の場合は、エラーが発生します (タグに二重引用符が付き込んでいるため)。
これらの特殊文字には、次のエスケープ コードを使用します。
-
<期間 < -
>期間 > -
"for " -
&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 "InfoSec" for more information.'
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
[WhatIf] スイッチは、何も変更を加えずにコマンドが実行する内容を表示します。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | wi |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。