New-MessageClassification
このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。
組織内にメッセージ分類インスタンスを作成するには、New-MessageClassification コマンドレットを使用します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
New-MessageClassification
[-Name] <String>
-DisplayName <String>
-Locale <CultureInfo>
-SenderDescription <String>
[-Confirm]
[-DomainController <Fqdn>]
[-RecipientDescription <String>]
[-WhatIf]
[<CommonParameters>] New-MessageClassification
[-Name] <String>
-DisplayName <String>
-SenderDescription <String>
[-ClassificationID <Guid>]
[-Confirm]
[-DisplayPrecedence <ClassificationDisplayPrecedenceLevel>]
[-DomainController <Fqdn>]
[-PermissionMenuVisible <Boolean>]
[-RecipientDescription <String>]
[-RetainClassificationEnabled <Boolean>]
[-WhatIf]
[<CommonParameters>] 説明
新しいメッセージ分類を作成した後、メッセージ分類をトランスポート ルールの述語として指定できます。 Microsoft Outlook および Outlook on the web のユーザーがメッセージ分類をメッセージに適用できるように、Export-OutlookClassification.ps1 スクリプト ファイルによって作成されたメッセージ分類 XML ファイルを使用して、エンドユーザー システムを更新する必要があります。 Export-OutlookClassification.ps1 スクリプト ファイルは %ExchangeInstallPath%Scripts ディレクトリにあります。
メッセージ分類を作成した時点では、メッセージ分類にロケールは設定されていません。 既定では、新しいメッセージ分類はすべてのロケールに使用されます。 既定のメッセージ分類を定義した後、New-MessageClassification コマンドレットを実行し、ローカライズする既定のメッセージ分類 ID を指定することによって、定義した分類の新しいロケールを追加できます。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
New-MessageClassification -Name "My Message Classification" -DisplayName "New Message Classification" -SenderDescription "This is the description text"この例では、次のプロパティを使用して、メッセージ分類 My MessageClassification を作成します。
- 表示名は New Message Classification です。
- 送信者説明は "This is the description text" です。
例 2
New-MessageClassification -Name "My Message Classification" -Locale es-ES -DisplayName "España Example" -SenderDescription "Este es el texto de la descripción"オンプレミスの Exchange のこの例では、MyMessageClassification という名前の既存のメッセージ分類のロケール固有 (スペイン語 - スペイン) バージョンを作成します。
パラメーター
-ClassificationID
ClassificationID パラメーターには、インポートして Exchange 組織で使用する既存のメッセージ分類の分類 ID (GUID) を指定します。 このパラメーターは、同じ組織内の 2 つの Exchange フォレストにまたがるメッセージ分類を構成する場合に使用します。
メッセージ分類の ClassificationID 値を見つけるには、 をメッセージ分類の名前に置き換え<MessageClassificationName>、次のコマンドを実行します。 Get-MessageClassification -Identity "<MessageClassificationName>"
| Type: | Guid |
| 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, Exchange Online |
-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, Exchange Online |
-DisplayName
DisplayName パラメーターには、Outlook に表示されるユーザーが選択したメッセージ分類のタイトルを指定します。 最大の長さは 256 文字です。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
表示名が表示されるためには、送信者のコンピューターにメッセージ分類 XML ファイルが必要です。
| 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, Exchange Online |
-DisplayPrecedence
DisplayPrecedence パラメーターには、特定のメッセージに適用できる他のメッセージ分類に対する、このメッセージ分類の相対的な優先度を指定します。 有効な値は次のとおりです。
- Highest
- Higher
- High
- MediumHigh
- Medium (これが既定値です)
- MediumLow
- Low
- Lower
- Lowest
Outlook ではユーザーは 1 つのメッセージに単一の分類しか指定できませんが、トランスポート ルールは他の分類をメッセージに適用する場合があります。 最初に最も優先度の高い分類が表示され、以下、後続の分類、つまりこのパラメーターの定義で相対的に優先度の低い分類が、適切な順序で追加されます。
| Type: | ClassificationDisplayPrecedenceLevel |
| 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, Exchange Online |
-DomainController
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
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 |
-Locale
このパラメーターは、オンプレミスの Exchange で機能します。
Locale パラメーターには、既存のメッセージ分類のロケール固有バージョンを指定します。 -Name パラメーターを使用して既存のメッセージの分類を特定し、SenderDescription パラメーターを使用して、別の言語の説明テキストを指定します。
このパラメーターの正しい値は、Microsoft .NET Framework CultureInfo クラスでサポートされているカルチャ コード値です (例: デンマーク語には da-DK、日本語には ja-JP)。 詳細については、「CultureInfo クラス」を参照してください。
| 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, Exchange Online |
-Name
Name パラメーターには、メッセージ分類に付ける一意の名前を指定します。 最大の長さは 64 文字です。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
| Type: | String |
| Position: | 1 |
| 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, Exchange Online |
-PermissionMenuVisible
PermissionMenuVisible パラメーターは、DisplayName および RecipientDescription パラメーターに入力した値を、ユーザーがメッセージを作成する際に Outlook に表示するかどうかを指定します。 有効な値は次のとおりです。
- $true: ユーザーは送信前にメッセージ分類をメッセージに割り当てることができ、その分類情報が表示されます。 これが既定値です。
- $false: ユーザーは送信前にこのメッセージ分類をメッセージに割り当てることができません。ただし、このメッセージ分類で受信したメッセージには引き続き分類情報が表示されます。
| Type: | Boolean |
| 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, Exchange Online |
-RecipientDescription
RecipientDescription パラメーターは、メッセージ分類が適用されたメッセージを受信したときに Outlook 受信者に表示される詳細なテキストを指定します。 最大の長さは 1024 文字です。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
このパラメーターを使用しなかった場合は、SenderDescription パラメーターの値が使用されます。
| Type: | String |
| 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, Exchange Online |
-RetainClassificationEnabled
RetainClassificationEnabled パラメーターは、メッセージを転送または返信する場合にメッセージ分類をメッセージと共に保持するかどうかを指定します。
既定値は $true です。
| Type: | Boolean |
| 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, Exchange Online |
-SenderDescription
SenderDescription パラメーターは、メッセージを送信する前にメッセージに適用するメッセージ分類を選択したときに Outlook の送信者に表示される詳細なテキストを指定します。 最大の長さは 1024 文字です。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
| 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, Exchange Online |
-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, Exchange Online |
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。