New-DynamicDistributionGroup

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 パラメーターは、メール連絡先またはメール ユーザーのプライマリ電子メール アドレスを生成したり更新したりすることはありません。

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

ArbitrationMailbox パラメーターは、この受信者のモデレート処理を管理するために使用される調停メールボックスを指定します。 調停メールボックスを一意に識別する任意の値を使用できます。 次に例を示します。

• 名前
• Alias
• 識別名 (DN)
• 正規 DN
• Domain\Username
• 電子メール アドレス
• GUID
• LegacyExchangeDN
• SamAccountName
• ユーザー ID またはユーザー プリンシパル名 (UPN)

ConditionalCompany パラメーターは、受信者の Company プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen

このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。

このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。

ConditionalCustomAttribute1 パラメーターは、受信者の CustomAttribute1 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen

このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。

このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。

ConditionalCustomAttribute10 パラメーターは、受信者の CustomAttribute10 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen

このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。

このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。

ConditionalCustomAttribute11 パラメーターは、受信者の CustomAttribute11 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen

このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。

このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。

ConditionalCustomAttribute12 パラメーターは、受信者の CustomAttribute12 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen

このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。

このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。

ConditionalCustomAttribute13 パラメーターは、受信者の CustomAttribute13 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen

このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。

このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。

ConditionalCustomAttribute14 パラメーターは、受信者の CustomAttribute14 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen

このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。

このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。

ConditionalCustomAttribute15 パラメーターは、受信者の CustomAttribute15 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen

このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。

このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。

ConditionalCustomAttribute2 パラメーターは、受信者の CustomAttribute2 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen

このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。

このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。

ConditionalCustomAttribute3 パラメーターは、受信者の CustomAttribute3 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen

このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。

このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。

ConditionalCustomAttribute4 パラメーターは、受信者の CustomAttribute4 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen

このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。

このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。

ConditionalCustomAttribute5 パラメーターは、受信者の CustomAttribute5 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen

このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。

このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。

ConditionalCustomAttribute6 パラメーターは、受信者の CustomAttribute6 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen

このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。

このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。

ConditionalCustomAttribute7 パラメーターは、受信者の CustomAttribute7 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen

このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。

このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。

ConditionalCustomAttribute8 パラメーターは、受信者の CustomAttribute8 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen

このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。

このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。

ConditionalCustomAttribute9 パラメーターは、受信者の CustomAttribute9 プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen

このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。

このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。

ConditionalDepartment パラメーターは、受信者の Department プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen

このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。

このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。

ConditionalStateOrProvince パラメーターは、受信者の StateOrProvince プロパティの値に基づいた既定のフィルターを指定します。 SPO: exSharePointOnline2ndMen

このパラメーターに複数の値を使用すると、OR ブール演算子が適用されます。 Conditional パラメーターの作用の詳細については、このトピックの「解説」セクションを参照してください。

このパラメーターは、IncludedRecipients パラメーターを使用して、既定のフィルターの一部として使用します。 RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用される) と組み合わせて条件付きパラメーターを使用することはできません。

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

• 破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
• 他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。

このパラメーターは、クラウドベースのサービスでのみ使用できます。

このパラメーターは、Microsoft の内部使用のために予約されています。

DisplayName パラメーターは、動的配布グループの表示名を指定します。 表示名は、Exchange 管理センターとアドレス一覧に表示されます。 最大の長さは 256 文字です。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

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

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。

IncludedRecipients パラメーターは、受信者の種類に基づいて事前にスキャンされたフィルターを指定します。 有効な値は次のとおりです。

• AllRecipients: この値は、単独でのみ使用可能です。
• MailboxUsers
• MailContacts
• MailGroups
• MailUsers
• リソース: この値は、会議室メールボックスまたは備品用メールボックスを示します。

SPO: exSharePointOnline2ndMen 複数の値を使用すると、OR ブール演算子が適用されます。

既定のフィルターの一部として条件付きパラメーターを使用する場合は、このパラメーターを使用する必要があります。 このパラメーターを RecipientFilter パラメーター (カスタム OPATH フィルターの作成に使用) と組み合わせて使用することはできません。

