New-EmailAddressPolicy
このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。
電子メール アドレス ポリシーを作成するには、New-EmailAddressPolicy コマンドレットを使用します。 Exchange Onlineでは、メール アドレス ポリシーはMicrosoft 365 グループでのみ使用できます。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
New-EmailAddressPolicy
[-Name] <String>
-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>
-IncludedRecipients <WellKnownRecipientType>
[-ConditionalCompany <MultiValuedProperty>]
[-ConditionalCustomAttribute1 <MultiValuedProperty>]
[-ConditionalCustomAttribute10 <MultiValuedProperty>]
[-ConditionalCustomAttribute11 <MultiValuedProperty>]
[-ConditionalCustomAttribute12 <MultiValuedProperty>]
[-ConditionalCustomAttribute13 <MultiValuedProperty>]
[-ConditionalCustomAttribute14 <MultiValuedProperty>]
[-ConditionalCustomAttribute15 <MultiValuedProperty>]
[-ConditionalCustomAttribute2 <MultiValuedProperty>]
[-ConditionalCustomAttribute3 <MultiValuedProperty>]
[-ConditionalCustomAttribute4 <MultiValuedProperty>]
[-ConditionalCustomAttribute5 <MultiValuedProperty>]
[-ConditionalCustomAttribute6 <MultiValuedProperty>]
[-ConditionalCustomAttribute7 <MultiValuedProperty>]
[-ConditionalCustomAttribute8 <MultiValuedProperty>]
[-ConditionalCustomAttribute9 <MultiValuedProperty>]
[-ConditionalDepartment <MultiValuedProperty>]
[-ConditionalStateOrProvince <MultiValuedProperty>]
[-Confirm]
[-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>] New-EmailAddressPolicy
[-Name] <String>
-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>
-RecipientFilter <String>
[-Confirm]
[-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>] New-EmailAddressPolicy
[-Name] <String>
-EnabledPrimarySMTPAddressTemplate <String>
-IncludedRecipients <WellKnownRecipientType>
[-ConditionalCompany <MultiValuedProperty>]
[-ConditionalCustomAttribute1 <MultiValuedProperty>]
[-ConditionalCustomAttribute10 <MultiValuedProperty>]
[-ConditionalCustomAttribute11 <MultiValuedProperty>]
[-ConditionalCustomAttribute12 <MultiValuedProperty>]
[-ConditionalCustomAttribute13 <MultiValuedProperty>]
[-ConditionalCustomAttribute14 <MultiValuedProperty>]
[-ConditionalCustomAttribute15 <MultiValuedProperty>]
[-ConditionalCustomAttribute2 <MultiValuedProperty>]
[-ConditionalCustomAttribute3 <MultiValuedProperty>]
[-ConditionalCustomAttribute4 <MultiValuedProperty>]
[-ConditionalCustomAttribute5 <MultiValuedProperty>]
[-ConditionalCustomAttribute6 <MultiValuedProperty>]
[-ConditionalCustomAttribute7 <MultiValuedProperty>]
[-ConditionalCustomAttribute8 <MultiValuedProperty>]
[-ConditionalCustomAttribute9 <MultiValuedProperty>]
[-ConditionalDepartment <MultiValuedProperty>]
[-ConditionalStateOrProvince <MultiValuedProperty>]
[-Confirm]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>] New-EmailAddressPolicy
[-Name] <String>
-EnabledPrimarySMTPAddressTemplate <String>
-RecipientFilter <String>
[-Confirm]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>] New-EmailAddressPolicy
[-Name] <String>
-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>
[-IncludeUnifiedGroupRecipients]
[-ManagedByFilter <String>]
[-Confirm]
[-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>] New-EmailAddressPolicy
[-Name] <String>
-EnabledPrimarySMTPAddressTemplate <String>
[-IncludeUnifiedGroupRecipients]
[-ManagedByFilter <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>] 説明
New-EmailAddressPolicy コマンドレットを使用してオンプレミスの Exchange 組織に電子メール アドレス ポリシーを作成した後、Update-EmailAddressPolicy コマンドレットを使用して新しいポリシーを受信者に適用する必要があります。
条件付きパラメーターとともに使用される IncludedRecipients パラメーターには、次の制限が適用されます。
- EQV 演算子は、「部門が営業に等しい」などのように、個々のプロパティ値に対して使用します。 ワイルドカードや部分一致はサポートされていません。
- OR 演算子は、「部門が営業、またはマーケティングに等しい」などのように、常に同じプロパティの複数の値に対して使用します。
- AND 演算子は、「部門が営業に等しい、および会社が Contoso に等しい」などのように、常に複数のプロパティに対して使用します。
使用可能な受信者プロパティを使用し、これらの制限の影響を受けない柔軟なフィルターを作成するには、RecipientFilter パラメーターを使用して OPATH フィルターを作成します。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
New-EmailAddressPolicy -Name "Southeast Offices" -IncludedRecipients MailboxUsers -ConditionalStateorProvince "GA","AL","LA" -EnabledEmailAddressTemplates "SMTP:%s%2g@southeast.contoso.com","smtp:%s%2g@southeast.contoso.net"次の使用例は、事前設定された受信者フィルターを使用するオンプレミスの Exchange 組織に電子メール アドレス ポリシーを作成します。
- 名前: 南東部オフィス
- 事前設定された受信者フィルター: 州または都道府県の値が GA、AL、または LA (ジョージア、アラバマ、またはルイジアナ) であるメールボックスを持つすべてのユーザー。
- プライマリ SMTP メール アドレス:
<last name>.<first two letters of the first name>@contoso.com - その他のプロキシ メール アドレス:
<last name>.<first two letters of the first name>@contoso.net - Priority:N+1。N は、既に存在する手動で作成されたメール アドレス ポリシーの数です (Priority パラメーターは使用せず、既定値は N+1 です)。
例 2
New-EmailAddressPolicy -Name "Northwest Executives" -RecipientFilter "(RecipientType -eq 'UserMailbox') -and (Title -like '*Director*' -or Title -like '*Manager*') -and (StateOrProvince -eq 'WA' -or StateOrProvince -eq 'OR' -or StateOrProvince -eq 'ID')" -EnabledEmailAddressTemplates "SMTP:%2g%s@contoso.com" -Priority 2次の使用例は、カスタム受信者フィルターを使用するオンプレミスの Exchange 組織に電子メール アドレス ポリシーを作成します。
- 名前: ノースウェスト エグゼクティブ
- カスタム受信者フィルター: [タイトル] の値に [ディレクター] または [マネージャー] が含まれており、状態または都道府県の値が WA、OR、または ID (ワシントン、オレゴン、アイダホ) であるメールボックスを持つすべてのユーザー。
- プライマリ SMTP メール アドレス:
<first two letters of the first name><last name>@contoso.com - その他のプロキシ 電子メール アドレス: なし
- 優先度: 2
パラメーター
-ConditionalCompany
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
ConditionalCompany パラメーターは、受信者の Company プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen
このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute1
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
ConditionalCustomAttribute1 パラメーターは、受信者の CustomAttribute1 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen
このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute10
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
ConditionalCustomAttribute10 パラメーターは、受信者の CustomAttribute10 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen
このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute11
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
ConditionalCustomAttribute11 パラメーターは、受信者の CustomAttribute11 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen
このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute12
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
ConditionalCustomAttribute12 パラメーターは、受信者の CustomAttribute12 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen
このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute13
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
ConditionalCustomAttribute13 パラメーターは、受信者の CustomAttribute13 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen
このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute14
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
ConditionalCustomAttribute14 パラメーターは、受信者の CustomAttribute14 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen
このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute15
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
ConditionalCustomAttribute15 パラメーターは、受信者の CustomAttribute15 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen
このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute2
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
ConditionalCustomAttribute2 パラメーターは、受信者の CustomAttribute2 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen
このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute3
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
ConditionalCustomAttribute3 パラメーターは、受信者の CustomAttribute3 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen
このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute4
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
ConditionalCustomAttribute4 パラメーターは、受信者の CustomAttribute4 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen
このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute5
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
ConditionalCustomAttribute5 パラメーターは、受信者の CustomAttribute5 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen
このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute6
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
ConditionalCustomAttribute6 パラメーターは、受信者の CustomAttribute6 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen
このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute7
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
ConditionalCustomAttribute7 パラメーターは、受信者の CustomAttribute7 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen
このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute8
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
ConditionalCustomAttribute8 パラメーターは、受信者の CustomAttribute8 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen
このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute9
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
ConditionalCustomAttribute9 パラメーターは、受信者の CustomAttribute9 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen
このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalDepartment
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
ConditionalDepartment パラメーターは、受信者の Department プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen
このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalStateOrProvince
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
ConditionalStateOrProvince パラメーターは、受信者の StateOrProvince プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen
このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。
| Type: | MultiValuedProperty |
| 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 |
-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 |
-DisabledEmailAddressTemplates
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
DisabledEmailAddressTemplates パラメーターは、メール アドレス ポリシーに含まれているが、受信者のメール アドレスを構成するために使用されないプロキシ電子メール アドレス テンプレートを指定します。
このパラメーターの有効な構文は です Type:AddressFormat。
- 種類: Exchange Serverのアドレス ポリシーの「アドレスの種類」セクションで説明されている有効な電子メール アドレスの種類Email。 たとえば、smtp や X400 などです。 SMTP を使用して無効なプライマリ SMTP メール アドレスを指定することはできません。
- AddressFormat: SMTP メール アドレスの場合、承認済みドメイン (権限のあるリレーまたは内部リレー) として構成されているドメインまたはサブドメイン、および有効な変数と ASCII テキスト文字については、「Exchange Serverのアドレス ポリシー Email」の「アドレス形式」セクションで説明されています。 たとえば、 alias@contoso.com には 値
%m@contoso.comが必要で、 firstname.lastname@contoso.com には 値%g.%s@contoso.comが必要です。
無効になっている複数のメール アドレス テンプレートは、コンマで区切って指定できます。 "[Type1:]EmailAddress1","[Type2:]EmailAddress2",..."[TypeN:]EmailAddressN"
| Type: | ProxyAddressTemplateCollection |
| 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
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
| 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 |
-EnabledEmailAddressTemplates
ブロックされるファイルの種類を構成するには、FileTypes パラメーターを使用します。
このパラメーターの有効な構文は です Type:AddressFormat。
- 種類: Exchange Serverのアドレス ポリシーの「アドレスの種類」セクションで説明されている有効な電子メール アドレスの種類Email。 たとえば、プライマリ メール アドレスの場合は SMTP、プロキシ アドレスの場合は smtp などです。
- AddressFormat: SMTP メール アドレスの場合、承認済みドメイン (権限のあるリレーまたは内部リレー) として構成されているドメインまたはサブドメイン、および有効な変数と ASCII テキスト文字については、「Exchange Serverのアドレス ポリシー Email」の「アドレス形式」セクションで説明されています。 たとえば、 alias@contoso.com には 値
%m@contoso.comが必要で、 firstname.lastname@contoso.com には 値%g.%s@contoso.comが必要です。
このパラメーターには、(プライマリ SMTP 電子メール アドレスを定義するために) 型の値 SMTP を持つテンプレートが少なくとも 1 つ必要です。 その後、テンプレートの Type プレフィックスを含めない場合は、smtp (SMTP プロキシ アドレス) の値が想定されます。
複数のメール アドレス テンプレートをコンマで区切って指定できます。 "SMTP:PrimarySMTPEmailAddress","[Type1:]EmailAddress1","[Type2:]EmailAddress2",..."[TypeN:]EmailAddressN"
EnabledPrimarySMTPAddressTemplate パラメーターでは、このパラメーターを使用できません。
PowerShell Exchange Onlineでは、電子メール アドレス テンプレートで変数を使用することはできません。
| Type: | ProxyAddressTemplateCollection |
| 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 |
-EnabledPrimarySMTPAddressTemplate
EnabledPrimarySMTPAddressTemplate パラメーターは、受信者のプライマリ SMTP 電子メール アドレスの生成に使用される電子メール アドレス ポリシーのルールを指定します。 ポリシーがプライマリ メール アドレスのみを適用し、追加のプロキシ アドレスを適用しない場合は、EnabledEmailAddressTemplates の代わりにこのパラメーターを使用できます。
このパラメーターの有効な構文は、権限のある承認済みドメインとして構成されているドメインまたはサブドメインであり、Exchange Serverのアドレス ポリシーの「アドレス形式」セクションで説明されているように、有効な変数と ASCII テキスト文字Email。 たとえば、 alias@contoso.com には 値 %m@contoso.comが必要で、 firstname.lastname@contoso.com には 値 %g.%s@contoso.comが必要です。
EnabledEmailAddressTemplates パラメーターでは、このパラメーターを使用できません。
PowerShell Exchange Onlineでは、電子メール アドレス テンプレートで変数を使用することはできません。
| 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 |
-IncludedRecipients
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
IncludedRecipients パラメーターは、受信者の種類に基づいて事前にスキャンされたフィルターを指定します。 有効な値は次のとおりです。
- AllRecipients: この値は、単独でのみ使用可能です。
- MailboxUsers
- MailContacts
- MailGroups
- MailUsers
- リソース: この値は、会議室メールボックスまたは備品用メールボックスを示します。
SPO: exSharePointOnline2ndMen 複数の値を使用すると、OR ブール演算子が適用されます。
既定のフィルターの一部として条件付きパラメーターを使用する場合は、このパラメーターを使用する必要があります。 このパラメーターを RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用) と組み合わせて使用することはできません。
| Type: | WellKnownRecipientType |
| 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 |
-IncludeUnifiedGroupRecipients
このパラメーターは、クラウドベースのサービスでのみ使用できます。
IncludeUnifiedGroupRecipients スイッチは、電子メール アドレス ポリシーがMicrosoft 365 グループにのみ適用されることを指定します。 このスイッチで値を指定する必要はありません。
Exchange Online PowerShell では、Exchange Onlineのメール アドレス ポリシーは 365 グループMicrosoftにのみ適用されるため、このスイッチを常に使用する必要があります。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ManagedByFilter
このパラメーターは、クラウドベースのサービスでのみ使用できます。
ManagedByFilter パラメーターは、Microsoft 365 グループを作成するユーザーのプロパティに基づいて、Microsoft 365 グループに適用する電子メール アドレス ポリシーを指定します。
このパラメーターは、使用可能な受信者プロパティ (など "Department -eq 'Sales'") の値に基づく OPATH フィルターです。 使用可能な任意の Windows PowerShell 演算子を使用できます。また、ワイルドカードおよび部分一致の機能がサポートされています。 検索条件は構文"Property -ComparisonOperator 'Value'"を使用します。
- OPATH フィルター全体を二重引用符 " " で囲みます。 フィルターにシステム値 (例えば、
$true、$false、または$null) が含まれている場合は、代わりに単一引用符 ' ' を使用します。 このパラメーターは文字列 (システム ブロックではありません) ですが、波かっこ { } を使用することもできますが、これはフィルターに変数が含まれていない場合のみです。 - Property はフィルタリング可能なプロパティです。 フィルター可能な受信者プロパティについては、「 RecipientFilter パラメーターのフィルター可能なプロパティ」を参照してください。
- ComparisonOperator は OPATH 比較演算子です (たとえば
-eq、等しい場合や-like文字列比較の場合)。 比較演算子の詳細については、「about_Comparison_Operators」を参照してください。 - Value は、検索するプロパティ値です。 テキスト値と変数を一重引用符 (
'Value'または'$Variable') で囲みます。 変数値に一重引用符が含まれている場合、変数を正しく展開するには、一重引用符を識別する (エスケープする) 必要があります。 たとえば、'$User'の代わりに'$($User -Replace "'","''")'を使用します。 整数またはシステム値を引用符で囲まないでください (代わりに、500、$true、$falseなど$null)。 - ワイルドカードは最初の文字として使用できません。 たとえば、
'Sales*'は使用できますが、'*Sales'は使用できません。
詳細については、「Office 365 グループを作成するときに使うドメインを選ぶ」をご覧ください。
Exchange の OPATH フィルターの詳細については、「 その他の OPATH 構文情報」を参照してください。
このパラメーターは、IncludeUnifiedGroupRecipients スイッチExchange Online PowerShell でのみ使用できます。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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 |
-Priority
Priority パラメーターは、メール アドレス ポリシーが評価される順序を指定します。 既定では、新しいメール アドレス ポリシーを追加するたびに、ポリシーには N +1 の優先順位が割り当てられます。N は作成したメール アドレス ポリシーの数です。
Priority パラメーターは、電子メール アドレス ポリシーが評価される順序を指定します。既定では、新しく電子メール アドレス ポリシーを追加するたびに、ポリシーに N+1 で優先度が付けられます。この場合、N は作成した電子メール アドレス ポリシーの番号です。
注: 受信者を識別する最初のメール アドレス ポリシーは、受信者のメール アドレスを構成します。 最初のポリシーが適用されておらず、受信者のメール アドレスを構成できない場合でも、他のすべてのポリシーは無視されます。
| Type: | EmailAddressPolicyPriority |
| 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 |
-RecipientContainer
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
RecipientContainer パラメーターは、Active Directory 内の受信者の場所に基づくフィルターを指定します。 このパラメーターの有効な入力値は、Get-OrganizationalUnit コマンドレットによって返される組織単位 (OU) またはドメインです。 OU またはドメインを一意に識別する、任意の値を使用できます。 以下に例を示します。
- 名前
- 識別名 (DN)
- 識別名 (DN)
- GUID
このパラメーターを使用しない場合、既定値はオブジェクトが作成された OU になります。
| Type: | OrganizationalUnitIdParameter |
| 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 |
-RecipientFilter
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
RecipientFilter パラメーターは、使用可能な受信者プロパティの値に基づくカスタム OPATH フィルターを指定します。 使用可能な任意の Windows PowerShell 演算子を使用できます。また、ワイルドカードおよび部分一致の機能がサポートされています。 検索条件は構文"Property -ComparisonOperator 'Value'"を使用します。
- OPATH フィルター全体を二重引用符 " " で囲みます。 フィルターにシステム値 (例えば、
$true、$false、または$null) が含まれている場合は、代わりに単一引用符 ' ' を使用します。 このパラメーターは文字列 (システム ブロックではありません) ですが、波かっこ { } を使用することもできますが、これはフィルターに変数が含まれていない場合のみです。 - Property はフィルタリング可能なプロパティです。 フィルター処理可能なプロパティについては、「-RecipientFilter パラメーターのフィルター可能なプロパティ」を参照してください。
- ComparisonOperator は OPATH 比較演算子です (たとえば
-eq、等しい場合や-like文字列比較の場合)。 比較演算子の詳細については、「about_Comparison_Operators」を参照してください。 - Value は、フィルター処理するプロパティ値です。 テキスト値と変数を一重引用符 (
'Value'または'$Variable') で囲みます。 変数値に一重引用符が含まれている場合、変数を正しく展開するには、一重引用符を識別する (エスケープする) 必要があります。 たとえば、'$User'の代わりに'$($User -Replace "'","''")'を使用します。 整数またはシステム値を引用符で囲まないでください (代わりに、500、$true、$falseなど$null)。 - クラウドベース環境では、ワイルドカードを最初の文字として使用できません。 たとえば、
'Sales*'は使用できますが、'*Sales'は使用できません。 - オンプレミスの Exchange では、ワイルドカードは最初または最後の文字としてのみ有効です。 たとえば、
'Sales*'または'*Sales'は使用できますが、'Sa*les'は使用できません。
Exchange の OPATH フィルターの詳細については、「 その他の OPATH 構文情報」を参照してください。
このパラメーターは、IncludedRecipientsパラメーターまたは (既定のフィルターの作成に使用される) 条件付きパラメーターと併用できません。
| 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, Exchange Online |
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。