Get-DynamicDistributionGroupMember

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Exchange Online, Exchange Online Protection

このコマンドレットは、クラウドベースのサービスでのみ使用できます。

動的配布グループオブジェクトに格納されている計算されたメンバーシップリストを表示するには、Get-DynamicDistributionGroupMember コマンドレットを使用します。このコマンドレットの結果は、24 時間ごとに更新されます。

配布グループとメールが有効なセキュリティグループのメンバーを表示するには、Get-DistributionGroupMember コマンドレットを使用します。

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

構文

Get-DynamicDistributionGroupMember
   [-Identity] <DynamicDistributionGroupMemberIdParameter>
   [-Credential <PSCredential>]
   [-IncludeSoftDeletedObjects]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

説明

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

例

例 1

Get-DynamicDistributionGroupMember -Identity "Temporary Employees"

次の使用例は、一時従業員という名前の動的配布グループの既存のメンバーを返します。

パラメーター

-Credential

Credential パラメーターは、このコマンドの実行に使用されるユーザー名とパスワードを指定します。通常、このパラメーターはスクリプトや、必要なアクセス許可を持つ別の資格情報を入力する必要がある場合に使用します。

このパラメーターの値には、Get-Credential コマンドレットが必要です。このコマンドを一時停止し、資格情報の入力を求めるメッセージを表示するには、値(Get-Credential)を使用します。または、このコマンドを実行する前に、資格情報を変数 (たとえば、$cred = Get-Credential) に保存し、このパラメーターに変数名 ($cred) を使用します。詳細については、Get-Credentialに関するページをご覧ください。

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Identity

Identity パラメーターは、動的配布グループを指定します。グループを一意に識別する任意の値を使用できます。例:

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

Type:	DynamicDistributionGroupMemberIdParameter
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-IncludeSoftDeletedObjects

IncludeSoftDeletedGroups スイッチは、論理的に削除されたグループメンバーを結果に含めるかどうかを指定します。このスイッチで値を指定する必要はありません。

論理的に削除されたグループメンバーは、回復可能なMicrosoft 365 グループまたはメールボックスに削除されます。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-ResultSize

ResultSize パラメーターは、返される結果の最大数を指定します。クエリに一致するすべてのリクエストを返す場合は、このパラメーターの値に unlimited を使用します。既定値は 1,000 です。

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection