New-AddressList

このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。

New-AddressList コマンドレットを使用して、アドレス一覧を作成し、受信者に適用します。

Exchange Online で、このコマンドレットはアドレス一覧の役割でのみ使用できます。既定では、この役割は役割グループに割り当てられていません。 このコマンドレットを使用するには、アドレス一覧の役割を役割グループ (たとえば、組織の管理 役割グループ) に追加する必要があります。 詳細については、「役割グループへ役割を追加する」を参照してください。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

New-AddressList
   [-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]
   [-Container <AddressListIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-RecipientContainer <OrganizationalUnitIdParameter>]
   [-WhatIf]
   [<CommonParameters>]
New-AddressList
   [-Name] <String>
   -RecipientFilter <String>
   [-Confirm]
   [-Container <AddressListIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-RecipientContainer <OrganizationalUnitIdParameter>]
   [-WhatIf]
   [<CommonParameters>]

説明

条件付きパラメーターとともに使用される IncludedRecipients パラメーターには、次の制限が適用されます。

  • EQV 演算子は、「部門が営業に等しい」などのように、個々のプロパティ値に対して使用します。 ワイルドカードや部分一致はサポートされていません。
  • OR 演算子は、「部門が営業、またはマーケティングに等しい」などのように、常に同じプロパティの複数の値に対して使用します。
  • AND 演算子は、「部門が営業に等しい、および会社が Contoso に等しい」などのように、常に複数のプロパティに対して使用します。

使用可能な受信者プロパティを使用し、これらの制限の影響を受けない柔軟なフィルターを作成するには、RecipientFilter パラメーターを使用して OPATH フィルターを作成します。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例 1

New-AddressList -Name MyAddressList -RecipientFilter "((RecipientTypeDetails -eq 'UserMailbox') -and ((StateOrProvince -eq 'Washington') -or (StateOrProvince -eq 'Oregon')))"

この例は、MyAddressList というアドレス一覧を作成します。 このアドレス一覧には、メールボックス ユーザーであり、StateOrProvince プロパティが Washington または Oregon に設定されている受信者が含まれています。

例 2

New-AddressList -Name MyAddressList2 -ConditionalStateOrProvince Washington -IncludedRecipients MailboxUsers

この例は、ConditionalStateOrProvince パラメーターが Washington に設定されているメールボックスを含むアドレス一覧を、MyAddressList2 という名前で作成します。

例 3

New-AddressList -Name "AL_AgencyB" -RecipientFilter "((RecipientTypeDetails -eq 'UserMailbox') -and (CustomAttribute15 -like 'AgencyB*'))"

この例では、CustomAttribute15 パラメーターの値に AgencyB が含まれるメールボックスを含むアドレス一覧AL_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

-Container

Container パラメーターは、アドレス一覧の作成先を指定します。 このパラメーターの有効な入力は、ルート "\" (すべてのアドレス一覧とも呼ばれる) の下か、既存のアドレス一覧の下です。 アドレス一覧を一意に識別する任意の値を使用できます。 例:

  • 名前
  • 識別名 (DN)
  • GUID
  • パス: "\AddressListName" または "\ContainerName\AddressListName" (たとえば、 "\All Users" または "\All Contacts\Marketing")

このパラメーターを使用しない場合、アドレス一覧は、ルート (\) の下に作成されます。

Type:AddressListIdParameter
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 パラメーターには、アドレス一覧の表示名を指定します。 この表示名が Exchange 管理センター、および Outlook に表示されます。 最大の長さは 256 文字です。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

DisplayName パラメーターを使用しなかった場合は、Name パラメーターの値が表示名として使用されます。

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

-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

このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。