Set-EmailAddressPolicy
このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。
電子メール アドレス ポリシーを変更するには、Set-EmailAddressPolicy コマンドレットを使用します。 Exchange Onlineでは、メール アドレス ポリシーはMicrosoft 365 グループでのみ使用できます。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Set-EmailAddressPolicy
[-Identity] <EmailAddressPolicyIdParameter>
[-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>]
[-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
[-EnabledPrimarySMTPAddressTemplate <String>]
[-ForceUpgrade]
[-IncludedRecipients <WellKnownRecipientType>]
[-Name <String>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-RecipientFilter <String>]
[-WhatIf]
[<CommonParameters>]
説明
Set-EmailAddressPolicy コマンドレットを使用してオンプレミスの Exchange 組織のメール アドレス ポリシーを変更した後、Update-EmailAddressPolicy コマンドレットを使用して、更新されたポリシーを受信者に適用する必要があります。
条件付きパラメーターとともに使用される IncludedRecipients パラメーターには、次の制限が適用されます。
- EQV 演算子は、「部門が営業に等しい」などのように、個々のプロパティ値に対して使用します。 ワイルドカードや部分一致はサポートされていません。
- OR 演算子は、「部門が営業、またはマーケティングに等しい」などのように、常に同じプロパティの複数の値に対して使用します。
- AND 演算子は、「部門が営業に等しい、および会社が Contoso に等しい」などのように、常に複数のプロパティに対して使用します。
使用可能な受信者プロパティを使用し、これらの制限の影響を受けない柔軟なフィルターを作成するには、RecipientFilter パラメーターを使用してカスタム OPATH フィルターを作成します。
このコマンドレットを使用して、事前設定されたフィルターをカスタム OPATH フィルターに置き換えることはできません。またはその逆も可能です。 既存のフィルターのみを変更できます。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Set-EmailAddressPolicy -Identity "Southeast Executives" -ConditionalStateOrProvince @{Add="TX"}
オンプレミスの Exchange では、この例では、State または province value TX (テキサス) を事前に設定された受信者フィルターに追加することで、Southeast Executives という名前の既存のメール アドレス ポリシーを変更します。
例 2
Set-EmailAddressPolicy -Identity "Contoso Corp" -DisabledEmailAddressTemplates $null
オンプレミスの Exchange では、この例では、Contoso Corp という名前のメール アドレス ポリシーから無効になっているメール アドレス テンプレートをクリアします。
例 3
Set-EmailAddressPolicy -Identity "Office 365 Groups" -EnabledEmailAddressTemplates "SMTP:@contoso.com","smtp:@contoso.onmicrosoft.com","smtp:@contoso.microsoftonline.com"
Exchange Onlineでは、この例では、"Office 365 グループ" という名前の既存の電子メール アドレス ポリシーを変更し、有効な電子メール アドレス テンプレートで "@contoso.com" をプライマリ SMTP アドレスとして使用し、"@contoso.onmicrosoft.com" と "@contoso.microsoftonline.com" をプロキシ アドレスとして使用するように設定します。
パラメーター
-ConditionalCompany
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
ConditionalCompany パラメーターは、受信者の Company プロパティの値に基づいた既定のフィルターを指定します。
このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
既存のエントリを上書きする複数の値を入力するには、次の構文を使用します。 Value1,Value2,...ValueN
値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value","Value2",..."ValueN"
既存のエントリに影響を与えずに 1 つ以上の値を追加または削除するには、次の構文を使用します。 @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
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 パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
既存のエントリを上書きする複数の値を入力するには、次の構文を使用します。 Value1,Value2,...ValueN
値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value","Value2",..."ValueN"
既存のエントリに影響を与えずに 1 つ以上の値を追加または削除するには、次の構文を使用します。 @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
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 パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
既存のエントリを上書きする複数の値を入力するには、次の構文を使用します。 Value1,Value2,...ValueN
値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value","Value2",..."ValueN"
既存のエントリに影響を与えずに 1 つ以上の値を追加または削除するには、次の構文を使用します。 @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
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 パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
既存のエントリを上書きする複数の値を入力するには、次の構文を使用します。 Value1,Value2,...ValueN
値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value","Value2",..."ValueN"
既存のエントリに影響を与えずに 1 つ以上の値を追加または削除するには、次の構文を使用します。 @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
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 パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
既存のエントリを上書きする複数の値を入力するには、次の構文を使用します。 Value1,Value2,...ValueN
値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value","Value2",..."ValueN"
既存のエントリに影響を与えずに 1 つ以上の値を追加または削除するには、次の構文を使用します。 @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
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 パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
既存のエントリを上書きする複数の値を入力するには、次の構文を使用します。 Value1,Value2,...ValueN
値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value","Value2",..."ValueN"
既存のエントリに影響を与えずに 1 つ以上の値を追加または削除するには、次の構文を使用します。 @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
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 パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
既存のエントリを上書きする複数の値を入力するには、次の構文を使用します。 Value1,Value2,...ValueN
値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value","Value2",..."ValueN"
既存のエントリに影響を与えずに 1 つ以上の値を追加または削除するには、次の構文を使用します。 @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
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 パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
既存のエントリを上書きする複数の値を入力するには、次の構文を使用します。 Value1,Value2,...ValueN
値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value","Value2",..."ValueN"
既存のエントリに影響を与えずに 1 つ以上の値を追加または削除するには、次の構文を使用します。 @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
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 パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
既存のエントリを上書きする複数の値を入力するには、次の構文を使用します。 Value1,Value2,...ValueN
値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value","Value2",..."ValueN"
既存のエントリに影響を与えずに 1 つ以上の値を追加または削除するには、次の構文を使用します。 @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
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 パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
既存のエントリを上書きする複数の値を入力するには、次の構文を使用します。 Value1,Value2,...ValueN
値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value","Value2",..."ValueN"
既存のエントリに影響を与えずに 1 つ以上の値を追加または削除するには、次の構文を使用します。 @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
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 パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
既存のエントリを上書きする複数の値を入力するには、次の構文を使用します。 Value1,Value2,...ValueN
値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value","Value2",..."ValueN"
既存のエントリに影響を与えずに 1 つ以上の値を追加または削除するには、次の構文を使用します。 @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
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 パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
既存のエントリを上書きする複数の値を入力するには、次の構文を使用します。 Value1,Value2,...ValueN
値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value","Value2",..."ValueN"
既存のエントリに影響を与えずに 1 つ以上の値を追加または削除するには、次の構文を使用します。 @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
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 パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
既存のエントリを上書きする複数の値を入力するには、次の構文を使用します。 Value1,Value2,...ValueN
値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value","Value2",..."ValueN"
既存のエントリに影響を与えずに 1 つ以上の値を追加または削除するには、次の構文を使用します。 @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
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 パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
既存のエントリを上書きする複数の値を入力するには、次の構文を使用します。 Value1,Value2,...ValueN
値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value","Value2",..."ValueN"
既存のエントリに影響を与えずに 1 つ以上の値を追加または削除するには、次の構文を使用します。 @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
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 パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
既存のエントリを上書きする複数の値を入力するには、次の構文を使用します。 Value1,Value2,...ValueN
値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value","Value2",..."ValueN"
既存のエントリに影響を与えずに 1 つ以上の値を追加または削除するには、次の構文を使用します。 @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
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 パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
既存のエントリを上書きする複数の値を入力するには、次の構文を使用します。 Value1,Value2,...ValueN
値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value","Value2",..."ValueN"
既存のエントリに影響を与えずに 1 つ以上の値を追加または削除するには、次の構文を使用します。 @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
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 パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
既存のエントリを上書きする複数の値を入力するには、次の構文を使用します。 Value1,Value2,...ValueN
値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value","Value2",..."ValueN"
既存のエントリに影響を与えずに 1 つ以上の値を追加または削除するには、次の構文を使用します。 @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
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 パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。
既存のエントリを上書きする複数の値を入力するには、次の構文を使用します。 Value1,Value2,...ValueN
値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value","Value2",..."ValueN"
既存のエントリに影響を与えずに 1 つ以上の値を追加または削除するには、次の構文を使用します。 @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
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, Exchange Online Protection |
-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"
通常、このプロパティには、以前のバージョンの Exchange からの移行後の値のみが設定されます。 これらの値をクリアするには、このパラメーターの$null値を使用します。
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では、IncludeUnifiedGroupRecipients でこのパラメーターを使用する場合、電子メール アドレス テンプレートで変数を使用することはできません。
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, Exchange Online, Exchange Online Protection |
-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では、IncludeUnifiedGroupRecipients でこのパラメーターを使用する場合、電子メール アドレス テンプレートで変数を使用することはできません。
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, Exchange Online Protection |
-ForceUpgrade
ForceUpgrade スイッチは、オブジェクトが以前のバージョンの Exchange で作成された場合に表示される確認メッセージを抑制します。 このスイッチで値を指定する必要はありません。
Type: | SwitchParameter |
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, Exchange Online Protection |
-Identity
Identity パラメーターは、変更するメール アドレス ポリシーを指定します。 ポリシーを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- 識別名 (DN)
- GUID
Type: | EmailAddressPolicyIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-IncludedRecipients
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
IncludedRecipients パラメーターは、受信者の種類に基づいて事前にスキャンされたフィルターを指定します。 有効な値は次のとおりです。
- AllRecipients: この値は、単独でのみ使用可能です。
- MailboxUsers
- MailContacts
- MailGroups
- MailUsers
- リソース: この値は、会議室メールボックスまたは備品用メールボックスを示します。
SPO: exSharePointOnline2ndMen 複数の値を使用すると、OR ブール演算子が適用されます。
Type: | WellKnownRecipientType |
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 |
-Name
Name パラメーターは、メール アドレス ポリシーの一意の名前を指定します。 最大の長さは 64 文字です。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
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, Exchange Online Protection |
-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, Exchange Online Protection |
-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'
は使用できますが、'Sa*les'
は使用できません。
Exchange の OPATH フィルターの詳細については、「 その他の OPATH 構文情報」を参照してください。
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 |
-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, Exchange Online Protection |
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。