New-EmailAddressPolicy (RTM)
適用先: Exchange Server 2007
トピックの最終更新日: 2007-06-05
新しい電子メール アドレス ポリシーを作成するには、New-EmailAddressPolicy コマンドレットを使用します。
構文
New-EmailAddressPolicy -Name <String> -EnabledPrimarySMTPAddressTemplate <String> -IncludedRecipients <Nullable> [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <String>] [-ConditionalCustomAttribute10 <String>] [-ConditionalCustomAttribute11 <String>] [-ConditionalCustomAttribute12 <String>] [-ConditionalCustomAttribute13 <String>] [-ConditionalCustomAttribute14 <String>] [-ConditionalCustomAttribute15 <String>] [-ConditionalCustomAttribute2 <String>] [-ConditionalCustomAttribute3 <String>] [-ConditionalCustomAttribute4 <String>] [-ConditionalCustomAttribute5 <String>] [-ConditionalCustomAttribute6 <String>] [-ConditionalCustomAttribute7 <String>] [-ConditionalCustomAttribute8 <String>] [-ConditionalCustomAttribute9 <String>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>]
New-EmailAddressPolicy -Name <String> -EnabledPrimarySMTPAddressTemplate <String> -RecipientFilter <String> [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>]
New-EmailAddressPolicy -Name <String> -EnabledEmailAddressTemplates <ProxyAddressTemplateCollection> -RecipientFilter <String> [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>]
New-EmailAddressPolicy -Name <String> -EnabledEmailAddressTemplates <ProxyAddressTemplateCollection> -IncludedRecipients <Nullable> [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <String>] [-ConditionalCustomAttribute10 <String>] [-ConditionalCustomAttribute11 <String>] [-ConditionalCustomAttribute12 <String>] [-ConditionalCustomAttribute13 <String>] [-ConditionalCustomAttribute14 <String>] [-ConditionalCustomAttribute15 <String>] [-ConditionalCustomAttribute2 <String>] [-ConditionalCustomAttribute3 <String>] [-ConditionalCustomAttribute4 <String>] [-ConditionalCustomAttribute5 <String>] [-ConditionalCustomAttribute6 <String>] [-ConditionalCustomAttribute7 <String>] [-ConditionalCustomAttribute8 <String>] [-ConditionalCustomAttribute9 <String>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>]
解説
新しい電子メール アドレス ポリシーを作成し、適用するには、New-EmailAddressPolicy コマンドレットを使用します。新しい電子メール アドレス ポリシーは、Active Directory ディレクトリ サービスの Microsoft Exchange 組織の構成コンテナの下に作成されます。
New-EmailAddressPolicy コマンドレットを実行するには、使用するアカウントに次の権限が委任されている必要があります。
- Exchange 組織管理者の役割
Exchange Server 2007 を管理するために必要なアクセス許可、役割の委任、および権限の詳細については、「アクセス許可に関する考慮事項」を参照してください。
パラメータ
| パラメータ | 必須かどうか | 種類 | 説明 |
|---|---|---|---|
EnabledEmailAddressTemplates |
必須 |
Microsoft.Exchange.Data.ProxyAddressTemplateCollection |
EnabledEmailAddressTemplates パラメータには、電子メール アドレス ポリシーに含まれ、有効になっているプロキシ アドレスを指定します。コンマを使用して複数の値を区切ります。各プロキシ アドレスのドメイン部分は、既存の承認済みドメインと一致している必要があります。 |
EnabledPrimarySMTPAddressTemplate |
必須 |
System.String |
EnabledPrimarySMTPAddressTemplate パラメータには、有効であり、電子メール アドレス ポリシーに含まれているプロキシ アドレスを指定します。各プロキシ アドレスのドメイン部分は、既存の承認済みドメインと一致している必要があります。 |
IncludedRecipients |
必須 |
System.Nullable |
IncludedRecipients パラメータには、電子メール アドレス ポリシーを設定するために使用する受信者をフィルタ処理します。AllRecipients は単体でのみ使用できます。IncludedRecipients パラメータに複数の値をコンマで区切って指定すると、OR ブール演算子が適用されます。 |
Name |
必須 |
System.String |
Name パラメータには、電子メール アドレス ポリシーの名前を指定します。 |
RecipientFilter |
必須 |
System.String |
RecipientFilter パラメータには、電子メール アドレス ポリシーに含める受信者用のフィルタを指定します。次のいずれかのフィルタ パラメータを使用する場合は、このパラメータを使用できません。
フィルタ可能なプロパティの詳細については、「-RecipientFilter パラメータのフィルタ可能なプロパティ」を参照してください。 |
ConditionalCompany |
省略可能 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalCompany パラメータは、会社名によるフィルタです。複数の値を指定するには、値をコンマで区切ります。 |
ConditionalCustomAttribute1 |
省略可能 |
System.String |
ConditionalCustomAttribute1 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalCustomAttribute10 |
省略可能 |
System.String |
ConditionalCustomAttribute10 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalCustomAttribute11 |
省略可能 |
System.String |
ConditionalCustomAttribute11 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalCustomAttribute12 |
省略可能 |
System.String |
ConditionalCustomAttribute12 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalCustomAttribute13 |
省略可能 |
System.String |
ConditionalCustomAttribute13 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalCustomAttribute14 |
省略可能 |
System.String |
ConditionalCustomAttribute14 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalCustomAttribute15 |
省略可能 |
System.String |
ConditionalCustomAttribute15 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalCustomAttribute2 |
省略可能 |
System.String |
ConditionalCustomAttribute2 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalCustomAttribute3 |
省略可能 |
System.String |
ConditionalCustomAttribute3 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalCustomAttribute4 |
省略可能 |
System.String |
ConditionalCustomAttribute4 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalCustomAttribute5 |
省略可能 |
System.String |
ConditionalCustomAttribute5 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalCustomAttribute6 |
省略可能 |
System.String |
ConditionalCustomAttribute6 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalCustomAttribute7 |
省略可能 |
System.String |
ConditionalCustomAttribute7 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalCustomAttribute8 |
省略可能 |
System.String |
ConditionalCustomAttribute8 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalCustomAttribute9 |
省略可能 |
System.String |
ConditionalCustomAttribute9 パラメータには、カスタム属性を指定します。これらの属性を使用して、追加情報を格納できます。 |
ConditionalDepartment |
省略可能 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalDepartment パラメータは、部署名によるフィルタです。複数の値を指定するには、値をコンマで区切ります。 |
ConditionalStateOrProvince |
省略可能 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalStateOrProvince パラメータは、都道府県名によるフィルタです。複数の値を指定するには、値をコンマで区切ります。 |
DisabledEmailAddressTemplates |
省略可能 |
Microsoft.Exchange.Data.ProxyAddressTemplateCollection |
DisabledEmailAddressTemplates パラメータは、電子メール アドレス ポリシーに含まれ、無効になっているプロキシ アドレスを定義します。複数の値を指定するには、値をコンマで区切ります。 |
DomainController |
省略可能 |
Microsoft.Exchange.Data.Fqdn |
この構成の変更を Active Directory に書き込むドメイン コントローラの完全修飾ドメイン名 (FQDN) を指定するには、コマンドに DomainController パラメータを含めます。 |
Priority |
省略可能 |
Microsoft.Exchange.Data.Directory.SystemConfiguration.EmailAddressPolicyPriority |
Priority パラメータに優先度を指定すると、現在の優先度がその優先度より高くなります。 |
TemplateInstance |
省略可能 |
System.Management.Automation.PSObject |
TemplateInstance パラメータに既存のオブジェクトを指定した場合、このコマンドはオブジェクトの構成を使用して、ローカルまたはターゲット サーバーにそのオブジェクトの完全なコピーを作成します。 |
入力の種類
戻り値の種類
エラー
| エラー | 説明 |
|---|---|
例外
| 例外 | 説明 |
|---|---|
例
次のコードは、New-EmailAddressPolicy コマンドの使用例です。
New-EmailAddressPolicy -Name "MyPolicy" -IncludedRecipients MailboxUsers -EnabledPrimarySMTPAddressTemplate SMTP:@contoso.com
参照している情報が最新であることを確認したり、他の Exchange Server 2007 ドキュメントを見つけたりするには、Exchange Server TechCenter を参照してください。