ModeratedBy パラメーターは、対象受信者のモデレーターを 1 つ以上指定します。 モデレーターは、このメッセージが配信される前に、受信者に送信されるメッセージを承認します。 モデレーターは、メールボックス、メール ユーザー、または組織内のメール連絡先である必要があります。 モデレーターを一意に識別する任意の値を使用できます。 次に例を示します。

• 名前
• Alias
• 識別名 (DN)
• 正規 DN
• 電子メール アドレス
• GUID

Update 値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value1","Value2",..."ValueN"

ModerationEnabled パラメーターを値$trueに設定するときに、このパラメーターを使用して、少なくとも 1 つのモデレーターを指定します。

ModerationEnabled パラメーターは、この受信者に対してモデレートを有効にするかどうかを指定します。 有効な値は次のとおりです。

• $true: 受信者に対してモデレートを有効にします。 この受信者に送信されるメッセージは、そのメッセージが配信される前に、モデレーターによって承認される必要があります。
• $false: 受信者に対してモデレートを無効にします。 この受信者に送信されるメッセージは、モデレーターの承認なしで配信されます。 これは既定の値です。

モデレーターを指定するには、ModeratedBy パラメーターを使用します。

Name パラメーターは、動的配布グループの一意の名前を指定します。 最大の長さは 64 文字です。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

DisplayName パラメーターを使用しなかった場合は、この値が DisplayName プロパティとして使用されます。

OrganizationalUnit パラメーターは、動的配布グループを作成する組織単位 (OU) を指定します。

このパラメーターの有効な入力値は、Get-OrganizationalUnit コマンドレットによって返される組織単位 (OU) またはドメインです。 OU またはドメインを一意に識別する、任意の値を使用できます。 以下に例を示します。

• 名前
• 識別名 (DN)
• 識別名 (DN)
• GUID

このパラメーターを使用しない場合、既定値は通常、接続先の Exchange サーバーのドメイン (受信者スコープとも呼ばれます) 内の Users コンテナーです。 オンプレミスの Exchange では、Set-AdServerSettings コマンドレットを使用して、現在の PowerShell セッションの受信者スコープを変更できます。

RecipientContainer パラメーターを使用しない場合は、動的配布グループの場所が RecipientContainer プロパティ (既定の場所、または OrganizationUnit パラメーターに指定した値) に使用されます。

注: このパラメーターはExchange Onlineで使用できますが、Exchange Online組織には使用可能な OU が 1 つしかないため、このパラメーターを使用しても効果はありません。

PrimarySmtpAddress パラメーターは、受信者の返信用プライマリ メール アドレスを指定します。

RecipientContainer パラメーターは、Active Directory 内の受信者の場所に基づくフィルターを指定します。 このパラメーターの有効な入力値は、Get-OrganizationalUnit コマンドレットによって返される組織単位 (OU) またはドメインです。 OU またはドメインを一意に識別する、任意の値を使用できます。 以下に例を示します。

• 名前
• 識別名 (DN)
• 識別名 (DN)
• GUID

このパラメーターを使用しない場合、既定値はオブジェクトが作成された OU になります。

なお、RecipientContainer プロパティを空白にすることはできません。 グループの検索は、常に特定の場所 (このパラメーターに指定した値、またはグループが作成された場所) の受信者に限定されます。

注: このパラメーターはExchange Onlineで使用できますが、Exchange Online組織には使用可能な OU が 1 つしかないため、このパラメーターを使用しても効果はありません。

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 文字です。

SendModerationNotifications パラメーターは、モデレート通知メッセージを送信するタイミングを指定します。有効な値は次のとおりです。 有効な値は次のとおりです。

• Always: メッセージが承認されない場合、すべての送信者に通知する。 これは既定の値です。
• Internal: メッセージが承認されない場合、組織内の送信者に通知する。
• Never: メッセージが承認されない場合、だれにも通知しない。

このパラメーターは、モデレートが有効な場合にのみ、意味があります (ModerationEnabled パラメーターに値 $true が指定されている)。

WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。