Get-DynamicDistributionGroupMember
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
動的配布グループ オブジェクトに格納されている計算されたメンバーシップ リストを表示するには、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 |