New-GlobalAddressList
このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。
グローバル アドレス一覧 (GAL) を作成するには、New-GlobalAddressList コマンドレットを使用します。
Exchange Online で、このコマンドレットはアドレス一覧の役割でのみ使用できます。既定では、この役割は役割グループに割り当てられていません。 このコマンドレットを使用するには、アドレス一覧の役割を役割グループ (たとえば、組織の管理 役割グループ) に追加する必要があります。 詳細については、「役割グループへ役割を追加する」を参照してください。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
New-GlobalAddressList
[-Name] <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>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>] New-GlobalAddressList
[-Name] <String>
-RecipientFilter <String>
[-Confirm]
[-DomainController <Fqdn>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>] 説明
条件付きパラメーターとともに使用される IncludedRecipients パラメーターには、次の制限が適用されます。
- EQV 演算子は、「部門が営業に等しい」などのように、個々のプロパティ値に対して使用します。 ワイルドカードや部分一致はサポートされていません。
- OR 演算子は、「部門が営業、またはマーケティングに等しい」などのように、常に同じプロパティの複数の値に対して使用します。
- AND 演算子は、「部門が営業に等しい、および会社が Contoso に等しい」などのように、常に複数のプロパティに対して使用します。
使用可能な受信者プロパティを使用し、これらの制限の影響を受けない柔軟なフィルターを作成するには、RecipientFilter パラメーターを使用して OPATH フィルターを作成します。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
New-GlobalAddressList -Name "NewGAL"この例では、NewGAL という名前の GAL を作成します。
例 2
New-GlobalAddressList -Name GAL_AgencyB -RecipientFilter "(RecipientTypeDetails -eq 'UserMailbox') -and (CustomAttribute15 -eq 'AgencyB')"次の使用例は、RecipientFilter パラメーターを使用して GAL_AgencyB という名前の GAL を作成し、カスタム属性 15 が AgencyB と等しいすべてのメールボックス ユーザーを含めます。
パラメーター
-ConditionalCompany
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, Exchange Online |
-ConditionalCustomAttribute1
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, Exchange Online |
-ConditionalCustomAttribute10
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, Exchange Online |
-ConditionalCustomAttribute11
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, Exchange Online |
-ConditionalCustomAttribute12
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, Exchange Online |
-ConditionalCustomAttribute13
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, Exchange Online |
-ConditionalCustomAttribute14
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, Exchange Online |
-ConditionalCustomAttribute15
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, Exchange Online |
-ConditionalCustomAttribute2
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, Exchange Online |
-ConditionalCustomAttribute3
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, Exchange Online |
-ConditionalCustomAttribute4
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, Exchange Online |
-ConditionalCustomAttribute5
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, Exchange Online |
-ConditionalCustomAttribute6
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, Exchange Online |
-ConditionalCustomAttribute7
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, Exchange Online |
-ConditionalCustomAttribute8
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, Exchange Online |
-ConditionalCustomAttribute9
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, Exchange Online |
-ConditionalDepartment
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, Exchange Online |
-ConditionalStateOrProvince
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, 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 |
-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 |
-IncludedRecipients
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, 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 |
-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
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, 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
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。