Get-AzADGroup

モジュール:

Az.Resources

グループのエンティティを一覧表示するか、キーでグループからエンティティを取得します

構文

Get-AzADGroup
   [-Count]
   [-Expand <String[]>]
   [-Select <String[]>]
   [-Filter <String>]
   [-Orderby <String[]>]
   [-Search <String>]
   [-ConsistencyLevel <String>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [-CountVariable <String>]
   [<CommonParameters>]

Get-AzADGroup
   [-Expand <String[]>]
   [-Select <String[]>]
   [-ConsistencyLevel <String>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   -DisplayName <String>
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzADGroup
   [-Expand <String[]>]
   [-Select <String[]>]
   [-ConsistencyLevel <String>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   -DisplayNameStartsWith <String>
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzADGroup
   [-Expand <String[]>]
   [-Select <String[]>]
   [-ConsistencyLevel <String>]
   [-AppendSelected]
   -ObjectId <Guid>
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

説明

グループのエンティティを一覧表示するか、キーでグループからエンティティを取得します

例

例 1: 表示名でグループを取得する

Get-AzADGroup -DisplayName $gname

表示名でグループを取得する

例 2: グループを一覧表示する

Get-AzADGroup -First 10

最初の 10 グループを一覧表示する

例 3: オブジェクト ID でグループ化を取得する

Get-AzADGroup -ObjectId $id -Select groupTypes -AppendSelected

既定のプロパティ 'DisplayName'、'Id'、'DeletedDateTime'、'SecurityEnabled'、'MailEnabled'、'MailNickname'、'Description' の後に、オブジェクト ID と追加プロパティ 'groupTypes' でグループ化を取得します。

例 4: フィルターを使用してグループを取得する

Get-AzADGroup -Filter "startsWith(DisplayName,'some-name')"

フィルターを使用してグループを取得する

例 5: 変数に OdataCount を割り当てる

Get-AzADGroup -First 10 -ConsistencyLevel eventual -Count -CountVariable 'result'
$result

OdataCount を変数に割り当てる

パラメーター

-AppendSelected

このスイッチがオンのときに既定のプロパティで選択された追加プロパティは、パラメーター '-Select' でのみ機能します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ConsistencyLevel

要求された整合性レベルを示します。 ドキュメント URL: https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Count

項目数を含める

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CountVariable

コレクション内の項目の合計数のカウントを指定します。 既定では、この変数はグローバル スコープで設定されます。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

型:	PSObject
Aliases:	AzContext, AzureRmContext, AzureCredential
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisplayName

グループの表示名。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisplayNameStartsWith

指定された文字列で始まるグループを検索するために使用されます。

型:	String
Aliases:	SearchString
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Expand

関連エンティティを展開する

型:	String[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Filter

プロパティ値で項目をフィルター処理します。フィルター クエリの詳細については、次を参照してください。 https://learn.microsoft.com/en-us/graph/filter-query-parameter

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-First

最初の 'n' オブジェクトのみを取得します。

型:	UInt64
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ObjectId

キー: グループの ID

型:	Guid
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Orderby

プロパティ値によるアイテムの並べ替え

型:	String[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Search

検索語句でアイテムを検索する

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Select

返されるプロパティを選択する

型:	String[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Skip

最初の 'n' オブジェクトを無視し、残りのオブジェクトを取得します。

型:	UInt64
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

出力

IMicrosoftGraphGroup

メモ

別名