New-DynamicDistributionGroup
このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。
New-DynamicDistributionGroup コマンドレットは、動的配布グループを作成するために使用します。 動的配布グループは、メールが有効なオブジェクトについて照会し、その結果に基づいてグループのメンバーシップを構築します。 グループ メンバーシップは、グループに電子メール メッセージが送信されるたびに再計算されます。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
New-DynamicDistributionGroup
[-Name] <String>
-IncludedRecipients <WellKnownRecipientType>
[-Alias <String>]
[-ArbitrationMailbox <MailboxIdParameter>]
[-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]
[-DirectMembershipOnly <Boolean>]
[-DisplayName <String>]
[-DomainController <Fqdn>]
[-ModeratedBy <MultiValuedProperty>]
[-ModerationEnabled <Boolean>]
[-OrganizationalUnit <OrganizationalUnitIdParameter>]
[-PrimarySmtpAddress <SmtpAddress>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-SendModerationNotifications <TransportModerationNotificationFlags>]
[-WhatIf]
[<CommonParameters>] New-DynamicDistributionGroup
[-Name] <String>
-RecipientFilter <String>
[-Alias <String>]
[-ArbitrationMailbox <MailboxIdParameter>]
[-Confirm]
[-DirectMembershipOnly <Boolean>]
[-DisplayName <String>]
[-DomainController <Fqdn>]
[-ModeratedBy <MultiValuedProperty>]
[-ModerationEnabled <Boolean>]
[-OrganizationalUnit <OrganizationalUnitIdParameter>]
[-PrimarySmtpAddress <SmtpAddress>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-SendModerationNotifications <TransportModerationNotificationFlags>]
[-WhatIf]
[<CommonParameters>] 説明
条件付きパラメーターとともに使用される IncludedRecipients パラメーターには、次の制限が適用されます。
- EQV 演算子は、「部門が営業に等しい」などのように、個々のプロパティ値に対して使用します。 ワイルドカードや部分一致はサポートされていません。
- OR 演算子は、「部門が営業、またはマーケティングに等しい」などのように、常に同じプロパティの複数の値に対して使用します。
- AND 演算子は、「部門が営業に等しい、および会社が Contoso に等しい」などのように、常に複数のプロパティに対して使用します。
使用可能な受信者プロパティを使用し、これらの制限の影響を受けない柔軟なフィルターを作成するには、RecipientFilter パラメーターを使用してカスタム OPATH フィルターを作成します。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
New-DynamicDistributionGroup -Name "Marketing Group" -IncludedRecipients "MailboxUsers,MailContacts" -ConditionalDepartment "Marketing","Sales"この例では、[部署] フィールドが文字列の "Marketing" または "Sales" と一致するすべての受信者を含む Marketing Group という名前の動的配布グループを作成します。 OrganizationalUnit パラメーター、または RecipientContainer パラメーターを使用しなかったため、グループは既定の場所 (通常はユーザー コンテナー) の受信者を検索します。
例 2
New-DynamicDistributionGroup -Name "Washington Management Team" -RecipientFilter "(RecipientType -eq 'UserMailbox') -and (Title -like 'Director*' -or Title -like 'Manager*') -and (StateOrProvince -eq 'WA')" -RecipientContainer "North America"この例では、タイトルが "Director" または "Manager" で始まるワシントン州の北米という名前の組織単位内のすべてのユーザーを含む、Washington Management Team という名前の動的配布グループを作成します。
パラメーター
-Alias
Alias パラメーターは、受信者の Exchange エイリアス (メール ニックネームとも呼ばれる) を指定します。 この値は、受信者を、メールが有効なオブジェクトとして識別します。同じ受信者の複数の電子メール アドレス (プロキシ アドレスとも呼ばれる) と混同しないようにしてください。 受信者は Alias 値を 1 つだけ持つことができます。 最大の長さは 64 文字です。
Alias 値には、文字、数字、および次の文字を含めることができます。
- !、#、%、*、+、-、/、=、?、^、_、~。
- $、 &、'、'、{、}、|は、エスケープする必要があります (たとえば
-Alias what`'snew) か、単一引用符で囲まれた値全体 (例:-Alias 'what'snew')。 この & 文字は、Azure AD Connect 同期の Alias 値ではサポートされていません。 - ピリオド (.) は、他の有効な文字 (例:
help.desk) で囲む必要があります。 - Unicode 文字 U+00A1 から U+00FF。
メール アドレスを指定せずに受信者を作成すると、指定した Alias 値を使用してプライマリ メール アドレス (alias@domain) が生成されます。 サポートされている Unicode 文字は、最も適した US-ASCII テキスト文字にマッピングされます。 たとえば、U+00F6 (ö) はプライマリ メール アドレスで に oe 変更されます。
受信者の作成時に Alias パラメーターを使用しない場合、次のように別の必須パラメーターの値が Alias プロパティの値として使用されます。
- ユーザー アカウントのある受信者 (たとえば、ユーザー メールボックスやメール ユーザー): MicrosoftOnlineServicesID または UserPrincipalName パラメーターの左側が使用されます。 たとえば、 helpdesk@contoso.onmicrosoft.com Alias プロパティ値
helpdeskになります。 - ユーザー アカウントのない受信者 (たとえば、会議室メールボックス、メール連絡先、配布グループ): Name パラメーターの値が使用されます。 スペースは削除されます。サポートされていない文字は疑問符 (?) に変換されます。
既存の受信者の Alias の値を変更した場合、プライマリ電子メール アドレスは、受信者が電子メール アドレス ポリシーに従う必要がある (受信者に対して EmailAddressPolicyEnabled プロパティが True になっている) 環境でのみ自動的に更新されます。
Alias パラメーターは、メール連絡先またはメール ユーザーのプライマリ電子メール アドレスを生成したり更新したりすることはありません。
| 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 |
-ArbitrationMailbox
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
ArbitrationMailbox パラメーターは、この受信者のモデレート処理を管理するために使用される調停メールボックスを指定します。 調停メールボックスを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- Alias
- 識別名 (DN)
- 正規 DN
- Domain\Username
- 電子メール アドレス
- GUID
- LegacyExchangeDN
- SamAccountName
- ユーザー ID またはユーザー プリンシパル名 (UPN)
| Type: | MailboxIdParameter |
| 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 |
-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, Exchange Online Protection |
-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, Exchange Online Protection |
-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, Exchange Online Protection |
-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, Exchange Online Protection |
-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, Exchange Online Protection |
-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, Exchange Online Protection |
-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, Exchange Online Protection |
-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, Exchange Online Protection |
-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, Exchange Online Protection |
-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, Exchange Online Protection |
-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, Exchange Online Protection |
-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, Exchange Online Protection |
-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, Exchange Online Protection |
-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, Exchange Online Protection |
-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, Exchange Online Protection |
-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, Exchange Online Protection |
-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, Exchange Online Protection |
-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, Exchange Online Protection |
-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 |
-DirectMembershipOnly
このパラメーターは、クラウドベースのサービスでのみ使用できます。
このパラメーターは、Microsoft の内部使用のために予約されています。
| Type: | Boolean |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-DisplayName
DisplayName パラメーターは、動的配布グループの表示名を指定します。 表示名は、Exchange 管理センターとアドレス一覧に表示されます。 最大の長さは 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, Exchange Online Protection |
-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, Exchange Online Protection |
-ModeratedBy
ModeratedBy パラメーターは、対象受信者のモデレーターを 1 つ以上指定します。 モデレーターは、このメッセージが配信される前に、受信者に送信されるメッセージを承認します。 モデレーターは、メールボックス、メール ユーザー、または組織内のメール連絡先である必要があります。 モデレーターを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- Alias
- 識別名 (DN)
- 正規 DN
- 電子メール アドレス
- GUID
Update 値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value1","Value2",..."ValueN"
ModerationEnabled パラメーターを値$trueに設定するときに、このパラメーターを使用して、少なくとも 1 つのモデレーターを指定します。
| 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, Exchange Online Protection |
-ModerationEnabled
ModerationEnabled パラメーターは、この受信者に対してモデレートを有効にするかどうかを指定します。 有効な値は次のとおりです。
- $true: 受信者に対してモデレートを有効にします。 この受信者に送信されるメッセージは、そのメッセージが配信される前に、モデレーターによって承認される必要があります。
- $false: 受信者に対してモデレートを無効にします。 この受信者に送信されるメッセージは、モデレーターの承認なしで配信されます。 これは既定の値です。
モデレーターを指定するには、ModeratedBy パラメーターを使用します。
| Type: | Boolean |
| 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 |
-Name
Name パラメーターは、動的配布グループの一意の名前を指定します。 最大の長さは 64 文字です。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
DisplayName パラメーターを使用しなかった場合は、この値が DisplayName プロパティとして使用されます。
| 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, Exchange Online Protection |
-OrganizationalUnit
OrganizationalUnit パラメーターは、動的配布グループを作成する組織単位 (OU) を指定します。
このパラメーターの有効な入力値は、Get-OrganizationalUnit コマンドレットによって返される組織単位 (OU) またはドメインです。 OU またはドメインを一意に識別する、任意の値を使用できます。 以下に例を示します。
- 名前
- 識別名 (DN)
- 識別名 (DN)
- GUID
このパラメーターを使用しない場合、既定値は通常、接続先の Exchange サーバーのドメイン (受信者スコープとも呼ばれます) 内の Users コンテナーです。 オンプレミスの Exchange では、Set-AdServerSettings コマンドレットを使用して、現在の PowerShell セッションの受信者スコープを変更できます。
RecipientContainer パラメーターを使用しない場合は、動的配布グループの場所が RecipientContainer プロパティ (既定の場所、または OrganizationUnit パラメーターに指定した値) に使用されます。
注: このパラメーターはExchange Onlineで使用できますが、Exchange Online組織には使用可能な OU が 1 つしかないため、このパラメーターを使用しても効果はありません。
| 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, Exchange Online, Exchange Online Protection |
-PrimarySmtpAddress
PrimarySmtpAddress パラメーターは、受信者の返信用プライマリ メール アドレスを指定します。
| Type: | SmtpAddress |
| 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
RecipientContainer パラメーターは、Active Directory 内の受信者の場所に基づくフィルターを指定します。 このパラメーターの有効な入力値は、Get-OrganizationalUnit コマンドレットによって返される組織単位 (OU) またはドメインです。 OU またはドメインを一意に識別する、任意の値を使用できます。 以下に例を示します。
- 名前
- 識別名 (DN)
- 識別名 (DN)
- GUID
このパラメーターを使用しない場合、既定値はオブジェクトが作成された OU になります。
なお、RecipientContainer プロパティを空白にすることはできません。 グループの検索は、常に特定の場所 (このパラメーターに指定した値、またはグループが作成された場所) の受信者に限定されます。
注: このパラメーターはExchange Onlineで使用できますが、Exchange Online組織には使用可能な OU が 1 つしかないため、このパラメーターを使用しても効果はありません。
| 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, Exchange Online, Exchange Online Protection |
-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パラメーターまたは (既定のフィルターの作成に使用される) 条件付きパラメーターと併用できません。
RecipientFilter プロパティの最大長は、内部構文を含めて 2048 文字です。
| 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, Exchange Online Protection |
-SendModerationNotifications
SendModerationNotifications パラメーターは、モデレート通知メッセージを送信するタイミングを指定します。有効な値は次のとおりです。 有効な値は次のとおりです。
- Always: メッセージが承認されない場合、すべての送信者に通知する。 これは既定の値です。
- Internal: メッセージが承認されない場合、組織内の送信者に通知する。
- Never: メッセージが承認されない場合、だれにも通知しない。
このパラメーターは、モデレートが有効な場合にのみ、意味があります (ModerationEnabled パラメーターに値 $true が指定されている)。
| Type: | TransportModerationNotificationFlags |
| 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 |
-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
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。